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

Module

       DMKCSQ

Function

       DMKCSQ CONTAINS THE SPOOLING COMMAND FUNCTIONS AVAILABLE TO
       TO CLASS G USERS. SOME OF 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 DMKCFM.  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 OPERAND 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. GETCLASS - LOCATE AND VERIFY THE CLASS REQUESTED (2ND LEVEL
                     ROUTINE)

       LIST SCANNING ROUTINES -
       1. GETDEVIC - LOCATE THE NEXT VDEVBLOK OF THE APPROPRIATE
                     ADDRESS, CLASS AND TYPE (2ND LEVEL ROUTINE)
       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)

Calls to Other Routines

       DMKFREE  - TO OBTAIN A BLOCK FROM FREE STORAGE
       DMKFRET  - TO RETURN STORAGE
       DMKUDRFU - TO VERIFY A 'USERID'
       DMKCSOSD - TO START RDR, PRINTER OR PUNCH
       DMKSTKIO - TO STACK AN IOBLOK
       DMKSCNVU - LOCATE A VDEVBLOK
       DMKUDRRV - TO CLOSE THE DIRECTORY
       DMKSCNFD - SCAN THE COMMAND LINE BUFFER FOR OPTIONS
       DMKQCNWT - WRITE RESPONSE AND ERROR MESSAGES
       DMKVSPCO - CLOSE (AND OPTIONALLY PURGE) OUTPUT SPOOL FILES
       DMKVSPCR - CLOSE READER FILES
       DMKSPLDL - DELETE PURGED FILES FROM THE SYSTEM
       DMKCVTHB - CONVERT HEX ADDRESS OPTIONS TO BINARY
       DMKCVTDB - CONVERT DECIMAL SPOOLID NUMBERS TO BINARY
       DMKERMSG - WRITE ERROR MESSAGES
       DMKCKSPL - CHECKPOINT THE BLOCKS