The following tables contain a listing of all the Windows parameters/switches that can be used with the runtime program (ECRTP)—both when it is run from a script and when it is invoked with a function call. For each parameter/switch, there is a brief description, an indication of whether the parameter/switch is used for inbound or outbound messages, and an indication of whether it is required or optional. The first table contains parameters/ switches that are used with both non-ODBC and ODBC trading partner files, while the second table contains parameters that are used only when the trading partner information is in an ODBC database. Each parameter is described in greater detail following the table.
Parameter |
Description |
Inbound/outbound |
Required/optional |
---|---|---|---|
-a |
Updates the ISA Out control count field only in the ALL TradePartner record when the interchange envelopes are built. |
Outbound |
Optional |
-ab |
Specifies a new full path and file name to be used in place of the BAD EDI file. |
I/O |
Optional |
-af |
Specifies a new full-path file name to be used in place of a file name embedded in the map file. |
I/O |
Optional |
-ag |
Specifies a new full path and file name to be used in place of the GOOD EDI file. |
I/O |
Optional |
-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. |
Inbound |
Optional |
-b |
Does not save the rejected EDI transactions/messages into the badtrans.nmt file. |
Inbound |
Optional |
-c |
Closes the trace file after every write statement. |
I/O |
Optional |
-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. |
Inbound |
Optional |
-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. |
Inbound |
Optional |
-db |
Does not delete outbound temporary files that are created when processing multiple files. |
Outbound |
Optional |
-dg |
Specifies the directory in which the map files are located. |
I/O |
Required |
-dm |
Specifies the directory in which the trading partner, map, and log files are located. |
I/O |
Optionally Required |
-dt |
Specifies the directory in which the trading partner files are located. |
I/O |
Required for Non-ODBC |
-du |
Specifies the directory to be used in place of the application directories embedded in the map. |
I/O |
Optional |
-dw |
Specifies the directory in which the company (wixset.dat) file is located. |
Outbound |
Optional |
-ec |
Does not create the transaction log file (translog.in, translog.out, or trlog) or the status file (status.in or status.out). |
I/O |
Optional |
-ed |
Specifies the directory in which the transaction log file (translog.in, translog.out, or trlog), trace file (incoming.err, outgoing.err, or trnn.dat), and status file (status.in or status.out) are located. |
I/O |
Optional/ Required for Tandem and Stratus |
-ee |
Ends processing of the EDI file after it processes the specified number of characters. |
Inbound |
Optional |
-ef |
Does not create the status file (status.in or status.out) |
I/O |
Optional |
-ei |
Specifies the full-path file name to be used in place of the input file name embedded in the map. |
Outbound |
Optional |
-el |
Specifies the full-path file name to be used for the transaction log. |
I/O |
Optional Required for Tandem and Stratus |
-eo |
Specifies the full-path file name to be used in place of the output application filename embedded in the map. |
Inbound |
Optional |
-er |
Performs the trading partner lookup based on the group receiver. (basic reverse lookup) |
Inbound |
Optional |
-es |
Starts processing the EDI file after it has read a specified number of characters. |
Inbound |
Optional |
-et |
Specifies the directory in which the trace file is located. (incoming.err or outgoing.err) |
I/O |
Optional |
-eu |
Specifies a string variable to be used in place of all but the first character in the application file name (not including the file extension) embedded in the map. |
I/O |
Optional |
-ev |
Specifies a string variable to be placed in front of the application file name in the map. |
I/O |
Optional/ |
-id |
Specifies a Run ID number to be used instead of having the program look it up. If there is a log database, the program normally looks up the Run ID number in the Run ID table in the log database. |
Inbound |
Optional |
-it |
Ignores the trading partner mailbox. |
I/O |
Optional |
-k |
Sets compliance checking. |
Inbound |
Optional |
-kf |
Splits files into multiple files only once. |
Outbound |
Optional |
-l |
Writes long trace messages to an error file. |
I/O |
Optional |
-m |
Runs a specific map (identified by the mapname, which is the file name of the map with no extension) without referencing company or trading partner files. |
Inbound |
Optional |
-mi |
Uses stdin in place of a file embedded in the map. |
Inbound |
Optional |
-mm |
Uses a temporary memory location in place of a file embedded in the map. |
I/O |
Optional |
-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 Map Name Extension before calling the functions. |
I/O |
Optional |
-mo |
Uses stdout in place of a file embedded in the map. |
Outbound |
Optional |
-mp |
Uses a specific memory address in place of a file embedded in the map. |
I/O |
Optional |
-mx |
Keeps a specified number of maps open in memory. |
I/O |
Optional |
-n |
Uses the ALL TradePartner record if no trading partner match is found in the trading partner file. |
I/O |
Optional |
-ncb |
Indicates that the EDI file to be processed is an NCPDP batch file. Required for all inbound NCPDP files unless -nct is active. |
Inbound |
Required for inbound NCPDP batch files |
-nct |
Indicates that the EDI file to be processed is an NCPDP telecommunications file. Required for all inbound NCPDP files unless -ncb is active. |
Inbound |
Required for inbound NCPDP telecommunications files |
-ne |
Does not produce an outbound EDI file. |
Outbound |
Optional |
-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:
|
I/O |
Optional |
-nt |
Does not perform a trading partner lookup. Uses the map specified in the command line. |
Outbound |
Optional |
-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. |
I/O |
Optional |
-o |
Does not use the trade agreement mailbox directory and file name. |
I/O |
Optional |
-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. |
Outbound |
Optional |
-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 |
Outbound |
Optional |
-pf |
Uses contents of the file as the command line parameters |
I/O |
Optional |
-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. |
I/O |
Optional |
-rb |
Ignores the trade agreement mailbox and places routed EDI data in the trading partner BAD mailbox. |
I/O |
Optional |
-re |
Ignores the trade agreement mailbox and places routed EDI data in the trading partner IN mailbox. |
I/O |
Optional |
-rg |
Ignores the trade agreement mailbox and places routed EDI data in the trading partner GOOD mailbox. |
I/O |
Optional |
-ro |
Ignores the trade agreement mailbox and places routed EDI data in the trading partner OUT mailbox. |
I/O |
Optional |
-rt |
Ignores the trade agreement mailbox and places routed EDI data in the trading partner OTHER mailbox. |
I/O |
Optional |
-s |
Does not produce a trace file. |
I/O |
Optional |
-s3 |
Processes the X12 ST03 element. |
I/O |
Optional |
-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. |
I/O |
Optional |
-sdb |
Specifies the maximum number of cached ODBC connections. The default value '0' indicates no ODBC connection caching. |
I/O |
Optional |
-t |
Specifies the message/transaction set being mapped. |
Outbound |
Required |
-td |
Specifies the directory in which the bin files are located if the –du switch is not set. Specifies the directory in which the temporary split files are located. |
Inbound Outbound |
Optional Optional |
-tm |
Writes the elapsed run time to the trace file. |
I/O |
Optional Optional |
-u |
Does not write EDIFACT UNB and UNG segments. |
Outbound |
Optional |
-w |
Overwrites all application output files. (The default is to append the application output files.) |
Inbound |
Optional |
-xf |
Closes map(s) that have been left open in memory. |
I/O |
Optional |
-xl |
Writes the text transaction log file in expanded field length format. |
I/O |
Optional |
-xmi |
Uses stdin in place of the EDI file in the map. |
Inbound |
Optional |
-xmo |
Uses stdout in place of the EDI file in the map. |
Outbound |
Optional |
-xmp |
Uses a specific memory address in place of the EDI file in the map. |
I/O |
Optional |
-z |
Zero-fills numeric fields that contain data. |
I/O |
Optional |
Table 6-2 contains UNIX Run Time parameters that are only for ODBC users.
Parameter |
Description |
Inbound/outbound |
Required/optional |
---|---|---|---|
-ad |
Specifies a DSN connect string to be used in place of a specified DSN connect string embedded in the map file. |
I/O |
Optional |
-e1 |
Performs the trading partner lookup based on the group sender and receiver. |
Inbound |
Optional |
-e2 |
Performs the trading partner lookup based on the group and interchange sender. |
Inbound |
Optional |
-e3 |
Performs the trading partner lookup based on the group and interchange sender and receiver. |
Inbound |
Optional |
-e4 |
Performs the trading partner lookup based on the group and interchange receiver. |
Inbound |
Optional |
-e5 |
Performs the trading partner lookup based on interchange sender. |
Inbound |
Optional |
-e6 |
Performs the trading partner lookup based on the interchange receiver. |
Inbound |
Optional |
-e7 |
Performs the trading partner lookup based on the interchange sender and receiver. |
Inbound |
Optional |
-e8 |
Performs a reverse trading partner lookup based on the interchange sender and receiver. |
Inbound |
Optional |
-e9 |
Performs a reverse trading partner lookup based on the group and interchange sender and receiver. |
Inbound |
Optional |
-e10 |
Performs a reverse trading partner lookup based on the interchange receiver. |
Inbound |
Optional |
-e11 |
Performs a reverse trading partner lookup based on the interchange sender. |
Inbound |
Optional |
-e12 |
Performs a reverse trading partner lookup based on the group and interchange sender. |
Inbound |
Optional |
-e13 |
Performs a reverse trading partner lookup based on the group and interchange receiver. |
Inbound |
Optional |
-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. |
Inbound |
Optional |
-e15 |
Performs the trading partner lookup based on Batch Receiver. |
Inbound |
Optional |
-e16 |
Performs the trading partner lookup based on Batch Sender and Receiver. |
Inbound |
Optional |
-e17 |
Performs the trading partner lookup based on Bin Number. |
Inbound |
Optional |
-e18 |
Performs the trading partner lookup based on Processor Control Number. |
Inbound |
Optional |
-e19 |
Performs the trading partner lookup based on Batch Sender and Bin Number. |
Inbound |
Optional |
-e20 |
Performs the trading partner lookup based on Batch Sender and Processor Control Number. |
Inbound |
Optional |
-e21 |
Performs the trading partner lookup based on Batch Receiver and Bin Number. |
Inbound |
Optional |
-e22 |
Performs the trading partner lookup based on Batch Receiver and Processor Control Number. |
Inbound |
Optional |
-et |
Specifies the trace file directory. (trnn.dat) |
I/O |
Optional |
-sl |
Specifies a DSN connect string to be used in place of the log database DSN connect string embedded in the map. |
I/O |
Required for ODBC Log |
-st |
Specifies a DSN connect string to be used in place of the trading partner database DSN connect string embedded in the map. |
I/O |
Required for ODBC TP |
-td |
Specifies directory used to make sure information is correctly backed out with Backout and Checkpoint commands. |
I/O |
Optional |
-wx |
Uses the record in the WIXSET company ID table where the RECORD_NO field is the same as the specified number (in other words, selects a specific company profile). |
I/O |
Required for ODBC TP |