How to Use CA JCLCheck › Integrating Products › About External Variables › CA WA CA 7 Edition Parameters › CA WA CA 7 Edition Driver Procedures

CA WA CA 7 Edition Driver Procedures

Read this section if the JCL being resolved contains a reference to a Driver Procedure (DPROC).

If your site uses only the global DPROC library (CARPROC DD statement in the CA7ONL job), JCL with references to a DPROC contained in the global DPROC library are resolved.

If your site uses both global DPROCs and local DPROCs, CA WA CA 7 Edition looks for the DPROC referenced in the JCL in the local DPROC first. A local DPROC is associated with a specific JCLLIB. If the DPROC is not found, CA WA CA 7 Edition then looks in the global DPROC. The DPROC remains unresolved when it is not found in either location.

All JCLLIB information applies equally whether you specify SOURCE=I or you specify SOURCE=E and W_JCLLIB=. When you specify SOURCE=I, the JCLLIB containing the JCL of the job is probably already associated with the local DPROC library (unless your site uses only global DPROCs). However, when you specify SOURCE=E, do the following steps:

1. Associate the W_JCLLIB used with a local DPROC library.
2. Copy the actual DPROCs to the local DPROC library (unless the DPROC referenced in your JCL resides in the global DPROC library).

   This association and copy ensure that the DPROCS referenced in the JCL are resolved.

Example: Code JCL to Reference a Local and Global DPROC

This example shows how to refer to both a local (NMDPROCL) and global (NMDPROCG) DPROC:

//JOBCA7  JOB 
/*JOBPARM S=*
//*** comments and other JCL statements
//        NMDPROCG,DATA1=data,DATA2=data
//JS020   EXEC PGM=IEFBR14
//        NMDPROCL,PARM1=data,PARM2=data

Let us assume that this JCL is coming from a CA WA CA 7 Edition JCL library, &JCLLIB1. &JCLLIB1 has defined a local DPROC library (HLQ.DPROC.LOCAL) and member NMDPROCL resides in that library. In the global DPROC library, which is coded on the CARPROC DD statement in the CA7ONL job, we have many members. One of the members is NMDPROCG. When CA WA CA 7 Edition encounters the following statement, it looks in the local DPROC library (HLQ.DPROC.LOCAL) and does not find NMDPROCG.

//    NMDPROCG,DATA1=data,DATA2=data

CA WA CA 7 Edition then looks in the CARPROC DD data set and finds the member NMDPROCG, so CA WA CA 7 Edition resolves the statements.

As CA WA CA 7 Edition continues reading the JCL, the following statement is encountered:

//  NMDPROCL,PARM1=data,PARM2=data

CA WA CA 7 Edition looks for the member NMDPROCL in the local DPROC library (HLQ.DPROC.LOCAL) and finds the member, so CA WA CA 7 Edition resolves the JCL. CA WA CA 7 Edition does not look in the CARPROC DD because it already found the member.

Usage notes:

• To allocate a local DPROC library, code DPROC= on the JCL statement in the initialization file. For information about coding DPROC, see the CA WA CA 7 Edition Systems Programming Guide.
• If JCL definitions are stored in the CA WA CA 7 Edition VRM data set, associate a local DPROC library using the /JCL command. For information about the /JCL command, see the CA WA CA 7 Edition Command Reference Guide.