/JCL Command

The /JCL command adds, updates, or deletes a JCL statement referenced by a symbolic index.

Note: The /JCL command can manipulate the PRMLIB data sets because these data sets are considered "JCL" libraries. PARM data members can occupy the same libraries as JCL members because the data is 80-byte records in a PDS.

Changes made to JCL statements with the /JCL command are stored in the CA Workload Automation SE database and remain in effect when CA Workload Automation SE is reinitialized if JCLDEFS=VSAM is specified on the RESIDENT statement in the initialization file.

Note:

For more information about using symbolic indexes to refer to JCL data sets, see the Systems Programming Guide.
Any changes to JCL library definitions are LOST when CA Workload Automation SE is recycled unless JCLDEFS=VSAM is specified on the RESIDENT statement in the initialization file. See the discussion of this keyword on the RESIDENT statement in the Systems Programming Guide.

This command has the following format:

►►─ /JCL ─ ,OPT= ─┬─ ADD ─┬,INDEX=jcllib ─ ,DSN=dsname ───────────────────────►
                  ├─ UPD ─┤
                  └─ DEL ─┘

 ►─┬──────────────────────┬─┬────────────────────────┬────────────────────────►
   └─ ,ALT= ─┬─ nnn ────┬─┘ └─ ,DPROC= ─┬─ dsname ─┬─┘
             ├─ xx...x ─┤               ├─ NO ─────┤
             └─ NO ─────┘               └─ *NONE* ─┘

 ►─┬──────────────────────────┬───────────────────────────────────────────────►◄
   └─ ,LTERM= ─┬─ MASTER ◄ ─┬─┘
               └─ xxxxxxxx ─┘

OPT

Specifies the type of JCL statement change to be performed.

ADD: Specifies to add a symbolic JCL data statement reference.
UPD: Specifies to update a symbolic JCL data statement reference.
DEL: Specifies to delete a symbolic JCL data statement reference.

INDEX

Defines the symbolic index associated with the JCL statement. A symbolic index is referred to as a JCLLIB on the DB.1 panel. A symbolic index consists of an ampersand (&) followed by up to 15 alphanumeric characters. Symbolic value &HELP is reserved for the HELP data set.

DSN

Defines the fully qualified name of a data set containing execution JCL to be submitted by CA Workload Automation SE. The data set must be a PDS. A data set name cannot be specified with OPT=DEL.

Note: JCL libraries added with the /JCL command are automatically assigned an attribute of DYN=2.

TSO packed data is not supported.

ALT

(Optional) Specifies JCL library destination.

nnn

xx...x

Defines the INDEX value from a previously defined JCL library that is searched prior to this one. This works exactly like DD statement concatenation where the ALT is first in the sequence, but is supported for only one level. Since validation of this parameter is done while the internal table of JCL libraries is being built, the alternate library must be defined in the initialization file prior to the statement that references it as an alternate. ALT and INDEX values cannot be equal in any one JCL statement. For a discussion of how this option can be used, see Alternate JCL Libraries in the Database Maintenance Guide. ALT is optional.

NO

Specifies that an ALT destination is to be removed from an existing JCL library destination, as in the following:

/JCL,INDEX=index,OPT=UPD,ALT=NO

DPROC

(Optional) Specifies CA Driver JCL libraries.

dsname

Defines the name of the PDS that is to be concatenated above the libraries in the CARPROC DD allocation whenever CA Driver is invoked for JCL in the associated JCL library.

NO

Specifies that a DPROC association is to be removed from an existing definition, as in the following:

/JCL,INDEX=index,OPT=UPD,DPROC=NO

*NONE*

Specifies that CA Driver is not to be invoked for JCL using this INDEX.

LTERM

(Optional) Specifies the logical terminal to which prompt messages should be routed for jobs using JCL from this library. The default is MASTER.

Note: For more information about the the LTERM keyword or the JCL initialization file statement, see the Systems Programming Guide.