Summary of Directory Statements

Table 1 describes the directory statements. It shows where the statement is described, the statement category, and a brief summary of the statement's function. Although the directory statements are listed in alphabetic order, this is not the order in which they can be coded in the directory.

Table 1. Summary of User Directory Statements
Statement Category Function Location
ACCOUNT General (2) Defines the account numbers to which a virtual machine charges its costs. It also defines a distribution code. ACCOUNT Directory Statement
ACIGROUP General (2) Specifies the name of a group to which an individual user ID is assigned. ACIGROUP Directory Statement
APPCPASS General (2) Allows a virtual machine to request an APPC/VM path without supplying security parameters, even when the equivalent of SECURITY (PGM) is indicated on the APPCVM CONNECT request. APPCPASS Directory Statement
AUTOLOG General (2) A synonym for XAUTOLOG. See XAUTOLOG XAUTOLOG Directory Statement. AUTOLOG Directory Statement
BUILD Control Used for the SSI environment; specifies a system name and subconfiguration entry, which in turn specifies the SSI member-specific configuration for a multiconfiguration virtual machine instance. BUILD Directory Statement
CLASS General (2) Specifies the privilege class (or classes) assigned to an individual user. CLASS Directory Statement
COMMAND General (1) Specifies a command to be executed after the virtual machine is logged on, and before the virtual machine is IPLed. COMMAND Directory Statement
CONSOLE Device (1) Defines a virtual machine operator's console. CONSOLE Directory Statement
CPU General (2) Specifies a virtual processor that is to be defined automatically when the user logs on to the system. CPU Directory Statement
CRYPTO General (1) Authorizes the user to define virtual cryptographic facilities and provides the guest access to the crypto domains on the cryptographic cards. CRYPTO Directory Statement
DASDOPT Device (1) An extension to the DEDICATE, LINK, and MDISK statements. DASDOPT Directory Statement
DATEFORMAT General (1) Specifies a user's default date format for commands that provide multiple date formats. DATEFORMAT Directory Statement
DEDICATE Device (1) Specifies that a real device is to be used solely by the virtual machine, or that a real tape device is to be shared with other users. DEDICATE Directory Statement
DIRECTORY Control Defines the device on which the directory resides and must be the first statement in the directory. DIRECTORY Directory Statement
D8ONECMD General (2) Defines whether a virtual machine can issue multiple CP commands with DIAGNOSE code X'08'. D8ONECMD Directory Statement
GLOBALDEFS Control Signifies the beginning of the global entry. GLOBALDEFS Directory Statement
GLOBALOPTS Global Used to define global settings to be used while processing virtual machine definitions. GLOBALOPTS Directory Statement
IDENTITY Control Used for the single system image environment:
  1. Starts a multiconfiguration virtual machine definition
  2. Defines the multiconfiguration virtual machine's logon identification (user ID) and password
  3. Defines the multiconfiguration virtual machine's storage size
  4. Defines the multiconfiguration virtual machine's CP command privilege classes.
