The RouteEDI command

The RouteEDI command calls the ECMap engine and executes the inbound map corresponding to the communications channel and system you are currently using. (This command calls to the Run Map window.) The following parameters can be accessed from this window.

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 Route EDI window with the Required tab active.
Return Code	A numerical code with a value of 0 to 5 reporting the result of the map run. 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 available from the Required tab:

Field	Description
Inbound EDI File Type	Clicking on the arrow icon presents to the user several choices for File Type. The three choices are input FileName (default), MailBox, and Variable. The Mailbox option results in the system looking in the input folder of the mailbox and running the file through the map. The Variable option is a variable representing a filename..
Inbound EDI File	You will be prompted at the Browse with a choice based on your response to the Inbound EDI File Type above.
Map Directory	The full directory which contains the generated map. You can search for the directory path by clicking the Browse button. By default, the text field is populated with C:\ECEDIGS\Map. Clicking on the Browse button will take the user to the Select a Directory… window. The default drive is C: and the default folder is ECEDIGS\Map.
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 available from the Option 1 tab:

Field	Description
All Trading Partner Default	This uses the ALL default trading partner and any trade agreements associated with it for this map run.
Ignore Trading Partner MailBox	When this is checked, outbound EDI files are not placed in the directory specified by the trading partner record in the Trading Partner database. If this is set and a tradstat mailbox does not exist or Ignore tradstat is set, the output is in the original outbound X.12 file from the Required tab.
ST03 (X.12)	Enables the use of the Implementation Convention Reference. This is an optional element of the X.12 Standard beginning with version 4030.
Overwrite Output User Files	When this is checked, the output overwrites any existing user files. If this is not checked, the output is appended to any existing user files.
Ignore Tradstat MailBox	This overrides the Trade Agreement (Status) destination field..
Validate Control Number Sequence	Tells ECRTP to check the received control numbers. This check confirms that the numbers have been incremented by one from the previous number received.
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.
Run Inbound Map	Enter the file name of the map here without the .map extension to make the inbound program automatically run the map without doing trade partner lookups to find a different map.
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 parameters available from the Option 2 tab:

Field	Description
Zero Fill EDI Non-Null Numbers	Zero-fill incoming numeric elements that are not blank (-z switch in a batch file).
Output the Elapsed Time	Outputs the elapsed time of the run into the short trace file..
Create Bad Transaction Log	Creates a Bad Transaction log that tracks incoming transactions that cannot be processed.
Trading Partner Search Option	How the EC Gateway looks up Trade Partner data. The following are options for this field: Group Sender – default – routing to mailboxes based on the department-level sender’s identification Group Receiver – routing to mailboxes based on the department-level receiver’s identification Group Sender and Receiver – routing to mailboxes based on the department-level sender and receiver’s identification Full Interchange – Sender – map selection and routing to mailboxes based on the company and department-level sender’s identification Full Interchange – Sender and Receiver – map selection and routing to mailboxes based on the company and department-level sender and receiver’s identification Full Interchange – Receiver - map selection and routing to mailboxes based on the company and department-level receiver’s identification Outer Interchange – Sender Only – map selection and routing to mailboxes based on the company-level sender’s identification. Outer Envelope – Receiver – map selection and routing to mailboxes based on the company-level receiver’s identification Outer Envelope – Sender/Receiver – map selection and routing to mailboxes based on the company-level identification for sender and receiver Reverse – Outer Envelope – Sender/Receiver – compliance checking of outbound EDI using sending and receiving company-level identification for map selection Reverse – Full Interchange – Sender/Receiver - compliance checking of outbound EDI using sending and receiving company and department-level identification for map selection Reverse – Receiver Against Main – compliance checking of outbound EDI using company-level receiver’s identification for map selection Reverse – Outer Sender Against Override – compliance checking of outbound EDI using company-level sender’s identification for map selection Reverse – All Sender Against Override – compliance checking of outbound EDI using company-level and department-level sender’s identification for map selection Reverse – All Receiver Against Main – compliance checking of outbound EDI using company-level and department-level receiver’s identification for map selection
Substitute Output Filename	Changes the name of the output file. This overrides the name of the output application file.
Substitute User File Directory	Changes the name of the output file.
Substitute Map and TP Directory	Changes the name and location of the user file directory.
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
Start Processing at Byte Count	Begins processing the incoming file at a specific character (byte).
End Processing at Byte Coun	Ends processing the incoming file at a specific character (byte).

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