Collecting diagnostic information with PDCOLLECT

For Configuration Manager RTE, 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.
      The Welcome screen for the z/OS Installation and Configuration Tools is displayed.
    2. Specify the RTE_PLIB_HILEV and RTE_NAME that points 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 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