%%LIBSYM and %%MEMSYM

Control statements %%LIBSYM and %%MEMSYM define a library and a member that contain a set of user-defined variables and their assigned values. The member is read by Control-M before submission, and its content is added to the user-defined variable environment of the job.

It is possible to specify more than one %%LIBSYM or %%MEMSYM statement for one job. Each statement is added to or deleted from the user-defined variable environment of the specific job.

If Control-M fails to access the variable member (member not found, security constraints, and so on), the job is not submitted and a warning message is issued to the user who requested the job.

The format of the statement is:

%%LIBSYM libname %%MEMSYM [-]memname

where:

• libname – Valid data set name of 1 through 44 characters. It must be a cataloged partitioned data set (library) with a record length of 80.
• memname – Valid member name of 1 through 8 characters.

When a minus sign (-) is specified before memname, the purpose of the %%LIBSYM/%%MEMSYM statement is to cancel the effect of the previously processed %%LIBSYM libname %%MEMSYM memname statement with the same member name, thereby reverting the values of the AutoEdit variables that are defined in the LIBSYM/MEMSYM member to the values that were in effect prior to the previous %%LIBSYM libname %%MEMSYM memname statement. This, in effect, provides the capability of creating local auto-edit variables, whose scope is restricted to specified range(s) of the job run stream.