Type ASSEMBLE
Source Lines : 1,459
Fixes Applied : 2
Most Recent Version : Wednesday, December 13, 1978
Last Fix ID : [R10719DK]

Module

       DMKCSU

Function

       DMKCSU CONTAINS THE CHANGE COMMAND FOR CLASS G
       AND CLASS D USERS.

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 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)
       7. GETCHARS - SAVE AND VERIFY CHARS VALUE SPECIFIED
       8. GETFLASH - SAVE AND VERIFY FLASH VALUES SPECIFIED
       9. GETCMOD  - SAVE AND VERIFY COPY MOD NAME
      10. GETFCB   - SAVE AND VERIFY FCB NAME SPECIFIED

       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
       DMKRPAGT - READ IN THE FIRST DASD SPOOL FILE BUFFER
       DMKRPAPT - WRITE OUT THE FIRST DASD SPOOL FILE BUFFER
       DMKPGTVG - GET A PAGE OF VIRTUAL SYSTEM SPACE
       DMKPGTVR - RELEASE A PAGE OF VIRTUAL SYSTEM SPACE