Directory Program
The Directory Program
The directory program can be run under CMS (using the DIRECT
command) or standalone. The standalone version of the directory program
is provided in object deck form (a three card loader, followed by the DMKDIR text deck), and may be loaded directly from either a real or
virtual card reader.
If you run the directory program under CMS, input records must be in
a CMS file with a default fileid of "USER DIRECT". The DIRECT command
loads the directory creation module. If no filename is specified, the
program looks for a file named USER DIRECT. Otherwise, it looks for a
file named filename DIRECT.
If the file is not found, or if an error occurs during processing, the directory is not created and the old directory remains unaltered. Normal completion writes the DASD address of the new VM/370 directory
in the VOLl label, and if it is updating the active system directory, it
places the new directory in use by VM/370. You can print the new
directory by issuing the CMS command PRINT USER DIRECT (or PRINT filename DIRECT).
The virtual machine executing the directory program must have write
access to the volume to contain the new directory. If you create a
directory that is to be written on the active VM/370 system residence
volume, your virtual machine's current directory entry must have write
access to the volume containing the current VM/370 directory. Assume that you have the following virtual machine for online
directory modification. USER UPDRCT PASSWORD 256K 1M ABC ACCOUNT NUMBER BIN2 IPL CONSOLE 009 3215 SPOOL C 2540 READER A SPOOL D 2540 PUNCH A SPOOL E 1403 A
LINK CMSSYS 190 190 R MDISK 330 3330 o 404 SYSRES MDISK 331 3330 o 404 SYSWRK MDISK 230 2314 o 203 UDISK 1 MDISK 231 2314 o 203 UDISK2 MDISK 232 2314 o 203 BATCH1 MDISK 233 2314 o 203 BATCH2 MDISK 191 3330 26 0110 VMDSK2 WR RPASS WPASS WR RPASS WPASS RR RPASS WPASS RR RPASS WPASS RR RPASS WPASS RR RPASS WPASS WR RPASS WPASS Using the CMS EDIT command and its subcommands, you can create or
modify a card-image file of the VM/370 directory input. When you are
ready to write a new directory, issue the command:
DIRECT filename
where filename is a CMS file (normally named USER) with filetype DIRECT
containing the necessary Directory program control statements. The
DIRECT command puts this file into the form of a directory, and replaces
the old directory with this new one. Part 2. Defining Your VM/370 System 197

Directory Program Loading the DMKDIR object deck via the card reader is the same as
issuing the DIRECT command in CMS, except that after IPL, the program
asks you for the address of a card reader containing the Directory
program control Once the directory is updated, directory changes for a user currently
logged on to the system do not take effect until the user logs off the
system and then logs back on. When a new directory is written for a new system
the new directory does not take effect until the new
volume is loaded (via IPL). INVOKING THE DIRECTORY PROGRAM (DMKDIR) UNDER CMS residence volume,
system residence The iM/370 Directory vI virtual machine in the VM/370 directory. Each virtual machine
confiquration includes counterparts of the components found in a real System/370: a virtual operator's console, virtual storage, and virtual I/O devices and control units.
The same version of the Directory service program deck can be placed
in the card reader and loaded directly, or run in a virtual machine
under CMS. The CMS file named DIRECT can be updated with the CMS Editor to
incluae additional directory entries. Use the CMS DIRECT command to process any file to see if it follows the
required directory format. To actually change or swap the currently
active VM/370 directory, you must have both of the following:
1. User class A, B, or C.
2. write access to the system-owned (system residence or IPL device)
volume that contains the current directory up to and including the
directory cylinders, or to the volume that is to contain the new
directory.
If you have the above qualifications and wish verify that a CMS file can be used as a directory file, you must use the EDIT option;
otherwise, if there are no control statement errors, the file is put
into active use.
To build a VM/370 directory on a CP-owned volume using preallocated
cylinders, a new directory should be built so as not to overlay an
existing directory. You must, therefore, allow space for two
directories, or allocate a new area for the VM/370 directory each time
it is created. 1°8 IBM VM/370 Planning and System Generation Guide