The dump code options you can specify

The options you can specify differ slightly, depending on whether you are defining the action for a transaction dump code or for a system dump code.

• For a transaction dump code, you can specify:
  • Whether a transaction dump is to be taken.
  • Whether a system dump is to be taken, with or without a transaction dump.
  • Whether a system dump is to be taken on every CICS region in the sysplex related to the CICS region on which the transaction dump is taken. A related CICS region is one on which the unit of work identifiers, in the form of APPC tokens, of one or more tasks match those in the CICS region that takes the transaction dump.
  • Whether CICS is to be terminated.
  • The maximum number of times the transaction dump code action can be taken during the current run of CICS, or before the count is reset.
• For a system dump code, you can specify:
  • Whether a system dump is to be taken.
  • Whether a system dump is to be taken on every CICS region in the sysplex related to the CICS region on which the system dump is taken. A related CICS region is one on which the unit of work identifiers, in the form of APPC tokens, of one or more tasks match those in the CICS region that takes the system dump.
  • Whether CICS is to be terminated.
  • The maximum number of times the system dump code action can be taken during the current run of CICS, or before the count is reset.
  • Whether the system dump is eligible for suppression by DAE.

All the options you specify are recorded in the appropriate dump table, and written in the CICS global catalog. Any dump table entries you have changed or created during a CICS run are preserved when CICS is subsequently shut down. They are available during the next run unless CICS is cold started, when they are deleted from the global catalog.

The only circumstances in which dump table additions and changes are lost are:

• When CICS is cold started.
• When the CICS global catalog is redefined, although this is likely to be done only in exceptional circumstances.
• When CICS creates a temporary dump table entry for you, because you have asked for a dump for which there is no dump code in the dump table.