Program Organization
This sect10n includes program descriptions of modules DMKIMG and DMKMNT. DMKIftG Provides a CMS interface for the VS-based IEBIMAGE program by handling certain SVCs
issued by IEBIMAGE and translating them
into CMS terms. g2int DMKIMGBG Routines Called --FSSTATE-----Determines if control file exists. BNDSVC - Traps certain SVCs issued by IEBIMAGE. GETMAIN - Gets area for simulating OS LOAD SVC .. FREEMAIN -Releases OS LOAD area.
FILEDEF Issues FILEDEFs needed by IEBIMAGE. LOAD - Simulates OS LOAD and QSAM READ. FSWRITE - Creates a new TEXT file (STPW simulation) • Attributes --Disk-resident, loaded into CMS user area. called via SVC 202, serially reusuable. R1: Standard CMS PLIST R14:
Return address R15: Address of GENIMAGE R15: Return code < 100 for normal
IEBIMAGE execution
R15: Return code 100 if error in
input parameters
R15: Return code 104 if error
during FILEDEF MAINBIGH - Saves and restores its value
between lo.ads. DMKNMT constructs an image library from TEXT files on user disks and creates or
replaces that image library via DIAGNOSE code X' 74' • Point tMKNMTBL Routines Called --FSSTATE-- Determines if CNTRL and TEXT files. exist. ISREAD - Reads in the contrel file. CMS LOAI - Loads the TEXT file into the
transient area.
Attributes --rIsk-resident as "IMAGELIB". loaded into eMS user area, via SiC 202, serially reusuable. !nt!I R1: Standard CMS PLIST Register 15 contains a return code:
Return o Image library updated
successfully
4 Control file· not found or in
error
8 Specified image nen-existent
12 Specified image caused LOAD errer
16 Insufficient virtual storage
20 I.age litrary is currently active 100. Error in FSREAD return
code ].§age HO: work register R1:
R2:
B3:
B4:
R5:
R6:
R7:
B8:
R9:
B12:
R 14: R 15: PLIST register and temporary werk
register Source address for MveL Source length fer MVCL Target address for MVCL Target length fer MVCL current end of image library in
storage
Pointer to next
directory entry
Running counter for
directory entries
starting address of
library in storage IMKNMT module base
available
number of
the image BAtR return address and scratch
register
BALR branch address and scratch
register None
Chapter 13. DMKIMG and DMKNMT -- IEEIMAGE Interface 235

Directory
Figure 13-2 is an alphabetical list of
the major labels in aodules DMKIMG and D!KNMT. The figure indicates the
associated .ethod of operation diagrams
and it provides a trief descripticn cf
the operation perfor.Ed at the point in
the progra. associated with each label. I ILabel I AFTERRD
BLDL2
BLDL3
BLDRET
DIAGERR DSPLOOP -ENDPARMS ERR004
-FILEBAD GETSEQ LDERR
LOADRTN LOOPl LOOP2 MOVETXT NOTEXT OPTIONS PARMERR RANOUT RDEOF
RDERR RDLOOP READEXIT READRTN RETURN RETURN STOWRTN TXTLOOP WRITERTN Figure 13-2,. Diagrall
13-2
13-1
13-1
13-1
13-2
13-2
13-1
13-2
13-1
13-1
13-2
13-1
13-1
13-1
13-1
13-2
13-1
13-1
13-2
13-2
13-2
13-2
13-1
13-1
13-1
13-2
13-1
13-1
13-1 DMKIMG an
Description
Saves the name of the control file.
Checks for file.
Return to user key.
Issue error message DMKNMT254E. Adjusts old displace.ent in directory entries.
Creates DUMMY image library.
Issues return code of 4.
Issues FILEDEF error.
Obtains current value of sequence nu.ter.
Issues error lIessage DMKBftT249!. Sillulates LOAD functions. Validates para.eter list. Validates options.
Issues error .essage D!KNMT248!. Scans through Gives return code 100 for paralleter error.
Issue error aessage DMKN!T256E. Saves file name for CLOSE.
Checks for end-of-file. Points to file name.
Issue return codes from READ. Simulates READ functions.
Saves return code.
Obtains return address.
Simulates STOW functions.
Creates TXT cards.
Simulates WRITE functions. DMKNMT Label Directory
236 IBM VM/370 Service Routines Program Logic I I