Source Directory File Formats

The source directory can exist in two file formats: monolithic and cluster (not to be confused with an SSI cluster). The monolithic format consists of a single CMS sequential file that contains all of the directory statements. The cluster format consists of an index file that points to one or more definition files that contain all of the directory statements. The index file consists only of LOAD statements that point to the definition file(s). A definition file can be a separate part file that contains one of the following:
  • DIRECTORY statement(s)
  • A global definitions entry
  • A profile entry
  • A user entry
  • An identity entry
  • A subconfiguration entry

A definition file could also be a cluster file that contains multiple items from the above list. For details on how to create separate part files or cluster files, see LOAD Directory Statement.

A single cluster format source directory can be made up of an index file and a mixture of separate part definition files and cluster definition files.

Regardless of the file form used for the source directory, the user directory must be processed in the following order:
DIRECTORY statement(s)
Which consists of one or more DIRECTORY statements that define the output object directories.
Global definition entry
Which must begin with the GLOBALDEFS directory statement. The entry also includes directory statements that define global settings to be used by all virtual machine definitions.
Profile entries
Each of which begins with a PROFILE directory statement and consolidates other directory statements that are used in common by many virtual machine definitions.
User, identity, and subconfiguration entries
Each of which begins with a USER, IDENTITY, or SUBCONFIG directory statement. USER begins the entry for an single-configuration virtual machine definition. IDENTITY begins the entry for a multiconfiguration virtual machine definition and includes statements common to virtual machine configurations in that definition. SUBCONFIG begins the entry for a set of directory statements in a multiconfiguration virtual machine definition that is specific for a member of an SSI cluster.
There are rules about the placement of directory statements within an entry. For details on these rules, refer to the individual statement descriptions in this section and to Table 1.