callConversionTable

The sysVar.callConversionTable system variable contains the name of a conversion table that EGL uses for remote systems.
EGL uses the table name in the variable to convert data when your program performs any of the following actions at run time:

For other necessary conditions, see "Definition considerations" in this topic.

For more information on data conversion, see Data conversion.

Characteristics

sysVar.callConversionTable has the following characteristics:

Primitive type
CHAR
Data length
256
Value saved across segmented converse?
Yes

Definition considerations

Use sysVar.callConversionTable to switch conversion tables in a program or to turn data conversion on or off in a program.

sysVar.callConversionTable is initialized to blanks. To enable data conversion, you must perform both of the following actions:
  • Assign the name of a conversion table to sysVar.callConversionTable.
  • Set the conversionTable property in the callLink, asynchLink, or fileLink element to specify PROGRAMCONTROLLED.

To use the default conversion table for the default national language code for your system, set sysVar.callConversionTable to an asterisk (*). For Java™ generation, the default NLS (national language support) code is specified in the vgj.nls.code Java runtime property. The code must be one of those listed for the targetNLS build descriptor option. For COBOL generation, this setting references the default national language code you specified when you installed EGL runtime services.

Example

The following example shows the assignment of a conversion table.

  sysVar.callConversionTable = "CSOX850"; 
// conversion table for US English on AIX Server

Compatibility

Table 1. Compatibility considerations for sysVar.callConversionTable
Platform Issue
COBOL generation Because conversion table names in COBOL can be no longer than 8 characters, EGL ignores any characters after the first 8.
z/OS® The value is folded to upper case when the EGL runtime seeks a particular conversion table. This does not affect the value stored in the variable.

Feedback