Notes
1 All of the user directory, user machine, and user device buffers that were used
are written. The buffers are written
out by loading the DASD address into
register 2, loading the buffer address
into register 1, and then branching and I linking to the V'JR!TE ioutine. 2 Th""""''' tabl,;, b,;". A "bl, I I setting of X,04' indicates an unallocated
cyiinder and X'OC' indicates an allocated cylinder. The VOLl and allo· cation records are written.
3 First the return PSW is set up and
Registers 1 and 2 are set to the volume serial number. The user directories
are swapped via a DIAGNOSE call
to DMKUDRDS. The DIAGNOSE will
program check if the user is not class A, B, or C. The directories are not
swapped if the volume is not found
in the OWNDLIST or if an I/O error occurs under CPo The message EOJ DIRECTORY UPDATED
appears on the console and control I returns to CMS. I If no errors occur, and if the active I system directory was updated, the
directories are swapped. The message I EOJ DIRECTORY UPDATED AND I ON LINE
appears on the console and control returns to CMS. Module DMKDIR Write out all the used buffers.
2 Build and write allocation record.
3 If running under the control of VM/370, swap directories, issue
message and return to CMS. 4 If running standalone, issue
message and enter wait state.
Label Ref Notes I- - - • - -;> I CMS EXIT 4 If not running under VM/370, the
message EOJ DIRECTORY UPDATED
appears on the console and the wait
state is entered by loading the DMKDIR ISCANAll1 SVCNEW PSW. I DMKDiR MOVEPSW LOOP 11
Directory
Module Label Ref DMKDIR BARE
Diagra. 4-5. Directory Exit Chapter 4. t!KDIR--The Directcry progra. 87

Program Organization
This section includes a program description
of the DKKDIR module. DKKDIR creates the YK/370 directory on a system
owned volume. ].!!try :f2int§ DKKDIRCT is the entry point when the
directory program is executed standalone
and DKKDIRED is the entry point when the
directory program is executed under the
control of CKS. !!2 ut i.!!§§ None
Attributes --Not-serially reusable. g! !!i! If executed under the control of C8S, register 15 contains a return code at
exit.
Return Code -,--- 2
3
4
5 Invalid filename or file not
found.
Error loading the directory.
Invalid option from CMS. Directory not swapped, user
class not A, B, or C. Directory not swapped, system
(cld) directory locked. SS IBM VM/370 Service Routines Program Logic
Return Code --6- 1xx 2xx Keaning Directory not swaPFed; the
directory the system is
using is nct the directory
just updated.
Error in CMS BDBOF rcutine.
Error in C!S TYPLIN routine. xx is the CKS routine return code. BO: Work register.
B1: Pointer to input field.
R2:
R3:
R4:
R5:
R6:
R1: RS: R9 : R10: R11:
R12:
R13:
R14:
R 15: Pointer to lOB. Pointer to output buffer. Work register.
Input count from SCINCARD. DASD address. Work register. Work register. Work register.
Branch and link return address.
Pointer to the next ODEVBLOK. Work register. RIIRBOF, pointer tc the ODIRELOK buffer. R!ACBOF, pointer to the OKICELCK buffer. RtEVBUF, pointer to the OKDEVELCK buffer.
Base register 3. RMAC, pointer to O!ICELOK. RIEV, pointer to ODEVELOK. Base register 1.
Base register 2.
Return address. RIIR, pointer to ODIRELOK. External References --I8KORDS---rs----called via a DIAGNOSE new VK/310 instruction to write the
directory on DISD.