How to produce a Data set cross reference report on a JCL library

Products

• JCLCheck Workload Automation

Issue/Introduction

I need to create a DSNXREF Summary report (REPORT 7 only) on a JCL library with almost 14,000 members in it.  

Environment

Release : 12.0

Component : JCLCheck Workload Automation

Resolution

Use the newly enhanced cross-reference reports that are introduced by PTF SO06235 + SO06236.  Here's how:

1. Run a JCLCheck job using the new runtime option UPDTDD or UPDTDSN to create a cross-reference file.  Sample JCL:

//RUNJCK   EXEC PGM=JCLCHECK,PARM='O(OPTS)',TIME=1439,REGION=200M     
//SYSPRINT DD  SYSOUT=*                                               
//SYSOUT   DD  SYSOUT=*                                               
//UPDTDD   DD  DSN=HLQ.UPDTDD.FILE,DISP=(,CATLG,DELETE),           
//         DCB=(RECFM=FB,LRECL=1024),UNIT=SYSDA,                      
//         SPACE=(CYL,(10,5),RLSE)                 << CHANGE SPACE ALLOC   
//SYSIN    DD  DISP=SHR,DSN=YOUR.JCL14000.LIB      << CHANGE LIB NAME                
//OPTS     DD  *                                                      
 PDS AU NOJOB NOLIST NOSXREF XREF PXREF PROCXREF        
 UPDTDD(UPDTDD)    

 

2. Run job to produce a cross-reference report of the above UPDTDD file.  

These sample jobs are found in the CAZ2JCL library:

CAZ2JCL(AJ6XRDEL)   Remove specific jobs from the XREF that are no      
                    longer needed.                                      
CAZ2JCL(AJ6XRDS1)   Dataset Cross Reference report, 1 line per          
                    reference, record length 180.                       
CAZ2JCL(AJ6XRDS2)   Dataset Cross Reference report, 2 lines per         
                    reference, record length 121.                       
CAZ2JCL(AJ6XRDS3)   Dataset Cross Reference report, 2 lines per         
                    reference, record length 80.                        
CAZ2JCL(AJ6XRPG1)   Program Cross Reference report, 1 line per          
                    reference, record length 121.                       
CAZ2JCL(AJ6XRPG2)   Program Cross Reference report, 1 line per          
                    reference, record length 80.                        
CAZ2JCL(AJ6XRPG3)   Program Cross Reference report LMOD only, 1 line    
                    per reference, record length 121.                   
CAZ2JCL(AJ6XRPG4)   Program Cross Reference report PSB/DBD ONLY, 1 line 
                    per reference, record length 121.                   
CAZ2JCL(AJ6XRPR1)   Procedure Cross Reference report, 1 line per        
                    reference, record length 121.                       
CAZ2JCL(AJ6XRPR2)   Procedure Cross Reference report, 1 line per        
                    reference, record length 80.                        
CAZ2JCL(AJ6XRPR3)   Procedure Cross Reference report PROCs only, 1 line 
                    per reference, record length 121.                   
CAZ2JCL(AJ6XRPR4)   Procedure Cross Reference report INCLs only, 1 line 
                    per reference, record length 121.                   

Additional Information

- Option UPDTDD/UPDTDSN are documented here: 

UPDTDD

- Option NORUNT may be used to improve performance.