Overview

Universal Connector for SAP returns spoollists in a raw (SAP internal) format. This raw format contains all of the formatting control codes that the SAP system needs to display or print the spoollist. In most cases, this raw format will not be desirable.

Therefore, Universal Connector for SAP provides the ability to translate the raw spoollist into a desirable format. The translation is performed using a user definable translation table. Multiple translation tables can be defined to achieve different formatting results. The required translation table can be specified at run time.

On UNIX systems, the Spoollist Translation (STT) files are located in the NLS subdirectory of the installation directory.

Universal Connector ships with two Spoollist Translation files: default.stt and raw.stt. The default Spoollist Translation Table file is default. This translation table contains translations for the standard SAP formatting codes to appropriate character representations. The raw translation table defines no translations and allows USAP to return the spoollist in its SAP internal format.

Spoollist Translation Table File Format

The Spoollist Translation Table files consist of three white space-separated columns.

Column 1

This is a compare string to look for in the raw unformatted spoollist. This compare string is built by combining comma delimited values. The values are combined to make up the actual compare string. The values can be quoted strings, hexadecimal values representing characters, or decimal values representing characters.

Column 2

This is a replace string that will be used to replace the compare string in the raw unformatted spoollist. This replace string is built from comma delimited values. The values are combined to make up the actual replace string. The values can be quoted strings, hexadecimal values representing characters, or decimal values representing characters.

Column 3

This is a single decimal value used to restrict the comparison to a specific starting column. A value is not required in this column. If no value is specified in this column, the compare string will be replaced in every location that it is found.