We would like to create a SYSMDUMP file in our JCL in case our CA Datacom processing fails and tries to create an SVC Dump.
How do I code the DD statement in the JCL, and what parameters do I need for the dump?
Component : CA DATACOM/DB, CA DATACOM/AD, CA DATACOM
First, note that through JCL, there are three different dump DD statements you can use to create a dump, If you code more than one of these in your JCL, the last DD statement specified is the one that is used. The three dump types are:
If you want to use SYSMDUMP, and your application creates multiple dumps, you can avoid creating multiple redundant files by using a special DSN of SYS1.SYSMDPxx (xx = 00 through FF). This requires special handling, and the file must be preallocated with an end-of-file mark on the first record. For more information about this, please refer to the IBM Documentation to "Preallocate data sets for SYSMDUMP dumps."
There is a comprehensive article that discusses the overall operating system settings used for dump management, where the data areas/memory areas are discussed. Please review Knowledge Base article 30191, titled "IBM MVS dump options to check to assure that you are providing a complete dump."
In addition, if you want to customize the contents of your SYSMDUMP, there are several ways to make the change on a temporary or a more permanent basis. Please refer to the IBM documentation for "Customizing SYSMDUMP dump contents" or the "CHNGDUMP command" webpages.
Now, if you want to set the specific data areas in your PARMLIB member IEADMR00, you can use these for Datacom:
SDATA=(CSA,LPA,LSQA,NUC,PSA,RGN,SQA,SUM,SWA,TRT)
Note that to complete dump using the above DD statements, you need to disable other dump formatters in the job/proc you are running. You will need to add one of these below DD statements to turn off the formatters:
//IDIOFF DD DUMMY TURN OFF IBM FAULT ANALYZER
//ABNLIGNR DD DUMMY TURN OFF ABEND-AID
//ESPYIBM DD DUMMY TURN OFF EYE-SPY
//CAOESTOP DD DUMMY TURN OFF CA-OPT II & CA-SYMDUMP
//DMBENAN DD DUMMY TURN OFF DUMPMASTER
//PSPOFF DD DUMMY TURN OFF SOFTWORKS PERFORMANCE ESSENTIAL
Finally, in terms of the SYSMDUMP allocation for CA Datacom processing, the dump file could require a lot of space (or you can write the dump to tape). It is not possible to know specifically how much, as it depends on the amount of storage that has been allocated to the MUF at the time of the dump. Since we dynamically allocate and release storage as needed, you will not be able to get an absolute value. Recent dumps that we have received were 4000 to 60000 tracks (250 to 4000 cylinders), with one file using 81000 tracks (5400 cylinders).
To add this to your JCL, use a DD statement like this:
//SYSMDUMP DD DISP=(NEW,DELETE,CATLG),
// DSN=your.file.name,
// RECFM=FB,LRECL=4160,BLKSIZE=0,
// SPACE=(CYL,(3000,200),RLSE),
//>choose> UNIT=(SYSDA,##),VOL=SER=volume
//>choose> MGMTCLAS=xxxxxxxx,STORCLAS=xxxxxxxx,DATACLAS=xxxxxxxx
Notes on the JCL:
With this information, your dump files should be much more useful and your diagnosis of the problem will hopefully be easier.
As always, please contact CA Technologies support for CA Datacom if you have further questions.