Type ASSEMBLE
Source Lines : 1,021
Fixes Applied : 4
Most Recent Version : Thursday, December 7, 1978
Last Fix ID : [R12943DK]
Module
DMKCST
Function
DMKCST CONTAINS CERTAIN SPOOLING COMMAND FUNCTIONS AVAILABLE
TO CLASS G USERS.
Attributes
REENTRANT, PAGEABLE, CALLED VIA SVC
Operation
THE VARIOUS FORMS OF THE TAG COMMAND ARE PROCESSED BY THIS
MODULE. THE TAG COMMAND PROCESSOR IS ENTERED VIA A CALL
FROM DMKCFM. THE KEYWORD OPTIONS ARE INSPECTED TO DETERMINE
THE FUNCTION WHICH IS TO BE PERFORMED. THE POSSIBLE FORMS
ARE TAG DEV, TAG FILE, TAG QUERY DEV, AND TAG QUERY FILE.
EACH FORM IMPLIES A REQUEST FOR A DIFFERENT FUNCTION, WHICH
IS PERFORMED BY A SEPARATE FUNCTION PROCESSOR. ONLY ONE
FUNCTION MAY BE REQUESTED BY A SINGLE TAG COMMAND LINE.
THE SEPARATE FUNCTION PROCESSORS ISSUE CALLS TO THE INTERNAL
AND EXTERNAL SUBROUTINES TO EXECUTE THE COMMANDS. THE
LOGIC USED BY EACH OF THESE FUNCTION PROCESSORS IS DESCRIBED
AT THE START OF THE PROGRAMMING FOR EACH, BELOW.
OPTION PROCESSORS -
1. GETYPE - SAVE THE FILE TYPE (OR DEVICE TYPE)
2. GETFILE - LOCATE THE SPOOL FILE ID, CONVERT IT, AND
CALL GETSFB TO LOCATE THE FILE'S SFB
LIST SCANNING ROUTINES -
1. GETDEVIC - LOCATE THE NEXT VDEVBLOK OF THE APPROPRIATE
ADDRESS, CLASS AND TYPE (2ND LEVEL ROUTINE)
2. GETSFB - SCAN THE SPOOL READER FILE CHAIN TO LOCATE
A FILE SPECIFIED BY A SPOOL ID (2ND LEVEL
ROUTINE)
Calls to Other Routines
DMKFREE - TO OBTAIN A BLOCK FROM FREE STORAGE
DMKFRET - TO RETURN STORAGE
DMKSCNVU - LOCATE A VDEVBLOK
DMKSCNVN - TO GET A DEVICE TYPE EBCDIC NAME
DMKSCNVD - TO GET A VIRTUAL DEVICE ADDRESS (CUU FORM)
DMKSCNFD - SCAN THE COMMAND LINE BUFFER FOR OPTIONS
DMKCVTDB - TO CONVERT EBCDIC SPOOL ID TO BINARY
DMKCVTHB - TO CONVERT HEX ADDRESS OPTIONS TO BINARY
DMKCVTBH - TO CONVERT BINARY DEVICE ADDRESS TO EBCDIC
DMKPGTVG - TO RESERVE A PAGE OF SYSTEM VIRTUAL STORAGE
DMKPGTVR - TO RELEASE A PAGE OF SYSTEM VIRTUAL STORAGE
DMKRPAGT - TO READ A SPOOL FILE PAGE BUFFER
DMKRPAPT - TO REWRITE A MODIFIED SPOOL FILE PAGE BUFFER
DMKERMSG - WRITE ERROR MESSAGES