The RunMapOut command

The RunMapOut command calls the ECMap engine and executes the outbound map corresponding to the communications channel and system you are currently using. (This command calls the Run Map window.) From this window, the following parameters can be accessed:

Field	Description
Label	Specifies the unique label of this process command. This label allows other commands to branch to this command. The label that you type here appears in the Label column on the EC Gateway Process Window.
Disable command	Disabling the command will allow temporary modification of the process statements. This allows for testing of the statements for error-free robustness. The command that has been disabled will not show in the script file (.pfs file).
Switches	Command line switches to be passed to the ECMap engine. You can define your switches by clicking on the arrow icon beside this field. This displays the Run Outbound Map window with the Required tab active.
Return Code	A numerical code with a value of 0 to 5 reporting the result of the map runs. Choose a Count variable name for this result. The values are: 0 – no errors 1 – errors but no transaction skipped 2 – transactions skipped with ## errors 3 – user Abort Rule and ## errors 4 – user Stop Rule and ## errors 5 – fatal error stop and ## errors

These are the parameters that are available from the Required tab:

Field	Description
Map Name	Name of the map to be processed.
Transaction Name	Displays the transaction set number for the current map..
Code	Refers to the type of EDI being processed. An example of this would be Health Care claim = HC. A complete list of codes can be found in the standards manual.
Ouput EDI File	If ignoring the Trade Partner mailbox, enter the full directory, file name and file extension for the file that will contain the EDI data, otherwise, this is the Trade Partner mailbox directory.
Map Directory	The full directory path containing the generated map (.map file)..
Log Type	The type of log you want to generate. Clicking the arrow button will present to the user four options. The choices include ODBC Log, Text Log, No Log, and Expanded Text Log.
Non ODBC Trading Partner	This option is left blank by default. This means the user will be using an ODBC Trading Partner and will access the TP, TRADSTAT, and WIXSET tables. When checked, the user will be using a non-ODBC Trading Partner and will be using the tables customer.dbf and tradstat.dbf, as well as the flat-file wixset.dat.
Trading Partner Directory	The directory that contains the Trade Partner files, if you are not using an ODBC database to store your trading partner files. Clicking the Browse button will open the Select a Directory… window.
Trading Partner Connection	Clicking ODBC Type gives the user the choice of Constant or Parameter. Constant displays the ODBC Data Source Name window and Parameter presents a list of standardized parameter names. These names are the current process parameter variables.
Log Connection	Clicking the Browse button will open the ODBC Data Source Name window.

These are the parameters that are available from the Option 1 tab:

Field	Description
No Trading Partner	Used for running an Any-to-Any map without a Trade Partner.
All Trading Partner Default	This option uses the ALL trading partner and trade agreements associated with it for map execution..
Ignore Trading Partner MailBox	When this is checked, outbound EDI files are placed in the directory specified by the Output EDI File field on the Required tab. .
No EDI File	Used for running an Any-to-Any map.
Update All Trading Partner Record	When getting control numbers during concurrent runs. Only updates the ALL Trading Partner control number.
Ignore Tradstat MailBox	This overrides the Trade Status destination field.
Trace Type	Short Trace, Long Trace, or No Trace.Long Trace provides a complete map trace. This is recommended for development. Once a mapping process has migrated to production, Short Trace should be selected. Short Trace only writes errors into the trace file. No Trace provides no diagnostic information from the map run.
Route EDI Type	Options include No Routing, Route In, Route Out, Route Good, Route Bad, and Route Other. Routing allows you to pass the EDI transactions directly into the Trade Partner mailboxes without performing actual translation. This field is grayed out unless the Ignore Trading Partner Mailbox check box is not checked.
Company Identification	Enter a record number or browse the company ID table to select the record number for the company ID record for this run. Clicking Browse will take the user to the Company Identification window. This window displays the information for Record Number, Company Name, and Trade Partner Group..
Max Memory Cross Reference	The maximum allowable cross-reference table entries for memory lookups. If tables exceed the size of this parameter, then the table lookups will go to disk. The default size is 10,000 entries.
Number of Maps in Memory	Enter the number of maps in memory. The default value is 0. There is no fixed upper limit to the number of the maps.

These are the options that are available from the Option 2 tab:

Field	Description
No UNG, UNE Segments	Used in EDIFACT transactions.
Map Numeric Zero	Zero-fill outgoing numeric fields that are not blank (-z switch in batch file).
Output the Elapsed Time	Outputs the elapsed time of the run into the short trace file.
Split Multiple Files Once	If you select this check box, whole physical files will be split by record type into separate logical files once. If it is not selected, the files will be split each time a read is encountered.
Substitute Company Directory	Used to change the directory location of the company information when not an ODBC Trading Partner. This allows the user to override the input file that the system is looking for.
Substiute Input Filename	Used to change the name of the input file when only one input file is defined. This allows the user to override the input file that the system is looking for.
Substitute User File Directory	Used to change the location of the files when multiple files are used. This overrides the directory where the system is looking for inputs..
Substitute Map and TP Directory	Used to set a single location for both the Trade Partner files and the map files.
Temporary Files Directory	This is the directory where temporary files are placed by ECRTP. The default is the root directory of the drive where ECRTP is located. The user should have file write access to the root directory.
ST03 (X.12)	This is an alphanumeric field for the Implementation Convention Reference. The user may enter up to 35 characters. This is an optional element of the X.12 Standard beginning with version 4030

