The BuildAcknowledgement command

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. You can define your switches by clicking on the arrow icon beside this field. This displays the BuildAcknowledgement 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 variable name for this result in the Count variable. 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

Map Name

The name of the map to be run.

Transaction Name

The name of the transaction. For ANSI X.12 this should always be 997. For EDIFACT, this value should be CONTRL.

Code

The EDI file code. For ANSI X.12 this should be FA.

Output EDI File

The name of the outgoing EDI file. Click the File Type button to display the choices: Constant, FileName, or Parameter.

Map Directory

The full directory path of the file which contains the generated map. You can search for the directory by clicking Browse, you are then taken to the Select a Directory window. This is automatically populated by the system. Use the Browse if you want to change the directory.

Log Type

The type of log you want to generate. By clicking on the arrow icon beside the field, the user can choose from Text Log, No Log, or 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. Clicking Browse will take the user to the Select a Directory window.

Trading Partner Connection

Clicking ODBC Type gives the user the choice of Constant that displays the ODBC Data Source Name window and Parameter that presents a list of standardized parameter names. These names are the current process parameter variables.

Log Connection

Clicking Browse will take the user to the ODBC Data Source Name window.

No Trading Partner

Used for running an Any-to-Any map because there is no Trade Partner in this case.

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. The output EDI file is placed in the file specified by the Output EDI File text box in the Required tab.

No EDI File

Used for running an Any-to-Any map.

Update All Trading Partner Record

Updates the ALL Trading Partner control number.

Ignore Tradstat MailBox

Leave this button checked because you have explicitly defined the file.

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.

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.

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

Substitute Company Directory

Used to change the directory location of the company information when not an ODBC Trading Partner. Clicking on the Browse button will take the user to the Select a Directory… window. This allows the user to override the input file that the system is looking for.

Substitute Input Filename

Used to change the name of the input file when only one input file is defined. Clicking on the Browse button will take the user to the Input File window. 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. Clicking on the Browse button will take the user to the Select a Directory… window. 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. Clicking on the Browse button will take the user to the Select a Directory… window.

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

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

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

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.

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.