Optional parameters

Some optional parameters can be used with both inbound and outbound runs, while other optional parameters can be used for only inbound or only outbound runs.


Inbound/outbound optional parameters

Table 6-3: Inbound/outbound optional parameters

Parameter

Description

-af <full-path map filename> <full-path new filename>

Uses the named “new filename” in place of the named “map filename” imbedded in the map.

-c

Closes the trace file after every write statement. (This is used to ensure that the last trace message is written to disk. This flag impedes processing and should not be used unless a serious problem is encountered and must be debugged.)

-du <directory>

Uses the named directory in place of the application directories embedded in the map.

-ec

Does not create the transaction log file (translog.in, translog.out, or trlog) or the status file (status.in or status.out).

-ed <directory>

Writes the transaction log file (translog.in or translog.out), status file (status.in or status.out), or trace file (incoming.err, outgoing.err, or trnn.dat), to the named directory. (Required for Tandem and Stratus; optional for all other versions.)

-ef

Does not create the status file (status.in or status.out).

-el

Uses the named full path file name as the transaction log file name. (Required for Tandem and Stratus; optional for all other versions.)

-el <full-path filename>

Uses the named directory for the trace file (incoming.err or outgoing.err). If this switch is not used, the trace file is placed in the map directory.

-et <directory>

Replaces all except the first character in the application file name in the map (excluding the file extension) with the named string variable. This switch is required when multiple copies of the executable are run simultaneously.

-eu <string variable> (up to 7 characters)

Replaces all except the first character in the application file name in the map (excluding the file extension) with the named string variable. This switch is required when multiple copies of the executable are run simultaneously.

-ev <string variable> (up to 8 characters)

Places the named string variable in front of all application file names in the map.

-id <run ID number>

Uses the specified run ID number instead of looking it up. (Normally, the program looks up the next run ID number in the Run ID table in the log database.) The run ID number can have from one to eight digits.

-it

Ignores the trading partner mailbox. If this switch is not set for inbound maps, a copy of the inbound EDI file is placed in the trading partner IN mailbox and no rules are processed unless the trade agreement records have the EDI_OUT flag set. If this switch is not set for outbound maps, the outbound EDI file is placed in the trading partner OUT mailbox. (If a trade agreement mailbox exists and this switch is not set, the trade agreement mailbox will override the trading partner mailbox.)

-l

Turns the long trace on, causing trace messages to be written to an error file. (This switch is used for debugging.)

-mm <full-path filename>

Uses a temporary memory location in place of the named file imbedded in the map.

-mn

Passes the map name extension as part of a command line argument. The Map Name Extension works with other map lookup fields to find a correct map.

For map functions with multiple parameters, such as LOADMAP, the correct map name should be found by using current map lookup fields with the newly added Map Name Extension before calling the functions.

-mp <full-path filename> <pointer to memory address> <pointer to # of bytes> <pointer to size of memory buffer>

Uses a specified memory location in place of a specified file during map execution.

-mx <number>

Keeps a specified number of maps open in memory.

-n

Uses the ALL TradePartner if no trading partner match is found in the trading partner file.

-nret

Adds new return codes that provide more information to the calling program. Based on the return value, the user can determine the next step in the process. The return codes reflect the following information:

  • At least one interchange or group is in error implying a TA1 map should be run.

  • At least one group or transaction is in error, implying a 997 map should be run.

  • At least one good transaction is present, implying a translation map should be run.

-nz

Maps numeric data literally (including blank fields) as it appears on the map. Previous versions of ECRTP pad numeric values with leading zeros based on field length.

-o

Ignores the trade agreement mailbox file name that was set up for routing EDI data.

-pf

Uses the map switches in the named batch file on the command line.

-r

Specifies the maximum number of cross reference table entries that will be loaded into memory. Anything over the maximum must be accessed from the database.

-rb

Ignores the trade agreement mailbox and places the EDI data in the trading partner BAD mailbox on inbound maps and on outbound maps with “Route Bad” selected.

-rg

Ignores the trade agreement mailbox and places the EDI data in the trading partner GOOD mailbox on inbound maps and on outbound maps with “Route Good” selected.

-ri

Ignores the trade agreement mailbox and places the EDI data in the trading partner IN mailbox on inbound maps and on outbound maps with “Route In” selected.

-ro

Ignores the trade agreement mailbox and places the EDI output in the trading partner OUT mailbox on outbound maps and on inbound maps with “Route Out” selected.

-rt

Ignores the trade agreement mailbox and places the EDI data in the trading partner OTHER mailbox on inbound maps and on outbound maps with “Route Other” selected.

