Debug buttons

Clicking Debug launches the debugger with the most recently configured debug configuration. If this is the first time for the xlate file to be debugged, this button is unavailable since there is no available debug configuration. This is enabled if the xlt file has been previously debugged. When an xlate file is reopened, Debug is disabled.

Clicking Debug with Configuration opens the Xlate Debug Configuration dialog box.

This table shows the available parameters:

Parameter Description
Data File Click the folder button to open a file browser. Select the data file from the $HCIROOT folder.
Format Click the arrow to open a menu of formats in which to read the input Data File.
Encoding Select different multi-byte encodings from the menu.
Detail Level Click the arrow to open a menu of detail levels. Detail levels go from 0, for raw, unparsed data, to 4, for most detail.
Process One Record Reads the selected data file and processes only the first message in the file.
Process All Records Reads the selected data file and processes all the messages in it.
Pre Xlate TPS Click Edit to open the TPS Editor. Use this dialog box to select the TPS procedures to run before message translation.

Click Add to select the procedures or Java class. Then, specify any arguments.

Click OK when finished.

Post Xlate TPS Click Edit to open the TPS Editor. Use this dialog box to select the TPS procedures to run after message translation.

Click Add to select the procedures or Java class. Then, specify any arguments.

Click OK when finished.

Save To Saves the output message to a file. Click the folder button to open a file browser. Select the file in which to save the output message or specify the file name in the field. This file is saved in the $HCISITEDIR folder.
Line Termination Format Click the arrow to open a menu of formats in which to save the output message:
  • Newline Terminated reads the data in the file until it finds a newline character, making all that data one message, and sends that to the parser. It then reads until it finds the next newline character, makes a second message, and sends that to the parser.
  • Length-Encoded reads the first 10 characters to determine the length of the first message. Then it reads that many characters into a message, and sends it to the parser.
  • EOF Terminated reads the file until it gets to the end-of-file character, takes that as a message, and sends it to the parser.
Show Field Names Select the check box to show field names.
Leak Detection Select the check box to check for memory leaks.
Advanced Opens the Advanced Options dialog box. Separator Options parse the message with the specified separator characters (Inbound) and encodes the message with specified separators (Outbound). If a separator is not specified, the default is used.
OK Clicking this on the Xlate Debug Configuration dialog box launches the current debug configuration. Simultaneously, the Translation Configurator switches to Debug mode. If the debugger cannot be launched, an error message opens to indicate the cause.

After the debugger is launched, it pauses at the first xlt action if there is no breakpoint.

When the debugging session begins, clicking Debug opens a Confirm message. Click Yes to restart the Xlate Debugger with the current configuration, or No to cancel the operation.

To maintain synchronization of the xlt file between the GUI and the Xlate Debugger, you must save modifications before launching the Xlate Debugger.