Understanding the CA APCDOC DELTA option and CA JCLCHECK.

Document ID : KB000014131
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

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

Question:

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

Answer:

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 CA APCDOC database using CA JCLCHECK, you use the DOCSCAN APCDOC utility which invokes CA JCLCHECK to do the work.  So you need the CA JCLCHECK load library in the STEPLIB or the LNKLST in addition to the CA 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