-s

Does not produce a trace file.

-sdb

Specifies the maximum number of cached ODBC connections. The default value '0' indicates no ODBC connection caching.

-tm

Writes the elapsed time of execution for the entire run of this command line to the trace file (incoming.err file for inbound maps or outgoing.err file for outbound maps).

-xf

Closes all open maps.

-xf <mapname>

Closes the specified map.

-xl

Writes the text transaction log file in the expanded field-length format. (See Section 10 for the format of the non-ODBC expanded text transaction log file.)

-xmp <pointer to memory address> <pointer to # of bytes> <pointer to size of memory buffer>

Indicates that a specified memory location should be used in place of the EDI file during map execution.

-z

Zero-fills numeric fields that contain data. (For inbound maps, numeric fields are zero-filled if the EDI element contains data, and left blank if there is no data. For outbound maps, a zero is produced if a zero is contained in the data field.)


Inbound/outbound optional parameters for ODBC database users

Table 6-4: Inbound/outbound optional parameters for ODBC database users

Parameter

Description

-ad <“map DSN connect string”> <“new DSN connect string”>

Specifies the named “new DSN connect string” to be used in place of the named “map DSN connect string” in the map file. (Connect strings include the data source name and any other required connection information, such as uid and pwd.)

-et <directory>

Uses the named directory for the trace file (trnn.dat where nn is a non-zero run ID number). If this switch is not used, the trace file is placed in the current directory. The run ID number can have from one to eight digits.

-sdb <number>

Specifies the maximum number of cached ODBC connections. The default value '0' indicates no ODBC connection caching.

-td <directory>

Specifies the named directory to be used with the Backout and Checkpoint commands to make sure that information is correctly backed out. (The -td switch has two other uses; one only for inbound and one only for outbound.)

-wx <number>

Uses the record in the wixset company table where the RECORD_NO field is the same as the specified number. (allows a specific company profile to be selected)


Outbound-only optional parameters

Table 6-5: Outbound-only optional parameters

Parameter

Description

-a

Updates the ISA Out control count field only in the All TradePartner record (customer number = 0) when the interchange envelopes are built.

-db

Does not delete outbound temporary files created when processing multiple files (in other words, when the map is set by the user to separate one input file into several input files). These files are not deleted and can be used to diagnose map flow problems. Use this switch when debugging.

-dw <directory>

Uses the named directory as the location of the wixset.dat (company) file.

-ei <full-path filename>

Uses the named filename in place of the input application filename embedded in the map.

-kf

Splits files into multiple files only once when processing multiple files (when the map is set by the user to separate one input file into several input files).

-mo < full-path filename>

Uses stdout in place of the named file imbedded in the map.

-ne

Does not produce an outbound EDI file.

-nt

Does not perform trading partner lookup. (Uses the map passed in on the command line.)

-pe

Pads alphanumeric fields with trailing spaces if those spaces are required to meet the minimum length of the element. Numeric fields will be padded with leading 0s if those 0s are required to meet the minimum length of the element.

This switch is an optional replacement for PADEDI environmental variable.

-s3<value>

Uses the specified value to create the optional ST03 element on outbound X12 EDI transactions.

-td <directory>

Writes temporary split files to the named directory. Temporary split files (pfs.*) are created when the Multiple Files option is selected (when the map is set by the user to separate one input file into several input files). If this switch is not set, the temporary files are written to the current directory. (In earlier versions, they were written to the root directory.)

-u

Does not write EDIFACT UNB and UNG segments.

-xmo

Uses stdout in place of the EDI file during map execution.


Inbound-only optional parameters

Table 6-6: Inbound-only optional parameters

Parameter

Description

-ab

Specifies a new full path and file name to be used in place of the BAD EDI file.

-ag

Specifies a new full path and file name to be used in place of the GOOD EDI file.

-as

Checks that each ST Transaction Control Number in a GS to GE is greater than the previous ST Transaction Control Number. Validation assumes control numbers appear in ascending order.

-b

Does not save the rejected EDI messages/transactions into the badtrans.nmt file.

-clz

Flags leading zeros in numeric X12 fields as an error on HIPAA compliance maps.

An error is flagged if leading zeros are not used to meet the minimum length requirement of that particular element. If the leading zeros are necessary to meet the minimum length of the element, no error is generated. This option does not check leading zeros on non-compliance maps.

-cu

Checks for unique control numbers within a transaction. Control numbers can now occur in any sequence, as long as they are unique.

