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