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