Understanding the APCDOC DELTA option and JCLCHECK.

Products

• APCDOC Automated Job Documentation

Issue/Introduction

Using APCDOC and JCLCHECK with the DELTA option. This can be confusing at times and this document is intended to assist in clearing any possible confusion. 

Can you explain the APCDOC / JCLCHECK DELTA option in more detail?

Environment

Release: APCDOC00200-1.3-APCDOC-Automated Job Documentation
Component:

Resolution

DELTA is used to limit the processing to only update the APCDOC database if a job has been updated.  The ISPF stats from the PDS directory is used to determine the date of the last update of the job.  If there are no ISPF stats for a member, APCDOC will always tell JCLCHECK to process the job and the APCDOC database is updated. The member name must be the same name as the job name for the Delta option to work.

DIRUPD is used to tell APCDOC to update the ISPF stats when there are no ISPF stats for a member.  The userid will be “APCDOC” when APCDOC updates the ISPF stats.

NOTE***  Never use DIRUPD with an Endevor library

To populate information into the APCDOC database using JCLCHECK, you use the DOCSCAN APCDOC utility which invokes JCLCHECK to do the work.  So you need the JCLCHECK load library in the STEPLIB or the LNKLST in addition to the APCDOC steplib.  The jobs to scan (or process) will be in the //SYSIN library. 

Sample JCL:

//DOCSCAN  EXEC PGM=DOCSCAN,PARM='OPTIONS(SCANOPTS)'                   
//STEPLIB  DD DISP=SHR,DSN=your APCDOC.SU13.W9909.CAILIB
//         DD DISP=SHR,DSN=your JCLCHK CAILIB  
//SYSIN    DD DISP=SHR,DSN=your JCLCHECK JOBLIB  <- The Jobs to load   
//SYSPROC  DD DISP=SHR,DSN=SYS1.PROCLIB                  
//SYSOUT   DD SYSOUT=*                                   
//SYSPRINT DD SYSOUT=*                                   
//SCANOPTS DD *                                          
  PDS DBHLQ(APCDOC.SU13.W9909) ACTION
  DICT(UPDATE)  XREFALL IMS DELTA DIRUPD 

DOCSCAN is used to get information into an APCDOC database and here is an example to get an APCDOC report:

//DOCREPT  EXEC PGM=DOCRPT                                 
//STEPLIB  DD  DISP=SHR,DSN=your APCDoc.SU13.W9909.CAILIB
//MESSAGE   DD SYSOUT=*                                    
//SYSPRINT  DD SYSOUT=*                                    
//PARMIN    DD *                                           
 RPT(XJOB) SYSTEM(*) JOB(IMSTEST6) INPGM                   
 DBHLQ(APCDOC.SU13.W9909)         

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Additional Information

Please review the CA APCDOC SYSTEM PROGRAMMER GUIDE