Contents:
Section 1: Why is a z/OS dump necessary?
Section 2: What kind of z/OS dump should I get?
Section 3: How do I set a slip?
Section 4: How do I get a z/OS console dump?
Section 5: How do I terse a z/OS dump?
Section 6: How do FTP a z/OS dump to Broadcom Support?
Release : All
Component : All Mainframe Security Components
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
z/OS dumps are Record format FBS, Record length.4160 Block size 24960.
Section 3: How do I set a slip?
A slip may be needed to indicate to the system what events you want trapped, and what the system is wanted to do with those events. Sites can specify the system to get a dump, or even ignore the events. As required Broadcom Support will provide a slip trap to get a dump. The slip command is discussed fully in the IBM System Commands Manual.
SDATA=(CSA,LSQA,RGN,SQA,SUM,SWA,PSA,TRT
Section 4: How do I get a console dump?
Under certain situations, sites may be asked to take a console dump of a task’s 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.
The following command can be used:
DUMP COMM(variable text)
R nn,JOBNAME=job, SDATA=(CSA,LSQA,RGN,SQA,SUM,SWA,PSA,TRT),END
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.
AMATERSE 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 SPACK) 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:
//STEP EXEC PGM=AMATERSE,PARM='SPACK'
//SYSPRINT DD SYSOUT=*
//SYSUT1 DD DISP=SHR,DSN=sys1.D190723.DUMP
//SYSUT2 DD DISP=(NEW,CATLG),UNIT=SYSDA,
// SPACE=(CYL,(800,70),RLSE),
// DSN=myuser.DUMP.TERSE
NOTE: The SPACK option is more time-consuming than the PACK option by a factor of about three, but in many cases produces much smaller output.
Section 6: How do FTP a z/OS dump to Broadcom Support?
The following JCL can be used to FTP a dump to the Broadcom Server SUPPORTFTP.BROADCOM.COM. Change [email protected] to your Support Online userid and password to your Support Online password. Change 0222222 below to your site’s Broadcom siteid and change 33333333 to your site’s current Case number.
SAMPLE JCL:
//PUTDUMP EXEC PGM=FTP,REGION=0K
//SYSPRINT DD SYSOUT=*
//SYSTCPD DD DISP=SHR,DSN=VTAM.TCPIP.TCPIP.DATA
//OUTPUT DD SYSOUT=*
//INPUT DD *
supportftp.broadcom.com
[email protected]
password
cd /0222222/33333333/files_from_customer
bin
PUT 'myuser.DUMP.TERSE' myuser.dump.TRS
quit
/*