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