Windows runtime parameters/switches

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.

Table 6-1: Parameters/switches for trading partner files

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:

  • 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.

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 PADEDI environmental variable.

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.

Table 6-2: ODBC trading partner parameters/switches

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