Pointing to External Members

In the previous steps, values for user-defined variables were provided in an external member pointed to by a %%LIBSYM / %%MEMSYM control statement. Actually, there are several ways to point to external members, as described in the following table:

Table 13 Pointing to External Members

AutoEdit Term	Description
%%LIBSYM %%MEMSYM	Includes the contents of the specified member at the location of the %%LIBSYM / %%MEMSYM control statement in the JCL. The member is read by Control-M before submission. The included member can only contain a list of AutoEdit variables and their values in the format: %%term=value This control statement is useful for providing lists of values to be used during job processing, when both the JCL and the job scheduling definition should not be updated.
%%INCLIB %%INCMEM	Includes the contents of the specified member at the location of the %%INCLIB / %%INCMEM statement in the JCL. The member is read by Control-M before submission. This statement is useful for inserting the following types of information into the JCL: JCL statements and/or parameters to be passed to the JCL (for example, SYSIN). AutoEdit control statements, including other %%INCLIB and %%INCMEM statements. Example of usage: If a long segment of JCL must be repeated at different points in the JCL, the segment can alternatively be placed in its own member, and an %%INCLIB / %%INCMEM control statement that points to the member can be specified at the required insertion points.
%%GLOBAL	Includes the contents of the specified member at the location of the %%GLOBAL control statement in the JCL. Like %%MEMSYM, the included member can only contain a list of AutoEdit variables and their values in the format: %%term=value Unlike the %%LIBSYM / %%MEMSYM control statement, %%GLOBAL identifies only the member name; it does not identify the library. The specified member is always taken from the library pointed to by DD statement DAGLOBAL.

AutoEdit Term

Description

%%LIBSYM
%%MEMSYM

Includes the contents of the specified member at the location of the %%LIBSYM / %%MEMSYM control statement in the JCL. The member is read by Control-M before submission.

The included member can only contain a list of AutoEdit variables and their values in the format:

%%term=value

This control statement is useful for providing lists of values to be used during job processing, when both the JCL and the job scheduling definition should not be updated.

%%INCLIB
%%INCMEM

Includes the contents of the specified member at the location of the %%INCLIB / %%INCMEM statement in the JCL. The member is read by Control-M before submission. This statement is useful for inserting the following types of information into the JCL:

JCL statements and/or parameters to be passed to the JCL (for example, SYSIN).
AutoEdit control statements, including other %%INCLIB and %%INCMEM statements.

Example of usage: If a long segment of JCL must be repeated at different points in the JCL, the segment can alternatively be placed in its own member, and an %%INCLIB / %%INCMEM control statement that points to the member can be specified at the required insertion points.

%%GLOBAL

Includes the contents of the specified member at the location of the %%GLOBAL control statement in the JCL.

Like %%MEMSYM, the included member can only contain a list of AutoEdit variables and their values in the format:

%%term=value

Unlike the %%LIBSYM / %%MEMSYM control statement, %%GLOBAL identifies only the member name; it does not identify the library. The specified member is always taken from the library pointed to by DD statement DAGLOBAL.

Parent Topic

Supplying Variable Values through an External Member