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.

Directory
Figure 4-2 is an alphabetic list of the major labels ef the Directory program. The
associated method of operation diagram is
referenced and a brief description of the
function performed at the Feint in the program corresponding tc each label is
included. Label BARE BILDUDIR BILDUlUC BINCONV CHAINDEV CLEARUDR CMS1 CMS3 COMPARE DECCONV DEPAUL13 DMKDIRCT EDIT TEST EOP ERROR51 ERROR52 ERROR58 ERROR62 EXIT GETCARD GETCYLNO GETPAGE GRAPHID HEICONV LONG LOOP11 MOVECPT MOVEDISP MOVEPSW MSGRET MSG02A MSGWRITE NOTUSED POINTDEV Diagram
4-5
4-2,4-3
4-1
4-1
4-1 4-1 4-2
4-4
4-1
4-5
4-1
4-5
4-5
4-1
4-1
Description
Directory program exit when not running under the control
of VM/370. Builds UDIRBLOK. Builds UMACBLOK. Cenverts decimal numbers to binary.
Chains UDEVBLOK to UMACELCK. Clears UDIRBLOK. Sets up the parameter list identifying the file centaining the
control statements when running under CMS. Reads CMS control cards via SVC 202: Compares keywords and sets condition codes.
Converts decimal numbers to hexadecimal.
Defaults to the IPL device for control statement input device
when running standalone. Sets up base registers and initializes pointers. Sets DIRFLAG to X'20' to indicate edit, if EDIT is specified
when the Directory program is run under VM/370. Simulates a USER card.
Error processing for invalid operand.
Issues message when a control statement is out cf sequence.
Issues message DMKDIR758E.
Issues message DMKDIR762E.
End-of-job processing for Iirectory Program. Reads control statement in input buffer. Pills in cylinder relocation for minidisks.
Assiqns a DASD page address. Reads the input control statements from a display terminal when
the directory program is not running under hexadecimal numbers to tinarv.
Turns on long block indicator for minidisks.
Calls DMKUDRDS via the DIAGNOSE instruction to swap directories
when running under VM/370. Sets up current control statement pointer. Updates UMACBLOK. Sets up return PSi before issuing DIAGNOSE to call DMKUDRDS. When running standalone, a header line is printed.
Requests input device when running standalone.
Writes messages to the terminal. Updates UMACBLOK pointer. Updates UDEVBLOK pointer. igure 4-2. The Directory Program Label Directory (Part 1 of 2)
Chapter 4. rMKDIR--The Directory Program 89