Type ASSEMBLE
Source Lines : 1,551
Fixes Applied : 12
Most Recent Version : Thursday, December 14, 1978
Last Fix ID : [HRC311DK]

Module

       DMKCSV

Function

       DMKCSV CONTAINS THREE SPOOLING COMMAND FUNCTIONS AVAILABLE TO
       TO CLASS G USERS. THE COMMANDS ARE ALSO PROCESSED
       FOR CLASS D USERS IN A SLIGHTLY DIFFERENT FORMAT

Attributes

       REENTRANT, PAGEABLE, CALLED VIA SVC

Operation

       EACH COMMAND PROCESSOR IS ENTERED VIA A CALL FROM DMKCSV.  THE
       PROCESSING LOGIC IS EMBODIED IN A SERIES OF INTERNAL CALLS TO
       A SET OF OPTION PROCESSORS AND LIST SCANNERS.  IN GENERAL,
       THE OPTION PROCESSORS ARE CALLED WHEN IT IS KNOWN, EITHER BY
       POSITION OR KEYWORD, WHAT TYPE OF OPTION MUST APPEAR NEXT ON
       THE COMMAND LINE.  THE OPTION PROCESSORS SCAN FOR THE NEXT
       FIELD, VERIFY ITS VALIDITY, AND SET UP INFORMATION FOR USE BY
       THE LIST SCANNERS. SINCE THE OPERATIONAL DESCRIPTION OF EACH
       OF EACH COMMAND PROCESSOR REFERENCES THESE SUBROUTINES, A LIST
       OF THEIR NAMES AND FUNCTIONS IS GIVEN HERE; A DESCRIPTION OF
       THE OPERATIONAL LOGIC AND REGISTER SETS FOR EACH SUBROUTINE
       APPEAR AT THE END OF THE MODULE

       OPTION PROCESSORS -
       1. GETUSER  - SAVE THE USER ID OF THE FILE'S OWNER
       2. GETYPE   - SAVE THE FILE TYPE (OR DEVICE TYPE)
       3. GETCOPY  - LOCATE AND SAVE THE NUMBER OF COPIES REQUESTED
       4. GETNAME  - LOCATE AND SAVE THE FILE NAME (AND TYPE)
       5. GETID    - LOCATE AND SAVE THE SPOOLID OR CLASS
       6. GETCLASS - LOCATE AND VERIFY THE CLASS REQUESTED (2ND LEVEL
                     ROUTINE)

       LIST SCANNING ROUTINES -
       2. GETFILE  - LOCATE THE NEXT FILE OF THE CORRECT CLASS, ID,
                     AND OWNER
       3. GETCHAIN - LOCATE THE NEXT FILE CHAIN TO SEARCH (2ND
        LEVEL ROUTINE)
       4.  SETPEND - LOCATE AN AVAILABLE VIRTUAL READER AND
           POST AN PENDING DEVICE END INTERRUPT

Calls to Other Routines

       DMKSCNFD - SCAN THE COMMAND LINE BUFFER FOR OPTIONS
       DMKSTKIO - TO STACK A IOBLOK
       DMKSPLDL - DELETE PURGED FILES FROM THE SYSTEM
       DMKCVTDB - CONVERT DECIMAL SPOOLID NUMBERS TO BINARY
       DMKCVTBD - CONVERT BINARY TO DECIMAL
       DMKERMSG - WRITE ERROR MESSAGES
       DMKCSOSD - TO START PUNCH OR PRINTER
       DMKSCNAU - TO LOCATE USERID VMBLOK
       DMKQCNWT - TO WRITE A MESSAGE AT CONSOLE
       DMKUDRFU - TO VERIFY A USER
       DMKFREE  - TO OBTAIN A BLOCK OF FREE STORAGE
       DMKFRET  - TO RETURN A BLOCK OF STORAGE
       DMKCKSPL - CHECKPOINT THE SFBLOK