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