Type ASSEMBLE
Source Lines : 886
Fixes Applied : 1
Most Recent Version : Wednesday, December 20, 1978
Last Fix ID : [R08978DS]

Module

       DMSRRV  ( RSERV )

Function

       PROVIDE THE FACILITY TO COPY MODULES IN THE DOS/VS
       SYSTEM OR PRIVATE RELOCATABLE LIBRARY TO A SPECIFIED
       OUTPUT DEVICE. VALID OUTPUT DEVICES ARE CMS DISK FILE,
       VIRTUAL PRINTER, VIRTUAL PUNCH, AND/OR USER'S CONSOLE.

Attributes

       DISK RESIDENT MODULE
       EXECUTES IN USER AREA

Operation

       1. SET UP NECESSARY ADDRESSABILITIES AND SAVE
          THE RETURN REGISTER. ACQUIRE SUPERVISOR KEY
          AND INITIALIZE REUSABILITY FIELDS. VERIFY IF
          IN CMS/DOS ENVIRONMENT.

       2. CHECK THE COMMAND LINE FOR VALID ARGUMENTS
          AND OPTIONS. ENSURE THAT A MODULE NAME WAS
          SPECIFIED. SET APPROPIATE SWITCHES FOR EACH
          OPTION SPECIFIED. IF THE 'DISK' OPTION IS
          SPECIFIED OR IMPLIED, ERASE ANY OLD FILE ON
          THE 'A' DISK. IF ERASE RETURNS A CODE OF 36,
          EITHER THE 'A' DISK IS R/O OR IS NOT ATTACHED.

       3. DETERMINE IF READING FROM THE SYSTEM OR PRIVATE
          RELOCATABLE LIBRARY (PRIVATE IS SEARCHED FIRST)
          & START READING THE APPROPIATE LIBRARY DIRECTORY
          RECORDS TO LOCATE THE SPECIFIED MODULE. ONCE THE
          MODULE ENTRY IS FOUND, COMPUTE THE DISK ADDRESS
          OF THE MODULE DATA BLOCKS.

       4. READ THE MODULE DATA BLOCKS ONE AT A TIME. DECODE
          EACH DATA BLOCK INTO CARD IMAGES. 'ESD', 'RLD',
          AND 'TXT' CARD IMAGES ARE PROCESSED INDIVIDUALLY.
          ALL OTHER TYPE OF CARDS ARE JUST WRITTEN TO THE
          OUTPUT DEVICE.

       5. WHEN ALL PROCESSING HAS BEEN DONE, ALL OUTPUT
          DEVICES ARE CLOSED.

       6. A SWITCH TO PROBLEM PROGRAM KEY IS DONE, AND A
          RETURN TO THE CALLER IS MADE PASSING IN REG. 15
          THE RETURN CODE OF THE COMMAND.

Calls to Other Routines

       DMSSTT, DMSERR, DMSERS, DMSKEY, DMKGIO, DMSPIO
       DMSBWR, DMSCWR, DMSCIO, DMSCPF, DMSFNS