Using the INCLUDE Command

The LOAD command loads a TEXT file or member of a text library into virtual storage. The INCLUDE command loads additional TEXT files or members of a text library that make up your executable application.

The INCLUDE and LOAD commands have similar formats and option lists. The main difference is that if you issue two LOAD commands in succession, the second command replaces the first. The INCLUDE command, on the other hand, cannot be used unless you have just issued a LOAD. You can specify as many INCLUDE commands as necessary following the LOAD command to load files into storage. The files specified in the INCLUDE command must refer to subroutines. See Table 1 for a list of available options.

The syntax of the INCLUDE command is:

filename: Name of a file you want to include into storage.
options: List of INCLUDE options separated by blanks or commas (for a list of available options, see Table 1).
For more information about INCLUDE and its options, see the z/VM: CMS Commands and Utilities Reference.

The following example loads a TEXT file from the USERTXT text library and includes another TEXT file from another text library into the load module. A load map is also written.

GLOBAL TXTLIB SCEELKED USERTXT USERTXT2
LOAD PROGRAM1
INCLUDE PROGRAM2 (MAP