How do I override the default of 1 for the number of duplicate dumps allowed in the CA Symdump for CICS PROTDMP file?

Document ID : KB000039377
Last Modified Date : 14/02/2018
Show Technical Document Details

Question: 

I am installing CA Symdump for CICS release 9.1.  When I run CAI.SYMDUM91.CABAJCL(SYMFILE) the IN25INIT step to initialize the PROTDMP file, the number of duplicate dumps is set to one.  How do I override this default and increase the number of duplicate dumps allowed?  

Answer:

Duplicate dump suppression is controlled by two control statements:

  • SUPPRESSD=Y or N which specifies whether or not dump suppression is in effect.  The default is N 
  • SUPPRESSL=001 - 999 duplicate dump suppression limit.  The default is 001.  The value must be set with a 3 digit number and this control statement will only take effect if SUPPRESSD is set to Y.  

These two control statements are valid with two batch utilities distributed with CA Symdump for CICS releases 8.5 and above:

  • IN25INIT - This program can only be run against a newly created PROTDMP file.  It cannot be run against a previously initialized file.  It sets the initial values for the PROTDMP file when it is first defined.       
  • IN25DMPU - This program was introduced with CA Symdump for CICS r8.5 and can be used against an existing PROTDMP file.  Use it to list the file statistics, options, and to modify any options originally set with IN25INIT when the file was originally created.     

The following JCL defines a 50 cylinder VSAM file and sets the initial parameter values for the PROTDMP file to the default values using IN25INIT.  The duplicate dump suppression values, SUPPRESSD and SUPPRESSL can be changed as desired:

//DEFDMP   JOB
//DEFINE     EXEC PGM=IDCAMS
//SYSPRINT DD    SYSOUT=*
//SYSIN       DD     *
   DELETE    CAI.SYMDUM91.PROTDMP
   SET MAXCC=0
   DEFINE CLUSTER  (NAME(CAI.SYMDUM91.PROTDMP) -
                                  CYL(50)                                           -
                                  VOLUMES(V12345)                         -
                                  CISZ(8192)                                     -
                                  RECSZ(8185 8185)                         -
                                  FSPC(0 0)                                        -
                                  SHR(4 3)                                          -
                                  NUMBERED)                                     -
                                  DATA(NAME(CAI.SYMDUM91.PROTDMP.DATA))
/*
//INIT           EXEC PGM=IN25INIT
//STEPLIB    DD     DSN=CAI.SYMDUM91.CABALOAD,DISP=SHR
//                  DD     DSN=CAI.SYMDUM91.CAVHLOAD,DISP=SHR
//PROTDMP  DD     DSN=CAI.SYMDUM91.PROTDMP,DISP=OLD
//SYSPRINT  DD     SYSOUT=*
//SYMSYSIN  DD    *
SUPPRESSA=Y
SUPPRESSC=Y
PURGE=Y
HOLD=01
MESSAGES=Y
CAPTUREX=Y
DUMPCURR=Y
SELECT=CURRDATE
SUPPRESSD=N                         <== Change to Y as appropriate
SUPPRESSL=001                      <== Change to a value greater than 001 as appropriate 
DYNAPURGE=N
PREVABEND=N
/*
//

It should also be noted that the JCL example above can also be used to create a new PROTDMP file after the product is installed.     

Once the PROTDMP file is created and assuming you want to change the duplicate dump suppression values they can always be modified using IN25DMPU.  If this is the primary PROTDMP file used in the CICS region, CA Symdump must be inactive when this job is run.  Otherwise, if the file is not in use by CA Symdump for CICS, this job can be run at any time.

The following JCL changes the options of SUPPRESSD to Y and the SUPPRESSL value is increased to allow 10 duplicate dumps. The LIST ALL displays the file statistics as well as any dumps that exist in the file.  OPT ALL displays the options that were set or modified.

//MDFYDMP  JOB
//MDFY         EXEC  PGM=IN25DMPU
//STEPLIB     DD     DSN=CAI.SYMDUM91.CABALOAD,DISP=SHR
//SYSPRINT  DD     SYSOUT=*
//SYSIN        DD     *                 
DSN CAI.SYMDUM91.PROTDMP
OPT SUPPRESSD Y
OPT SUPPRESSL 010
LIST ALL
OPT ALL
/*
//

Additional Information:

Information about the PROTDMP definition and the use of IN25INIT is found in the CA Symdump for CICS r9.1 Installation Guide

Information about the use of IN25DMPU to maintain the PROTDMP file is found in the CA Symdump for CICS r9.1 User Guide.

Technical document TEC490862 also describes the use of IN25DMPU.