Directory Program
If you execute the Directory program under VM/370, the newly created
directory is dynamically swapped, and placed in use by VM/370 (provided
that you have class A, B, or C and that the directory you updated is the
one that is currently in use by the system). If you do not have the
proper privilege class, the directory is updated on the directory volume
but not dynamically swapped, so the change will not go into effect until
the next time the system is loaded (via IPL). The format of the DIRECT
command is:
r , , t , L
DIRECT
r ,filename L
r Ifiletype IQIRECT L
r ", I filemode I I I I * III L ...... [ (EDIT) ]
filename [filetype [filemode]]
(EDIT)
is the identification of the file containing the control
statements for the Directory program. If no filename and
filetype are given, the program defaults to a file named USER DIRECT; otherwise, it looks for the file named. The filetype
must be DIRECT. If only filename is given, filetype defaults
to DIRECT. The filemode defaults to * if not specified.
specifies that the directory is to be examined, but not
changed. Under eMS, the DIRECT command loads the directory creation module.
The first statement encountered must be a DIRECTORY statement. If not
found, or another DIRECTORY statement is found, the program terminates. A syntax error in any statement generates an error message, and the
directory is not updated. If no critical errors are encountered, the
remaining statements are checked for syntax.
If the Directory program abnormally terminates, the old directory is
not altered. Normal completion places the directory in use by VM/370. After the new directory is created, it can be printed by issuing the CMS command PRINT USER DIRECT or PRINT filename DIRECT.
The DIRECT command filename and filetype default to a CMS file
identification of USER DIRECT. The filemode defaults to * if not
specified. Any or all of the defaults can be overridden by the command
line. The EDIT option allows you to run the program without updating
the directory on disk. This enables you to check the syntax of the
directory statements without accessing the directory disk. INVOKING DIRECTORY AS A STANDALONE PROGRAM Standalone operation in a virtual machine is the same as eMS operation,
with this exception: after IPL, the program asks you for the virtual
card reader address. If you enter a null line, the IPL device address
is the default of OOC. Part 2. Defining Your VM/370 System 199

Directory Program DIRECTORY CONTROL STATEMENTS The control statements should be in the following formats, with one or
more blanks as operand delimiters. All operands are positional from
left to right. If any operands are omitted, all rema1n1ng operands in
that statement must be omitted, with the exception of the OPTION statement. Its entries are self-defining and not positional. Only columns 1 through 71 are inspected by the program. All data
after the last possible operand on any card is ignored. Also, blank
cards and cards having an asterisk (*) as the first operand are ignored.
If any input card is found to be in error, the program continues to
process the control statements, validating all control statements before
terminating. If the directory runs out of space, the program terminates
immediately. After an abnormal termination (or, for CMS, the EDIT run) ,
the old directory is not altered, and the new directory is not saved.
The DIRECTORY control statement
directory is allocated. It must be
the DIRECTORY control statement is:
defines the device
the first statement.
on which the
The format of
r , DIRectory cuu devtype volser
cuu devtype volser
is the address of the device that is to contain the directory
and is specified in three hexadecimal digits.
is four decimal digits that represent a supported device type
suitable for the VK/370 directory (231q, 2319, 2305, 3330, 33QO or 3350). For a 3350 device in native mode, specify 3350 as the device type. For a 3350 used in 3330 compatibility
mode, specify 3330. Specify a 33QQ disk as a 33QO, and a 3333
as a 3330. 3330V (virtual 3330) volumes associated with 3850 Mass storage System cannot be specified as the residence device for
the VM/370 directory.
is the volume serial number of the directory volume (1 to 6
alphameric characters).
The USER control statement defines a virtual machine and creates a VM/3 7 0 directory entry. It delimits the directory entry for one user. A
separate USER statement must be prepared for each directory entry
required. The format of the USER control statement is:
r I r r r r
" " 1 User userid pass (stor [mstor [cl [pri lIe lId Icd les 1111]]]] I ION ION ION tON 1111 I 10FF lOFF 10FF 10FF 1111 I L L L L .J .... .I L- 200 IBM VM/370 Planning and System Generation Guide