If duplicate control numbers are found, ECRTP logs a 6054 error. Use only one of the switches (-as or -cu) for any map run. If both switches are present, ECRTP defaults to the last switch encountered.

-ee <number of characters>

Ends processing of the EDI file after it processes the specified number of characters. (Useful when processing is done by VANS who charge by the byte).

-eo <full path filename>

Uses the named full path file name in place of the output application file name embedded in the map.

-es <number of characters>

Starts processing the EDI file after it has read the specified number of characters. (Useful when processing is done by VANS who charge by the byte.)

-k

Sets compliance checking for:

  • Missing mandatory segments

  • Exceeding loop counts

  • Exceeding segment counts

  • Segments out of sequence

  • Exceeding Standards definition for number of elements in a segment

-m <mapname>

Runs the map with the specified map name without referencing company or trading partner files. (<mapname> is the file name of the map without the extension. For example, 837IN is the <mapname> for the map file 837IN.map.).

-mi <full path filename>

Uses stdin in place of the named file imbedded in the map.

-ncb

Indicates that the EDI file to be processed is an NCPDP batch file. Required for all inbound NCPDP files unless -nct is active.

-nct

Indicates that the EDI file to be processed is an NCPDP telecommunications file. Required for all inbound NCPDP files unless -ncb is active.

-nt

Does not perform trading partner lookup. (Uses the map passed in on the command line.)

-s3

Processes the optional 12 ST03 element in incoming EDI data.

-sc

Validates the sequence of the Interchange (ISA) and Group (GS) control numbers. If you use this command, RTP checks the current control number against the Trading Partner database to validate the entry. If the entry in the file is not the next sequential entry, an error will be reported.

If you run an inbound compliance map, choose the “Validate Control Number Sequence" option to add an -sc switch to the command line options.

-td <directory>

Writes the bin files to the named directory if the –du switch is not set. (All bin files start with bin.)

-w

Overwrites all output map files. (The default is to append the map files.).

-xmi

Uses stdin in place of the named EDI file during map execution.


Inbound-only optional parameters – trading partner lookup switches

Table 6-7: Trading partner lookup switches – Inbound-only

Parameter

Description

-er

Performs a reverse trading partner lookup based on the group receiver code.

-ol

Triggers a series of look ups against the Trading Partner database when the ECMap/EC Gateway Log is used as input.

If a trading partner match is found, ECRTP uses the entry to populate the EDI envelope.


Inbound-only optional parameters for ODBC database users – trading partner lookup switches

Table 6-8: ODBC trading partner lookup switches – inbound-only

Parameter

Description

-e1

Performs the trading partner lookup based on the group sender and receiver codes.

-e2

Performs the trading partner lookup based on the group sender code and the interchange sender code and qualifier.

-e3

Performs the trading partner lookup based on the group sender and receiver codes and the interchange sender and receiver codes and qualifiers.

-e4

Performs the trading partner lookup based on the group receiver code and the interchange receiver code and qualifier.

-e5

Performs the trading partner lookup based on the interchange sender code and qualifier.

-e6

Performs the trading partner lookup based on the interchange receiver code and qualifier.

-e7

Performs the trading partner lookup based on the interchange sender and receiver codes and qualifiers.

-e8

Performs a reverse trading partner lookup based on the interchange sender and receiver codes and qualifiers.

-e9

Performs a reverse trading partner lookup based on the group sender and receiver codes and the interchange sender and receiver codes and qualifiers.

-e10

Performs a reverse trading partner lookup based on the interchange receiver code and qualifier.

-e11

Performs a reverse trading partner lookup based on the interchange sender code and qualifier.

-e12

Performs a reverse trading partner lookup based on the group sender code and the interchange sender code and qualifier.

-e13

Performs a reverse trading partner lookup based on the group receiver code and the interchange receiver code and qualifier.

-e14

Performs the trading partner lookup based on Batch Sender.

Validates interchange and group data against the Trading Partner database during inbound processing, and, if any information does not match, ECRTP writes an error to the log and returns an error in the TA1 Acknowledgment.

-e15

Performs the trading partner lookup based on Batch Receiver.

-e16

Performs the trading partner lookup based on Batch Sender and Receiver.

-e17

Performs the trading partner lookup based on Bin Number.

-e18

Performs the trading partner lookup based on Processor Control Number.

-e19

Performs the trading partner lookup based on Batch Sender and Bin Number.

-e20

Performs the trading partner lookup based on Batch Sender and Processor Control Number.

-e21

Performs the trading partner lookup based on Batch Receiver and Bin Number.

-e22

Performs the trading partner lookup based on Batch Receiver and Processor Control Number.