The alias allows the user to change directories and file names. This allows the user to adapt the map between machines and different platforms without recompiling the map.

These are the options that are available from the File Alias tab:

Field	Description
Source (Files inside Map)	File name and location that is called from the map. Clicking the Add button will cause a window to appear. The user can then select the desired file. The Edit and Delete buttons are available once a source has been chosen. If the Edit button is chosen, a window appears with the field already populated. Clicking the Delete button will delete the highlighted file. The arrow button provides three options. If the Constant option is chosen, a window appears allowing the choice of a file. If the FileName option is chosen, a list of standardized filenames displays. If the Parameter option is chosen, a list of standardized parameter names displays. These three options define the entry placed in the destination panel.
Destination (Files during Run Time)	File name and location of the file that was called from the map. An Edit button is available if a source file has been added to the destination panel. When the Edit button is clicked, a window opens..

Field

Description

Source (Files inside Map)

File name and location that is called from the map. Clicking the Add button will cause a window to appear. The user can then select the desired file. The Edit and Delete buttons are available once a source has been chosen. If the Edit button is chosen, a window appears with the field already populated. Clicking the Delete button will delete the highlighted file. The arrow button provides three options. If the Constant option is chosen, a window appears allowing the choice of a file. If the FileName option is chosen, a list of standardized filenames displays. If the Parameter option is chosen, a list of standardized parameter names displays. These three options define the entry placed in the destination panel.

Destination (Files during Run Time)

File name and location of the file that was called from the map. An Edit button is available if a source file has been added to the destination panel. When the Edit button is clicked, a window opens..

The alias allows the user to change directories and file names. This allows the user to adapt the map between machines and different platforms without recompiling the map

These are the options that are available from the ODBC Alias tab:

Field	Description
Source (ODBC Connection Strings inside Map)	Connection string that is called from the map. Clicking the Add button will cause a window to open. Enter a string in the text box. If the Edit button is chosen, a window displays with the field already populated. Click the Delete button to delete the highlighted string. The arrow button provides two options. If the Constant option is chosen, a window appears allowing entry of a string. If the Parameter option is chosen, a list of standardized parameter names displays. These two options define the entry placed in the destination panel.
Destination (ODBC Connection Strings during Run Time)	Destination string that was called from the map. An Edit button is available if a destination string has been added to the destination panel. When the Edit button is clicked, a window opens. The field is populated with a current string from the destination panel..

Field

Description

Source (ODBC Connection Strings inside Map)

Connection string that is called from the map. Clicking the Add button will cause a window to open. Enter a string in the text box. If the Edit button is chosen, a window displays with the field already populated. Click the Delete button to delete the highlighted string. The arrow button provides two options. If the Constant option is chosen, a window appears allowing entry of a string. If the Parameter option is chosen, a list of standardized parameter names displays. These two options define the entry placed in the destination panel.

Destination (ODBC Connection Strings during Run Time)

Destination string that was called from the map. An Edit button is available if a destination string has been added to the destination panel. When the Edit button is clicked, a window opens. The field is populated with a current string from the destination panel..

These are the options that are available from the Parameters tab:

Field	Description
Parameter Names	Select the name of the parameter that is to be passed to ECRTP. The arrow button provides two options. If the Constant option is chosen, a window appears allowing entry of a string. If the Parameter option is chosen, a list of standardized parameter names displays. These two options define the entry placed in the destination panel..
Parameter Values Passed at Run Time	The value of the parameter that is to be passed to ECRTP. An Edit button is available if the destination panel has been populated with one or more strings. When the Edit button is clicked, a window opens. The user can enter a new value for the parameter. The Delete button can be used to delete a selected parameter.

These are the options that are available from the Memory I/O tab:

Field	Description
Source (Files inside Map)	File name and location that is called from the map. Use the Add button to select an option: Constant, FileName, or Parameter. The Edit button offers the same options for changing a highlighted file. The Delete button is used to remove a highlighted file. The arrow button provides two options. If the Constant option is chosen, a window appears allowing entry of a name of the shared memory during run time. These two options define the entry placed in the destination panel. Each entry in the destination panel corresponds to an entry in the source panel..
Destination (Names for Shared Memory at Run Time)	The name of the shared memory at run time. An Edit button is available if the destination panel has been populated with a string. When the Edit button is clicked, a window opens. The user can enter a new string value for the parameter. The Edit button is not available for parameter names.

Field

Description

Source (Files inside Map)

File name and location that is called from the map. Use the Add button to select an option: Constant, FileName, or Parameter.

The Edit button offers the same options for changing a highlighted file. The Delete button is used to remove a highlighted file. The arrow button provides two options. If the Constant option is chosen, a window appears allowing entry of a name of the shared memory during run time. These two options define the entry placed in the destination panel. Each entry in the destination panel corresponds to an entry in the source panel..

Destination (Names for Shared Memory at Run Time)

The name of the shared memory at run time. An Edit button is available if the destination panel has been populated with a string. When the Edit button is clicked, a window opens. The user can enter a new string value for the parameter. The Edit button is not available for parameter names.