%%INCLIB and %%INCMEM

%%INCLIB and %%INCMEM statements contain two elements that together describe the member that is to be included in the current job stream, as follows:

• The %%INCLIB part of the statement defines the location of the member as one of the following:
  • the library name
  • the DD name to be associated with a library or concatenation of libraries
• The %%INCMEM part of the statement defines the member.

These statements are useful for inserting the following types of information into the JCL:

• JCL statements and parameters to be passed to the JCL (for example, sysin)
• AutoEdit control statements, including other %%INCLIB and %%INCMEM statements

The format of the statement is:

%%INCLIB { libname | DDNAME=ddname } %%INCMEM memname

In this statement

• libname is a valid data set name, from 1 through 44 characters in length, of a cataloged partitioned data set (library) with a record length of 80
• ddname is a valid DD name from 1 through 8 characters in length that points to a cataloged library or concatenation of cataloged libraries
  This DD name must be preallocated to the environment in which the %%INCLIB statement is to be resolved, such as the Control-M monitor or the IOA online logon procedures.
• memname is a valid member name from 1 through 8 characters in length

You can specify multiple %%INCLIB and %%INCMEM statements in a job.

More than one job may contain identical %%INCLIB and %%INCMEM statements, permitting maintenance of common, standardized code.

The %%INCMEM member is read by the Control-M monitor just before job submission, and the contents of the member are submitted as part of the current job. As a result

• a member created by one job in the job stream can be used by a later job in the job stream
• if a job in the job stream updates a member and the member is subsequently used by a later job in the job stream, the later job accesses the updated member

If the %%INCLIB statement is resolved within the JCL, ensure that there are no unnecessary blank lines in the %%INCMEM member.

If Control-M fails to access the included member (member not found, and so on), the job is not submitted and a warning message is issued.