Type ASSEMBLE
Source Lines : 920
Fixes Applied : 12
Most Recent Version : Thursday, December 7, 1978
Last Fix ID : [HRC039DK]
Module
DMKVDS
Function
TO PERFORM THE INTERNAL FUNCTIONS NECESSARY TO
ATTACH A VIRTUAL DEVICE TO A USER.
Attributes
REENTRANT, PAGEABLE, CALLED VIA SVC
Operation
1. THE REAL DEVICE BLOCK IS CHECKED TO SEE IF THE REAL DEVICE
IS OFFLINE, ATTACHED TO THE SYSTEM, OWNED BY CP, OR ALREADY
ATTACHED. IF SO, A CONDITION-CODE 1 AND A SPECIFIC ERROR CODE
IN GPR 2 ARE RETURNED TO THE CALLER (SEE EXIT CONDITIONS).
2. IF NOT, THEN A VIRTUAL DEVICE BLOCK (AND CONTROL UNIT BLOCK
AND/OR CHANNEL BLOCK, IF NECESSARY) IS CREATED AND INITIALIZED
(USING INTERNAL SUBROUTINES BLDVDEV & BLDBLOK).
3. FINALLY, DMKVDSAT FLAGS THE REAL DEVICE AS DEDICATED
(I.E. ATTACHED), AND FILLS IN OTHER DATA AS NEEDED IN THE
VIRTUAL AND REAL DEVICE BLOCKS, AND RETURNS TO THE CALLER.
Calls to Other Routines
DMKFRERC - TO OBTAIN VCHBLOK, VCUBLOK AND VDEVBLOK
DMKFRET - TO RETURN A VCHBLOK, VCUBLOK, OR VDEVBLOK TO FREE
STORAGE (IF A LARGER ONE IS NEEDED)
DMKSCNVU - TO FIND THE VCHBLOK, VCUBLOK, AND/OR VDEVBLOK FOR
A VIRTUAL DEVICE.
DMKSPLDL - TO DELETE THE SPOOL FILES ON THE DELAY PURGE
QUEUE OF A 3800 PRINTER TO BE ATTACHED