Type ASSEMBLE
Source Lines : 365
Fixes Applied : 0
Most Recent Version : Tuesday, December 12, 1978
Last Fix ID : [Unmodified]
Module
DMSTRK (TRKLKP)
Function
TO ALLOCATE AN 800-BYTE DISK AREA TO A CALLING
PROGRAM.
Attributes
NUCLEUS RESIDENT, REENTRANT
Operation
NOTES: DMSTRKA CHECKS FOR ERRORS BY THE CALLER
AND AN ERROR 2 (WITH ERROR HALT FIRST) IS GIVEN IF
SUCH OCCURRED.
DMSTRKA NOW REMEMEBERS (IN ADTIST) THE DISPLACEMENT
OF THE FIRST
FULLWORD IN THE QMSK THAT HAS A ZERO-BIT IN IT
ANYWHERE, TO
SPEED UP SEARCHES AFTER THE FIRST CALL TO DMSTRKA FOR
ANY DISK. (DMSTRKX OF COURSE MAINTAINS THIS WORD WHEN
RECORDS ARE
RETURNED.)
WHEN THE NUMBER OF RECORDS REMAINING ON THE GIVEN
DISK NO LONGER EXCEEDS A RESERVE COUNT (ADTRES) THAT
IS MAINTAINED BY THE FILE SYSTEM, AN ERROR 4
(INDICATING VERY FEW RECORDS LEFT) IS RETURNED.
THIS FEATURE ENABLES DMSBWR OR DMSTQQ, ON THE ONE
HAND, TO RETURN THE RECORD VIA DMSTRKX AND INVOKE THE
DISK IS FULL LOGIC. WHILE DMSAUD, ON THE
OTHER HAND, CAN USE THE RECORD
FOR COMPLETING THE NEW USER FILE DIRECTORY. (THIS IS
PART OF CMS'S DOUBLE DIRECTORY SCHEME FOR MAXIMUM
FILE INTEGRITY.)
Calls to Other Routines
NONE