IDENTITY Directory Statement
INCLUDE Control Specifies the name of a profile entry to be invoked as part of the user entry. INCLUDE Directory Statement
IOPRIORITY General (2) Defines a virtual machine's I/O priority queueing range. IOPRIORITY Directory Statement
IPL General (1) Designates a device number or named saved system that CP automatically loads (IPLs) when the user logs on to the system. IPL Directory Statement
IUCV General (2) Authorizes a virtual machine to create an IUCV communication path with another virtual machine. IUCV Directory Statement
LINK Device (1) Accesses another virtual machine's minidisk. LINK Directory Statement
LOAD Control Specifies where the directory entry is to be found. The LOAD statement is valid only in a cluster file format directory. LOAD Directory Statement
LOADDEV General (1) Identifies the location of a program to be loaded as a result of a list-directed IPL. Parameters to be passsed to the program can also be defined. LOADDEV Directory Statement
LOGONBY General (2) Designates up to eight user IDs that can use their own passwords to logon to and use a virtual machine. LOGONBY Directory Statement
MACHINE General (2) Defines the virtual machine mode (ESA, XA, XC, or Z) and the number of virtual processors a virtual machine can define. MACHINE Directory Statement
MAXSTORAGE General (1) Specifies the virtual storage size for a user. MAXSTORAGE Directory Statement
MDISK Device (2) Defines virtual disks (minidisks): permanent minidisks, temporary minidisks, and virtual disks in storage. MDISK Directory Statement
MINIOPT Device (2) An extension to MDISK used when defining non-full-pack minidisks. MINIOPT Directory Statement
NAMESAVE General (2) Authorizes a virtual machine to access a restricted named saved system or saved segment and authorizes the virtual machine to obtain an exclusive writeable copy of a saved segment. NAMESAVE Directory Statement
NICDEF Device (1) Defines virtual network adapters that are fully simulated by CP. NICDEF Directory Statement
NOPDATA General (2) Authorizes a virtual machine to use NOP CCWs to transfer data to CP spool files. NOPDATA Directory Statement
OPTION General (1, 2) Defines certain options available to the virtual machine. OPTION Directory Statement
POOL Control Allows a set of virtual machines to be defined with the same configuration or characteristics. POOL Directory Statement
POSIXGLIST General (2) Specifies all POSIX groups of which the user is a member. POSIXGLIST Directory Statement
POSIXGROUP Global Defines a POSIX group. POSIXGROUP Directory Statement
POSIXINFO General (2) Specifies a user's POSIX information. POSIXINFO Directory Statement
POSIXOPT General (2) Specifies option settings related to a user's POSIX capabilities. POSIXOPT Directory Statement
PROFILE Control Defines the start of a profile entry. PROFILE Directory Statement
SCREEN General (1) Defines the extended color and extended highlighting options for the virtual machine console. SCREEN Directory Statement
SHARE General (1) Specifies a virtual machine's scheduler share. SHARE Directory Statement
SPECIAL Device (1) Defines virtual displays, communication lines, and channel-to-channel adapters that can or cannot be connected to real devices when the user logs on. SPECIAL Directory Statement
SPOOL Device (1) Defines virtual unit record devices (spooling devices). SPOOL Directory Statement
SPOOLFILE General (1) Describes virtual machine spool file characteristics. SPOOLFILE Directory Statement
STDEVOPT General (2) Specifies the optional storage device management functions available to the virtual machine. STDEVOPT Directory Statement
STORAGE General (1) Specifies the virtual storage size for a user. STORAGE Directory Statement
SUBCONFIG Control Used in the single system image environment; begins the entry for an SSI member-specific configuration for a multiconfiguration virtual machine instance. SUBCONFIG Directory Statement
SYSAFFIN Control Defines how, and to which systems of a multiple-system complex, the subsequent statements apply. SYSAFFIN Directory Statement
USER Control
  1. Starts the entry for a single-configuration virtual machine definition
  2. Defines the virtual machine's logon identification (user ID) and password
  3. Defines the virtual machine's storage size
  4. Defines the virtual machine's CP command privilege classes.
USER Directory Statement
VMRELOCATE General (2) Controls relocation capability of specified user. VMRELOCATE Directory Statement
XAUTOLOG General (2) Designates user IDs that can enter an XAUTOLOG command for the virtual machine. XAUTOLOG Directory Statement
XCONFIG General (1) Specifies control parameters for the extended-configuration facilities provided in the ESA/XC and z/XC virtual machine architectures: access lists and data spaces. XCONFIG Directory Statement
Blank Line   Can appear anywhere in the directory control file. When the DIRECTXA utility processes the directory control file, it ignores blank lines.  
Asterisk (*)   Any line in the source directory file that begins with an asterisk (*) is a comment. When the DIRECTXA utility processes the directory control file, it ignores comment statements.