CORRID_TRANSLATION

Use the CORRID_TRANSLATION parameter in CQMPARMS to control CORRID translation.

Description

Defines how the CORRNAME and CORRNUM values are parsed from the CORRID.

  • Multiple specifications are allowed for the different connection types.

  • Multiple specifications for the same Db2 subsystem and connection type use the last specification.

  • DEFAULT connection type is used for translation of all unspecified connection types.

When OPTKEYS(CORRID) is specified both the CORRNAME and CORRNUM translations are performed. When OPTKEYS(CORRNAME) is specified only the CORRNAME translation is performed.

OMEGAMON uses the Db2 trace record DSNDQWHC to obtain the connection name (QWHCCN) to determine how to parse the correlation ID (QWHCCV).

Syntax

CORRID_TRANSLATION(db2_ssid, conntype_name, corrname_offset, corrname_length, corrnum_offset, corrnum_length)

db2_ssid
The Db2 subsystem ID.
conntype_name
The connection type. Valid values are TSO, DB2CALL, DB2PRIVATE, RRSAF, CICS®, IMS, DRDA, UTILITY, or DEFAULT. If a connection type is not specified, the default translation is used.
corrname_offset
The CORRNAME offset. Valid values are between 01 and 12. Values less than 10 require a leading zero. The number of characters starting from corrname_offset summed with the corrname_length must not exceed 12. For example, if corrname_length=08 and corrname_offset=05, then bytes 05,06,07,08,09,10,11,12 are selected and this is valid (it is under 12 bytes).
corrname_length
The CORRNAME length. Valid values are between 01 and 08. Values less than 10 require a leading zero. The number of characters starting from corrname_offset summed with the corrname_length must not exceed 12. For example, if corrname_length=08 and corrname_offset=05, then bytes 05,06,07,08,09,10,11,12 are selected and this is valid (it is under 12 bytes).
corrnum_offset
The CORRNUM offset. Valid values are between 01 and 12. Values less than 10 require a leading zero. The number of characters starting from corrnum_offset summed with the corrnum_length must not exceed 12. For example, if corrnum_length=08 and corrnum_offset=05, then bytes 05,06,07,08,09,10,11,12 are selected and this is valid (it is under 12 bytes).
corrnum_length
The CORRNUM length. Valid values are between 01 and 08. Values less than 10 require a leading zero. The number of characters starting from corrnum_offset summed with the corrnum_length must not exceed 12. For example, if corrnum_length=08 and corrnum_offset=05, then bytes 05,06,07,08,09,10,11,12 are selected and this is valid (it is under 12 bytes).
Default
Refer to OMEGAMON documentation for the default parsing.
Example
CORRID_TRANSLATION(DSN,TSO,01,08,08,04,DB2CALL,01,08,08,04, CICS,04,04,01,04,IMS,04,08,01,04,RRSAF,01,08,08,04)