The PrintEDI command

This command is a shortcut for the RunMapIn command with the Print only option. During execution of a process, EC Gateway can be configured to print the EDI messages it is currently processing. 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 Print function. You can define your switches by clicking on the arrow icon beside this field. This displays the Print 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. 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

NoteYou can access the RunMapIn command window by clicking in the PrintEDI command window.

These are the parameters on the Required tab:

Field

Description

Inbound EDI File Type

Clicking on the arrow icon will present to the user several choices for File Type. The choices are input FileName (default), Variable, MailBox, Mailbox – IN Only, Mailbox – Good Only.

Inbound EDI File

The prompt displayed by the Browse button depends on the option you selected for Inbound EDI File Type. This is the location of the file containing the EDI data to be translated by the map

Map Directory

The full directory path of the file which contains the generated map (.map file). You can search for the directory path by clicking the Browse button. As 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 Browse 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.

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. You can use the connection string specified under the System-ODBC TP Data Source Name tab.

These are the parameters on the Option 1 tab:

Field

Description

All Trading Partner Default

This option uses the ALL trading partner and trade agreements associated with it for map execution.

Ignore Trading Partner MailBox

This check box should be checked.

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. It is recommended against checking this check box to prevent overwriting of needed data.

Ignore Tradstat MailBox

This check box should be checked.

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. This makes 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. This allows you to associate a specific company profile with this map. Clicking the Browse button will take the user to the Company Identification window. The Record Number, Company Name, and Trade Partner Group are listed.

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

These are the parameters on 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.

Substitute User File Directory

Changes the name and location of the user file directory.

Substitute Map and TP Directory

Changes the names and location of the map and the Trading Partner 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

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

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

These are the parameters on 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 parameters on 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.