Creating and sending a system dump
search cancel

Creating and sending a system dump

book

Article ID: 56096

calendar_today

Updated On:

Products

Roscoe

Issue/Introduction

Contents:

Section 1: Why is a dump necessary?
Section 2: What kind of dump should I get?
Section 3: How do I set a slip?
Section 4: How do I get a console dump?
Section 5: How do I terse a dump?


Environment

Release: 6.0
Component: ROSCOE

Resolution


Section 1: Why is a dump necessary? 

A dump is necessary because it presents a picture of the system at the time of the abend. It tells us exactly what parameters are set, and what is wrong.

Section 2: What kind of dump should I get?

You should get an unformatted SVC dump. CA-Roscoe problems cannot be diagnosed with an ABEND-AID dump or a SYSUDUMP. Please turn ABEND-AID off by adding a

//ABNLIGNR DD DUMMY statement to your Roscoe procedure. 

Section 3: How do I set a slip? 

You need to test a slip to indicate to the system what events you want trapped, and what you want the system to do with those events. You can specify the system to get a dump, or even ignore the events. 
For CA Roscoe events you will be asked to get a dump. The slip command is discussed fully in the IBM System Commands Manual. 

For CA Roscoe use: 
SLIP SET,ACTION=SVCD,ENABLE,ID=xxxx,JOBNAME=job,COMP=0Cx, 
SDATA=(CSA,GRSQ,LPA,LSQA,NUC,PSA,RGN,SQA,SUM,SWA,TRT),E


 

Section 4: How do I get a console dump? 


Under certain situations, you may be asked to take a console dump of the CA Roscoe address space. When taking a console dump, use the "DUMP" command which dumps all of virtual storage. You may refer to the IBM System Commands Manual for full instructions and options.

 

For CA Roscoe you may use the following command:

 

DUMP COMM(variable text)

 

R nn,JOBNAME=job, SDATA=(CSA,GRSQ,LPA,LSQA,NUC,PSA,RGN,SQA,SUM,SWA,TRT),E

 

Section 5: How do I terse a dump? 


Tersing a dump is simply compressing the dump data set. The terse utility is especially useful to compress not only dump data sets but also variable blocked data sets.

 

TRSMAIN is the IBM utility program to compress and decompress data exchanged using anonymous File Transfer Protocol (FTP) from your workstation. It is especially useful when transmitting variable blocked data sets.

 

The compressed dataset (produced by PACK) must be of fixed or fixed blocked record format (RECFM) with a record length (LRECL) of 1024 and any legal block size (BLKSIZE).NOTE: These values do not have to be specified on the DD statement and will default to the correct values.

  

SPACE CONSIDERATIONS: When allocating space for the OUTFILE dataset for either the PACK or UNPACK option, some thought must be given since the required size information is not known to the TRSMAIN program. A compressed dataset can be expected to be about 1/2 the size of the original. It is best to allocate more space than expected and use the RLSE sub-parameter of the SPACE parameter to release the unused portion back to the system.

 

SAMPLE JCL: 

//PACK0 EXEC PGM=TRSMAIN,PARM=PACK 
//STEPLIB DD DSN=user.steplib,DISP=SHR 
//SYSPRINT DD SYSOUT=* 
//INFILE DD DISP=SHR,DSN=SYS1.DUMP 
//OUTFILE DD DSN=SYS1.DUMP.TERSE,DISP=(NEW,CATLG),UNIT=3390, 
// SPACE=(CYL,(60,60),RLSE), 
// DCB=(RECFM=FB,DSORG=PS,LRECL=1024,6144), 
/*