The BuildAcknowledgement command

This command builds an X12 functional acknowledgement (997) transaction. You can then send the transaction using other process commands.

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 allows 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 (.pfs) file.
Switches	Command line switches. 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.

These are the fields that appear on the Required tab of the Build Acknowledgement command window:

Field	Description
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 Browse to change the directory.
Log Type	The type of log you want to generate. Click on the arrow icon beside the field and select Text Log, No Log, or Expanded Text Log.
Non ODBC Trading Partner	This option is blank by default, which indicates that the user will be using an ODBC Trading Partner and will access the TP, TRADSTAT, and WIXSET tables. When this option is selected, it indicates that 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. Click Browse to display the Select a Directory window.
Trading Partner Connection	Click ODBC Type, then select Constant, which displays the ODBC Data Source Name window, or Parameter, which displays a list of standardized parameter names. These names are the current process parameter variables.
Log Connection	Click Browse to display the ODBC Data Source Name window.

These are the fields that appear on the Option 1 tab of the Build Acknowledgement command window:

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

These are the fields that appear on the Option 2 tab of the Build Acknowledgement command window

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..
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. Click Browse to display the Input File window, then enter a new input file name.
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..

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 fields that appear on the File Alias tab of the Build Acknowledgement command window:

Field	Description
Source (Files inside Map)	File name and location that is called from the map. Clicking Add causes a window to appear. You can then select the desired file. The Edit and Delete buttons are available once a source has been chosen. If you click Edit, a window appears with the field already populated. Click Delete to 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 Add causes a window to appear. You can then select the desired file. The Edit and Delete buttons are available once a source has been chosen. If you click Edit, a window appears with the field already populated. Click Delete to 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.

These are the fields that appear on the ODBC Alias tab of the Build Acknowledgement command window:

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 fields that appear on the Parameters tab of the Build Acknowledgement command window:

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 fields that appear on the Memory I/O tab of the Build Acknowledgement command window:

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.

This command works in conjunction with the RunMapOut command.