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