Table of Contents

DMSDSL Abstract

Statistics

Type ASSEMBLE
Source Lines : 715
Fixes Applied : 0
Most Recent Version : Tuesday, December 12, 1978
Last Fix ID : [Unmodified]

Synopsis

Module

       DMSDSL  ( DOSLIB )

Function

       PROVIDE THE FACILITY TO DELETE MEMBERS (PHASES)
       OF A 'DOSLIB' LIBRARY, OR TO COMPRESS A 'DOSLIB'
       LIBRARY, OR TO LIST THE MEMBERS (PHASES)  OF  A
       SPECIFIED 'DOSLIB' LIBRARY.

Attributes

       DISK RESIDENT MODULE
       EXECUTES IN USER AREA

Operation

       1. SET UP NECESSARY ADDRESSABILITIES AND SAVE
          THE RETURN REGISTER. ACQUIRE SUPERVISOR KEY
          AND CLEAR ALL NON PERMANENT FCB'S.

       2. VERIFY THAT THE SPECIFIED FUNCTION IS VALID
          (MAP, DEL, OR COMP). VERIFY THAT A LIBRARY
          NAME IS ALSO SPECIFIED. IF THE 'DEL' FUNCTION
          IS SPECIFIED, ENSURE THERE IS AT LEAST ONE
          MEMBER (PHASE) SPECIFIED IN THE COMMAND LINE.

       3. PROCESSING OF THE 'DEL' FUNCTION STARTS BY
          VERIFYING THE EXISTANCE OF THE LIBRARY ON
          A R/W DISK. THE OUTPUT DCB IS OPENED AND THE
          SPECIFIED PHASES ARE DELETED ISSING THE O/S
          'STOW' MACRO. A WARNING MESSAGE IS ISSUED FOR
          ALL NOT FOUND PHASES SPECIFIED IN THE COMMAND.

       4. PROCESSING OF THE 'COMP' FUNCTION STARTS BY
          VERIFYING THE EXISTANCE OF THE LIBRARY ON A
          R/W DISK. THE INPUT AND OUTPUT DCB'S ARE OPENED
          AND ALL ACTIVE MEMBERS ON THE INPUT LIBRARY ARE
          COPIED TO THE OUTPUT WORK FILE. ALL I/O IS DONE
          USING THE O/S 'FIND', 'READ', 'WRITE' AND 'STOW'
          MACROS. ONCE THE OLD LIBRARY HAS BEEN COPIED,
          THE OLD LIBRARY IS ERASED AND THE WORK FILE IS
          RENAMED TO THE SAME NAME AS THE OLD LIBRARY. IF
          THE OLD LIBRARY HAS NO ACTIVE MEMBERS, THE NEW
          LIBRARY IS NOT CREATED AND THE OLD LIBRARY IS
          ERASED. A WARNING MESSAGE IS ALSO ISSUED.

       5. PROCESSING OF THE 'MAP' FUNCTION STARTS BY
          VERIFYING THE EXISTANCE OF THE INPUT LIBRARY.
          ONLY ONE OPTION IS ALLOWED ('DISK', 'PRINT'
          OR 'TERM'). DEPENDING ON THE OPTION SPECIFIED,
          OR DEFAULTED, THE OUTPUT FILE IS DETERMINED.
          IF THE OPTION IS 'DISK', A TEST IS MADE TO
          CHECK IF THE 'A' DISK IS R/W. THE INPUT AND
          OUTPUT DCB'S ARE OPENED AND BY USING THE O/S
          'FIND' MACRO, THE DIRECTORY FOR EACH MEMBER
          IS ACQUIRED AND ALL NECESSARY INFORMATION IS
          WRITTEN TO THE OUTPUT FILE.

       6. WHEN ALL PROCESSING HAS BEEN DONE FOR ANY OF
          THE FUNCTIONS, THE INPUT AND/OR OUTPUT DCB(S)
          IS/ARE CLOSED. ANY ACQUIRED FCB(S) ARE CLEARED.

       7. 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

       DMSERR, DMSERS, DMSFLD, DMSKEY, DMSRNE,
       DMSSBS, DMSSOP, DMSSTT, DMSSVT