Problem determination data collection (PDCOLLECT)

Use the PDCOLLECT utility to collect diagnostic information.

Before you begin

To use the Problem Determination Data Collection (PDCOLLECT) utility, you must install SDSF and be licensed to use it. If you do not have SDSF, you can copy the complete address space logs, including the JES output, RKLVLOG, RKPDOUT, RKPDLOG, SYSPRINT, and so on, into a data set. The DCB information for the output data set can be:

Organization: PS  
Record format: VB 
Record length: 240
Block size: 27998

About this task

The Configuration Manager PDCOLLECT utility action collects data that includes the following:

  • System configuration
  • Network information
  • Self-describing agent (SDA) information
  • Configuration Manager-related information (RTEDEF and EMBEDS data sets)
  • Run Time Environment (RTE) data sets
  • Output from the specified job
Note: This feature is available with APAR OA62230 (PTF UJ06864).

Procedure

  1. Locate the sample JCL job in the SMP/E target library tHilev.TKANSAM(KFJMAINT).
  2. Specify the following parameters in the KCIVARS DD statement:
    1. Use ACTION PDCOLLECT.
    2. Specify the RTE_PLIB_HILEV and RTE_NAME parameters that will point to the required RTEDEF data set.
    3. If the OMEGAMON address space logs are in the SDSF output queue, specify the KFJ_PDCOL_JOB_NAME and KFJ_PDCOL_JOB_ID parameters.
    4. If your OMEGAMON address space logs were copied to a sequential data set, replace the KFJ_PDCOL_JOB_NAME and KFJ_PDCOL_JOB_ID parameters with the KFJ_PDCOL_JOB_OUTPUT parameter, and specify the data set name.
  3. Submit the updated JCL.

Results

The file &SYSUID.KCIPDCOL.PDCOLPDS.TRS is generated. You can FTP the output data set to the IBM Support Center.

If you have to redirect your results to a different high-level qualifier, specify the KFJ_PDCOL_HLQ parameter in KCIVARS DD statement.

Example

//UID#ZMCM JOB ,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID 
/*JOBPARM SYSAFF=<lpar>                                                    
//S1 EXEC PGM=KCIOMEGA,REGION=0M,DYNAMNBR=256   
//STEPLIB DD DISP=SHR,DSN=<tlib_hlq>.TKANMOD   
//KCIFLOW DD DISP=SHR,DSN=<tlib_hlq>.TKANCUS(KFJMAINT) 
//KCIVARS DD *                      
ACTION                 PDCOLLECT    
RTE_NAME               RTEZOS1                   
RTE_PLIB_HILEV         TSOUID.MONSUITE 

* For PDCOLLECT: following parameters are required                          

KFJ_PDCOL_JOB_NAME     OMEGDS  
KFJ_PDCOL_JOB_ID       S654321