How to configure InterTest Batch to capture a dump to send to Broadcom Support for diagnostic purposes?

Products

• InterTest - Batch

Issue/Introduction

If InterTest Batch abends during foreground or batch link testing, you will need to set certain debugging options in order to capture the required documentation. These changes will be made on the foreground testing panels or in the converted batch link JCL depending on what method you are using to debug your program.

 

Resolution

Typically, Broadcom technical support will request the following documentation.

• A detailed description of the testing session including step by step print screens that outline the event leading up to the abend.
• SYSMDUMP file.
• CAMRDBUG file.
• If the abend debugging session is batch link then send entire batch link job output.

If InterTest Batch abends during foreground testing, the following documentation is required.

• Allocate a SYSMDUMP to the end users TSO ID large enough to hold the captured dump.
  The DCB is RECFM=FBS,LRECL=4160,BLKSIZE=24960
• Allocate CAMRDBUG to the end users TSO ID large enough to hold the captured debugging process.
  The DCB is RECFM=FB,LRECL=278,BLKSIZE=27800 using the ISPF command shell.
• The end user is required to make some diagnostic entries on the CA-InterTest Batch EXECUTION CONTROL Panel when he attempts to reproduce the problem to capture the dump.
  To access this panel the end user selects option 1 Foreground located on the InterTest Batch PRIMARY OPTION MENU and presses enter.
• On the InterTest Batch EXECUTION CONTROL Panel below is a hidden (unlabeled) field to the right of  'Initial commands ==>'. 
  Place a Y in this field. This tells InterTest Batch that this is a test of the debugger not the application.
  In the LE/370 environment if the TRAP option is set to 'ON' then you must set the 'PARM ===>' to '/TRAP(OFF)'
• Press ENTER and fill in the Symbolic information for the program.
  When the application abends in most cases ISPF displays a panel that contains PSW information on the abend. A print screen of this information is needed.

If InterTest Batch abends during Batch Link testing then the following documentation is needed.

Before debugging a batch application using the InterTest Batch Link facility you are required to modify the application JCL to enable the Batch Link environment.
In order to capture the desired diagnostic information needed for problem resolution you must make some changes to the converted Batch Link JCL before submitting it.

The example JCL below executes the InterTest batch demo program CAMRCOBB. (EXEC=CAMRCOBB,PROFILE=USERID )

CAMRCOBB gets invoked by the InterTest Batch Link control program CAMRBL01 (PGM=CAMRBL01).

The FROM JCL is an example of how to setup the batch link JCL to debug our demo program CAMRCOBB.

The TO JCL is and example of the same Batch Link JCL with the debug requirements added.

The following changes are required to capture the necessary diagnostic information.

• Add a SYSMDUMP file to your JCL as outlined in the TO JCL example.
• Add a CAMRDBUG file to your JCL as outlined in the TO JCL example.
• For LE/370 environments that have TRAP(ON) then set to /TRAP(OFF).
  //CEEOPTS  DD  *
   TRAP(OFF)
• Add the TEST parameter to the INT1OPTS entry
  //INT1OPTS DD *
  EXEC=CAMRCOBB,PROFILE=USERID,TEST
• Suppress any dump capture product(s) such as SymDump Batch, Abend-Aid and IBM Fault Analyzer. 

Please send the entire batch JOB output, SYSMDUMP and CAMRDBUG files to CA technical support for review.

FROM:

//STEP 1    EXEC PGM=CAMRBL01,
// REGION=4M
//INT1OPTS DD *
 EXEC=CAMRCOBB,PROFILE=USERID
/*
//INT1PARM DD DISP=SHR,DSN=Interest Batch HLQ.CAMRSAMP
//INT1LOAD DD DISP=SHR,DSN=Interest Batch HLQ.CAMRLOAD
//INT1PNLL DD DISP=SHR,DSN=Interest Batch HLQ.CAMRPNL1
//INT1MSGL DD DISP=SHR,DSN=Interest Batch HLQ.CAMRMSG0
//INT1PROF DD DISP=SHR,DSN=Interest Batch HLQ.PROFLIB
//INT1CLIB DD DISP=SHR,DSN=Interest Batch HLQ.CAMRSRC
//INT1CLOG DD SYSOUT=*
//INT1REPT DD SYSOUT=*
//STEPLIB DD DISP=SHR,DSN=Application Load Library
//SYSPRINT DD SYSOUT=*

TO:

//STEP 1    EXEC PGM=CAMRBL01,PARM='/TRAP(OFF)'
// REGION=4M
//INT1OPTS DD *
 EXEC=CAMRCOBB,PROFILE=USERID,TEST
/*
//INT1PARM DD DISP=SHR,DSN=Interest Batch HLQ.CAMRSAMP
//INT1LOAD DD DISP=SHR,DSN=Interest Batch HLQ.CAMRLOAD
//INT1PNLL DD DISP=SHR,DSN=Interest Batch HLQ.CAMRPNL1
//INT1MSGL DD DISP=SHR,DSN=Interest Batch HLQ.CAMRMSG0
//INT1PROF DD DISP=SHR,DSN=Interest Batch HLQ.PROFLIB
//INT1CLIB DD DISP=SHR,DSN=Interest Batch HLQ.CAMRSRC
//INT1CLOG DD SYSOUT=*
//INT1REPT DD SYSOUT=*
//STEPLIB DD DISP=SHR,DSN=Application Load Library
//SYSPRINT DD SYSOUT=*
//SYSMDUMP DD  DSN=YOUR.DSNAME.DUMP.DATA.SET,
//             DISP=(MOD,CATLG,CATLG),              
//             SPACE=(CYL,(500,500),RLSE),          
//             DCB=(RECFM=FBS,LRECL=4160,BLKSIZE=24960)
//CAMRDBUG DD DISP=(NEW,CATLG,DELETE),VOL=SER=XXXXX,
//         DCB=(RECFM=FB,LRECL=278,BLKSIZE=27800),
//         SPACE=(CYL,(100,100),RLSE)
//         DSN=YOUR.DSNAME.CAMRDBUG.DATA.SET

Reference the INTERTEST AND SYMDUMP 11.0 manual for more information on the EXECUTION CONTROL Panel  and the Batch Link Facility described above.