The ATF data sets

IBM® Software Support might request that you send the ATF data sets for problem analysis. When you send ATF data sets to IBM Software Support, ensure that you send the complete set of data sets, including the Trace Repository and the staging and offload data sets.

The ATF trace repository uses the following data set naming convention.

RTE_VSAM_HILEV.RTE_NAME.imsid.I2ATFTRC

where imsid represents the IMS system you are monitoring and RTE_VSAM_HILEV and RTE_NAME are parameters in RKANPARU member KOICFGmp.

The application trace staging and offload data sets that the z/OS® System Logger uses are VSAM linear data sets. You provide log stream parameters when you use PARMGEN to configure OMEGAMON® for IMS on z/OS. You then must run post-configuration jobs to create the log streams. The staging and offload data sets follow these naming conventions

EHLQ.rtename.imsid.tt.ssssssss
EHLQ.rtename.imsid.tt.cnnnnnnn

where

EHLQ

Is the value assigned to the KI2_LOGR_EHLQ parameter in PARMGEN.

rtename

Is the RTE_NAME parameter.

imsid

Four-character name of the IMS system that is being monitored.

tt

Type of trace data that is stored in the log stream.

SM: Application history summary data.
DL: Application history detail data.
SX: Application history exception summary data.
DX: Application history exception detail data.

ssssssss

Is the sysplex name, which is assigned by the z/OS System Logger to the staging data set. If you use staging data sets with Coupling Facility (CF) structured-based log streams, then this is the system name.

cnnnnnnn

Is a sequence number, which is assigned by the z/OS System Logger to the offload data sets.

Note that rtename.imsid.tt is the name of the log stream. The log stream names are specified in member KI2ATFxx of RKANPARU.

For more information about the z/OS System Logger, refer to z/OS MVS™ Setting Up a Sysplex.

When you send files to IBM Software Support, REPRO the files and then terse them. The following example depicts a sample JCL to REPRO and terse the ATFTRC file:

//IDCAMS   EXEC PGM=IDCAMS,REGION=512K                           
//SYSPRINT DD  SYSOUT=*                                          
//ATFIN001 DD  DISP=SHR,DSN=vshilev.vsmilev.imsid.I2ATFTRC    
//ATFOUT01 DD  DSN=i2atftrc.repro,           
//             SPACE=(CYL,(20,5),RLSE),                          
//             DCB=(RECFM=V,LRECL=32756,BLKSIZE=32760),          
//             UNIT=3390,                                        
//             DISP=(NEW,CATLG,DELETE)                           
//SYSIN    DD  *                                                 
 REPRO INFILE(ATFIN001) -                                        
       OUTFILE(ATFOUT01)                                         
/*   
//TERSEC1  EXEC PGM=TRSMAIN,PARM=PACK                     
//SYSPRINT DD   SYSOUT=*                                  
//INFILE   DD   DISP=SHR,DSN=i2atftrc.repro   
//OUTFILE  DD   DISP=(NEW,CATLG,DELETE),                  
//       DSN=i2atftrc.repro.terse,            
//       UNIT=SYSDA,       
//       SPACE=(CYL,(10,1),RLSE)                       
//