The CONFDATA parameter specifies whether CICS® is to suppress user data that might otherwise appear in CICS trace entries or in dumps.
The normal trace entries (FC90 and FC91) are created on completion of the RECEIVE ANY operation with the text SUPPRESSED DUE TO CONFDATA=HIDETC IN SIT replacing all the user data except the first 4 bytes of normal data, or the first 8 bytes of function management headers (FMHs).
CICS then identifies the target transaction for the data. If the transaction definition specifies CONFDATA(NO), CICS traces the user data that it suppressed from the FC90 trace in the trace entry AP FC92. This trace entry is not created if the transaction is defined with CONFDATA(YES).
The normal trace entries (DD16, DD23, and DD25) are created with the text SUPPRESSED DUE TO CONFDATA=HIDETC IN SIT replacing all the user data.
CICS then identifies the target transaction for the data. If the transaction definition specifies CONFDATA(NO), CICS traces the user data that it suppressed from DD16 in the trace entry AP FC92. This special trace entry is not created if the transaction is defined with CONFDATA(YES).
If the transaction definition specifies CONFDATA(NO), IS trace entries are created with the user data, as normal.
If the transaction definition specifies CONFDATA(YES), user data from IS trace points IS 0602, IS 0702, and IS 0906 is replaced with SUPPRESSED DUE TO CONFDATA=HIDETC IN SIT. Data from IS trace points IS 0603 and IS 0703 is not shown.
Mirror transactions: The CICS-supplied mirror transaction definitions are specified with CONFDATA(YES). This ensures that, when you specify CONFDATA=HIDETC as a system initialization parameter, CICS regions running mirror transactions suppress user data as described for z/OS Communications Server, MRO, and IS data.
Modified data: By waiting until the transaction has been identified to determine the CONFDATA option, z/OS Communications Server, MRO, or IS data may have been modified (for example, it may have been translated to uppercase).
The interaction between the CONFDATA system initialization parameter and the CONFDATA attribute on the transaction resource definition is shown in Table 1.
CONFDATA on transaction | CONFDATA system initialization parameter | |
---|---|---|
SHOW | HIDETC | |
NO | Data not suppressed | Data not suppressed |
YES | Data not suppressed | Data suppressed |
You cannot modify the CONFDATA option while CICS is running. You must restart CICS to apply a change.