The IMS Interface › Interface Commands › TRANSLATE Command

TRANSLATE Command

The TRANSLATE command controls the production of a translated output tape. It is also required if you wish to create EXTDATA. This translated output tape is used as input to the Report Writer. Use the TRANSLATE command to:

• request the production of the translated output tape
• identify the User Accounting Table, if any, that defines user accounting field contents in the translated records
• specify a CPU identifier to be associated with the translated IMS data

The following is the format of the TRANSLATE command:

Command             Operands

[LABEL] TRANSLATE

                   [SUFFIX  [= {AT} ] ]
                   [        [  {xx} ] ]

                   [,CPUID= {I} ]
                   [        {x} ]

                   [,USEPSB= {YES} ]
                   [         { NO} ]

SUFFIX=

specifies the two-character suffix of the User Accounting Table load module name. The suffix is appended to the first six letters of the name JSIIMU to identify the load module name of the User Accounting Table.

For example, specifying SUFFIX=01 causes the interface to load a User Accounting Table named JSIIMU01. Specifying SUFFIX=AT would cause loading of module JSIIMUAT.

This parameter is optional. If SUFFIX= is not specified, no User Accounting Table is loaded and the user accounting fields in all translated records contain blanks.

CPUID=

specifies the one-character CPU identifier that is put into the IMS Interface interface summary records. This CPU identification can be used for various grouping and chargeback rate application functions by the Report Writer.

USEPSB=

specifies that if a Transaction ID is blank to move an asterisk followed by the first seven characters of the PSB name into the transaction ID. If NO is specified, the transaction is rejected.

Note: No parameter or keyword is required to create EXTDATA. All that is required is a CAIJSACT DD statement and a valid TRANSLATE command.