7. PARAMETERS › 7.3 Unit Level Parameters › 7.3.2 CICS Processing Options (CICOPS) › 7.3.2.5 TRANSLATE Statement

7.3.2.5 TRANSLATE Statement

The TRANSLATE statement converts any hexadecimal transaction
identifiers, specified by the CICS PCT XTRAN= and TASKREQ=
parameters, or attention identifiers (such as program
function keys) into any eight-character printable string.
The TRANSLATE statement is optional and is only applicable to
the processing of CICS data.  You can specify multiple
TRANSLATE statements, one for each transaction ID to be
translated.
 
Note:  If your DAY040 step only processes CICS Transaction
Gateway SMF type 111 records, TRANSLATE statements should not
be coded.
 
The TRANSLATE statement format is:
 
TRANSLATE old_id new_id
 
where:
 
old_id =    The original transaction ID to be translated.  It
            must be a recognized attention identifier, such
            as PF1 or PF2; otherwise, it is assumed to be
            specified in hexadecimal.  Valid attention
            identifiers are PF1 through PF24, PA1, PA2, PA3,
            OPID, LPA, CLEAR, or ENTER.  A maximum of 300
            TRANSLATE statements may be given.
 
new-id =    The eight-byte character transaction ID created
            from the translation.
 
Two sample TRANSLATE statements are shown below:
 
TRANSLATE PF1      -----PF1
TRANSLATE F8FFFFFF -PAGEFWD
 
The first TRANSLATE statement converts transaction ID for the
Program Function Key 1 into a printable TRANCODE equal to
"-----PF1".  This transaction record represents data for a
transaction defined to the CICS PCT as TASKREQ=PF1.
 
The second TRANSLATE statement converts monitor data for the
transaction identifier F8FFFFFF to a printable TRANCODE equal
to "-PAGEFWD".  This transaction record represents data for a
transaction defined to the CICS PCT as XTRAN=F8FFFFFF.