How do you start and stop CA SymDump for CICS at CICS initialization and shutdown time? What are the CA SymDump for CICS programs that you add to the CICS PLT tables?

Products

• SymDump for CICS
• SymDump Batch

Issue/Introduction

How do you start and stop SymDump for CICS at CICS initialization and shutdown time? What are the SymDump for CICS programs that are added to the CICS PLT tables?

Resolution

SymDump for CICS requires the use of global user exit XDUREQ and one optional exit XRMIOUT.  It is recommended that you start SymDump for CICS at CICS startup time so all program abends that produce a transaction dump are captured.  Program IN25INST starts SymDump for CICS and is placed after the DFHDELIM entry. If InterTest for CICS is also installed in the CICS region then the SymDump for CICS IN25INST program should always be placed after the InterTest for CICS IN25PLT program.

SymDump for CICS has an optional startup PLT program IN25INS1. Programs IN25INS1 can be added to the PLT to automatically purge old dumps from the PROTDMP data set at PLT startup. If the automatic purge of dumps configuration parameter is set to Y, IN25INS1 purges any dumps equal to or older than the number of days specified in the Automatic purge hold days parameter. The default for this parameter is one day. Program IN25INS1 should always be placed after IN25INST in the PLT.

If you do not want your dumps to be automatically deleted, set the Automatic purge of dumps parameter to N and refer to the Dynamic purge of oldest dump parameter. This allows SymDump for CICS to dynamically purge non-held dumps during dump capture on a first-in, first-out basis to obtain space for the new dump.

Below is an example of the PLT startup entries.

DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM
DFHPLT TYPE=ENTRY,PROGRAM=IN25INST
DFHPLT TYPE=ENTRY,PROGRAM=IN25INS1

You can automatically deactivate SymDump for CICS by adding program IN25ENPL before the DFHDELIM in your CICS shutdown PLT table. Below is an example of the PLT shutdown entries.

DFHPLT TYPE=ENTRY,PROGRAM=IN25ENPL
DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM