Program Organization
This secticn includes program descriptions
of modules DMSIFC and DMSREA. DMSIFC Allows virtual users to edit and print VM/370 error recordings under eMS via the OS/VS EREP Edit and Print Program (IFCEREP1) ..
Routines Called --IFCEREp'--via LINK to edit and print VM/370 error recording cylinders. DMSREA via BlLR to read a specified
record from the VM/310 error recording
cylinders. DMSLlD via BlLR to determine which
read/write disk has the most space. DMKIOG via DIAGNOSE to clear requested
recording cylinders. STATE/STATEi via SiC to perform CMS functicns. ERASE via SiC to perform eMS functions. INCLUDE via SVC to perform CMS functions.
Attributes
- Nonreusable, CMS User Area, and called by CMS. R1: CMS parameter list address
R13: Save area address
R14: Return address at Exit RO-R14: -Restored R15: One of the following return codes
Return
Cede -'2- 24 28
32
56 60 62 CLEAR specified with
other parameters.
An invalid parameter or
no filetype was specified.
The file Was not found.
The file was not a
fixed-length format.
GLOBAL command was not
issued for CPEREP's TITLlBs ..
An I/O error caused one
or more of the 4K blocks of error records
to be skipped. More than the maximum number of characters in
options specified. RO-Rl: R2-R 9:
88 100 to set to zerc was sUFpressed. Requires privilege
class F.
Error reading file frem
disk.
Register Parameter registers Scratch R1O-R11: Spares, not used
Base register
Link registers
R12:
R14-R15:
External References --CoRRslvi----Contains address of the
current system save area when
control is received to handle
an SVC as requested by the HUDsve macro. OSSFLAGS OS simulation flags in the NUCON area. rOSFLAGS DOS simulation flags in the HUCON area. JJDTLKi Contains address of routine
that aetermines which
read/write disk has the mcst
space. (In the HUCON.) TITLIES Indicates whether or net any TITLIBs have been globaled.
(In the HUCCD.) TXTDIRC Indicates whether or net any
TITLIBs havE been globaled.
(In the HUCCH; Ioints to the
first directory in the chain
of global TITLIE
directories. )
The functions performed by CMSIFC can be
summarized as follows:
1.
2.
3.
4. Performs standard linkage
addressatility functions.
and
Invokes CMS LOAD function te load
and resolVE VCONs in about a dozen FREP object decks. !ote: All other EBEP object decks
are brought into storage later, as
needed, by OS LOAD and LINK macres
issued by CS/VS EREf. Invokes STRINIT function.
Indicates that area above presently
loaded programs is the beginning ef
free storage.
Turns off the DCSSVC flag in the CMS nucleus so that OS simulation can be used. SEts CCMPSWT in CMS nucleus so that OS LCAD and LINK macros bring in TEXT files rather
than module files. Invokes OS LCAt Chapter DMSIFC and DMSRI1--EREP/Error Recording Interface 215

5.
6.
7.
8.
9. 10. 11.
12.
13. 14. 15.
to lead DMSREA into
saves its address so
called later during simulation.
storage and
it can be
the EICP Establishes handling of SVC 76
(error log), SiC 18 (BLDL), and SVC o (EICP). Invokes FILEDEF function to define: • Printer file for EREP • SYSIN file to be created for EREP • Dummy file for EREP to open and
close as SYS1.LOGREC • "TOURIST" error file to the
terminal • DIRECTiK work file on disk
Gets the co.mand line arguments and
determines if a control file is
provided for inFut. If so, sets up
to read parameters from the control
file, otherwise, sets up to read parameters from the terminal.
Issues a DMSFREE macro to get storage for building OS parameter
list to be passed to EREP.
Gets inFut parameters (from control
file or terminal) and constructs
equivalent as/vs EREP parameter
list and SYSIN control card file.
If CLEAR was specified, and it vas
not the only parameter specified,
types an error message to the terminal and does housekeeping and
exits to CftS. If CLEAR was specified correctly,
calls a subroutine to issue the DIAGNOSE that clears the
approFriate records from the VM/370 error cylinders, then does
housekeeping and exits to CMS. If CLEARF was specified, read CPU and
director frames from SRF device and
write on error cylinder.
Invokes FILEDEF to define the
accumulation tape file if
requested. Issues the tape control
macros necessary to position tape
for subsequent write operations.
Invokes FILEDEF to define history
input taFe if requested and makes sure that it is rewound.
Links to as/iS EREP (IFCEREP1). Simulates BLDL SVCs issued from OS/VS EREP. Simulates EIEC SVCs issued from as/iS EREP so they will
appear to access a SYS1.LOGREC data
set. EICP simulation viII result 16. 17.
18. Dft SREA in calls to DMSDEA to get records from VM/370 error recording
cylinders. An EXCF that attemFts to rewrite the SYS1.LOGREC header
is a result of the ZERO functien
and is simulated by calling a
subroutine to issue the DIAGNCS! that clears the error records from
the error recording cylinders.
Eventually OS/VS EREE is done and
control returns from that LINK done
atove.
Housekeeps all indicators and
switches, frees any storage ottained for the OS Farameter list
area, clears handling of SVC 0, SVC 18, and SiC 76; and clears any FILEDEFs that were set up by CPEREP. Exits to CMS. Reads a specified logical record from the VM/370 error recording cylinders and
returns it to the caller.
Routines Called to find the beginning of
the recording area on the system disk,
and the number of error recording
cylinders. DIAGNOSE 1'30' to read a Fage size recerd from the error recording cylinders. tMSERR via macro SVC to write error messages to the console.
Attributes --Nonreusable, CMS User Area, enter via CALL. !!gist!£§ Ent!I
R1: Address of CCBOR DASD record address
R13: Save area address
R14: Return address ,£;xit R 0: Nonzero: address
record of being
R1:
R13:
var iable-lengt b
returned.
The first 4 bytes are the recerd
descriptor word ccntaining the
record length. Zero: end-of-file; no record was at or beyond the entered address.
Address of CCEOR DASI record
address (soaetimes corrected). Save area address.
216 IBM VM/370 Service Routines Prograw Logic