Troubleshooting

This section describes the diagnostic procedures you can perform if you encounter problems using OPERTUNE.

Interpreting user abends

User abends issued by OPERTUNE are accompanied by messages that explain the error. The last three digits of the error message match the user abend issued. For example, U406 is accompanied by a BMC31406 message.

For a complete explanation of messages, see System-messages.

Producing a DUMP

If you encounter a problem using OPERTUNE and contact BMC Support, the representative might ask you to perform one or more of the diagnostic steps described below. These steps produce information that will help with problem diagnosis.

1. When necessary, you can take an SVC DUMP of an active OPERTUNE, subsystem, or TSO region.
   You may be asked to provide DUMP data for any or all of the following MVS address spaces:
   
   • Subsystem address space (SSAS)
   • Database address space (DBAS)
   • Inter-region lock manager (IRLM)
   • OPERTUNE started task
   • OPERTUNE TSO user
2. If the problem can be recreated, turn on the Db2 global trace before recreating it to assist with diagnosis. Issue the following command to Db2:
   -START TRACE(GLOBAL)
3. Before taking an SVC DUMP, ensure that an MVS DUMP data set is available. To check the status of MVS DUMP data sets, issue the following MVS command:
   DISPLAY DUMP,T 
   To take a DUMP while a region is active, issue the following MVS command:
   DUMP COMM=(OPERTUNE) 
   The following WTOR message appears in response to this command:
   ## IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND
   In response to this message, specify the DUMP parameters as follows:
   ##,JOBNAME=( regionJobName ),SDATA=(RGN,SUM,CSA,SQA),END 
   ## is the WTOR number and regionJobName is the name of the MVS region to DUMP (for example, DB2PDBM1).

4. If the OPERTUNE BMC Support representative asks you to ship the SVC DUMP to BMC, copy the SVC DUMP (unformatted) to tape or cartridge using IEBGENER.
   Specify the SYSUT2 data set with the following DCB attributes:   

   DCB=(RECFM=F,LRECL=4104,BLKSIZE=4104) - MVS/XA
   DCB=(RECFM=F,LRECL=4160,BLKSIZE=4160) - MVS/ESA or later

Using OPERTUNEdiagnostic tools

See Using-OPERTUNE-diagnostic-tools.