Inbound/outbound optional parameters

Table A-3 contains optional parameters that can be used with both inbound and outbound runs.

Table A-3: Inbound/outbound optional parameters

Parameter

Description

-af full-path map filename full-path new filename

Uses the named “new file name” in place of the named “map file name” embedded 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.

Inbound:

-cn

Outbound:

-cn control number

Disables control number lookups and updates when running inbound and outbound maps.

For inbound processing, -cn prevents the code from doing any control number updates. Use either -cn or -sc.

For outbound processing, -cn control number disables control number lookups and updates when running an outbound map and the value provided for control number is used instead as the control number for the outbound ISA.

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

The run ID number can have from one to eight digits. If there is a log database, the program normally looks up the run ID number in the run ID table in the log database.

-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 overrides 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 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 instead 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.

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

-tc NN

Specifies a maximum waiting time, in milliseconds, for ECRTP to establish a database connection. The default NN value for this switch is 1000 milliseconds.

-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 “Text transaction log files,” in Chapter 7, “Non-ODBC Database and File Formats” in the ECRTP Reference Guide 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.