Troubleshooting data for file control shared data table (SDT) problems

CICS® MustGather for file control shared data table (SDT) problems

Gather the following diagnostic information before contacting the CICS support team to troubleshoot your shared data table (SDT) problems.

Required data:
  1. The CICS message log for all CICS regions that use the SDT and the system log (SYSLOG) for all MVS™ images that use the SDT.
  2. The CICS internal trace that is included in the MVS system dump when tracing is active. Ensure that the internal trace table size is big enough to contain sufficient data for diagnosis; for example, you can use a table size of 20480K. When possible, turn on level 1 tracing for all CICS components and level 1-2 for the FC component. For more information, see Using trace for CICS problem determination on z/OS®.
  3. The MVS system dump of the CICS address space and the data spaces for the shared data tables. For more information, see Using dumps for CICS problem determination on z/OS and Data spaces for data tables. Use the following MVS command at the time of the problem to capture the dump:
    DUMP COMM=(CICS & SDT)
R nn,JOBNAME=(cicsjob),
DSPNAME=('cicsjob'.DFHDTnnn),END

    where:

    nn
    Specifies the reply identifier.
    cicsjob
    Specifies your CICS job name.
    DFHDTnnn
    Specifies the data space name.

    If the total size of the data tables exceeds 2GB, the data records for each table might be spread across more than one data space. For example, DFHDT003, DFHDT004 and so on.

    To dump multiple data spaces, you can follow a partial data space name with a wildcard of asterisk. For example, specify DSPNAME=('cicsjob'.DFHDT*) to dump all data spaces that start with DFHDT. However, use wildcards with care because if there are many data spaces the dump data set might be huge. For more information, see Dump information for data tables.

    To determine the data space name or names of your CICS region, enter MVS command D J,jobname, where jobname is your CICS job name. For example, a DSPNAME=DFHDT001 in the message output indicates that the data space name is DFHDT001.