Type ASSEMBLE
Source Lines : 445
Fixes Applied : 1
Most Recent Version : Tuesday, December 12, 1978
Last Fix ID : [HRC010DS]
Module
DMSACF (READFST)
Function
FOR A READ-WRITE DISK, TO READ ALL OF THE USER FILE
DIRECTORY INTO STORAGE; FOR A READ-ONLY DISK, TO READ
IN ALL OR PART OF THE USER FILE DIRECTORY, AT THE
CALLER'S OPTION; FOR AN O/S DISK, CONTROL IS RETURNED
TO THE CALLER AFTER SUCCESSFUL RETURN FROM DMSACM.
Attributes
TRANSIENT, REENTRANT
Operation
DMSACF, TOGETHER WITH DMSACM, BRINGS INTO STORAGE
ALL OR PART OF THE USER FILE DIRECTORY FOR THE GIVEN
DISK. IF THE DISK IS READ-WRITE, ALL OF THE UFD IS
MADE RESIDENT; IF READ-ONLY, THE QMSK AND QQMSK
TABLES ARE NOT BROUGHT IN BY
DMSACM, AND DMSACF CAN BRING IN SELECTED PORTIONS OF
THE FST
ENTRIES, IF SPECIFIED.
DMSACF DOES THE FOLLOWING:
FIRST DMSACM IS CALLED TO READ IN ITS PART OF THE
UFD. IF AN ERROR OTHER THAN 4 IS RETURNED BY READMFD,
DMSACF PASSES BACK THIS ERROR CODE TO THE CALLER AND
EXITS IMMEDIATELY. IF DMSACM WAS SUCCESSFUL, OR
RETURNED AN ERROR-4 INDICATING THE DISK WAS
READ-ONLY, DMSACF CONTINUES. IF THE DISK IS AN O/S
DISK, DMSACF EXITS IMMEDIATELY. AN 816 - BYTE
BUFFER FOR THE FIRST FST HYPERBLOCK IS OBTAINED FROM
FREE STORAGE IF NEEDED, AND AN 800-BYTE WORK AREA IS
OBTAINED.
THE FST HYPERBLOCKS ON DISK ARE NOW READ INTO THE
WORK AREA, ONE AT A TIME. ALL NULL FST ENTRIES ARE
IGNORED; OTHER ENTRIES ARE MOVED FROM THE WORK AREA
TO THE RESIDENT FST HYPERBLOCKS IF THE DISK IS
READ-WRITE, THUS RESULTING IN COMPACTED DIRECTORY IN
STORAGE OF ALL FILES. IF THE DISK IS READ-ONLY, EACH
FST ENTRY IN THE WORK AREA IS CHECKED AGAINST THE
PARAMETER LIST PROVIDED
TO DMSACF. (IF ANY FIELD IN THE PARAMETER LIST IS
'*' OR X'FF',
THE FILENAME, FILETYPE, OR MODE NUMBER IS ACCEPTED
WITHOUT CHECKING.)
THUS, FOR A READ-ONLY DISK DMSACF CAN READ IN ALL
FILES, OR ALL '2' FILES,
(AS IT DOES FOR THE S-DISK WHEN CALLED BY INITSYS) OR
ANY CONDITIONS THAT SATISFY THE PARAMETER LIST.
DMSACF GETS MORE HYPERBLOCKS FROM FREE STORAGE WHEN
NEEDED AND REFILLS THE WORK BUFFER FROM DISK WHEN
NEEDED, UNTIL ALL FST ENTRIES HAVE BEEN CHECKED AND
MOVED INTO THE FST HYPERBLOCKS IF ACCEPTABLE.
ALL APPROPRIATE COUNTS IN THE ACTIVE DISK TABLE
(NUMBER OF FILES, POINTER TO LAST FST ENTRY, ETC.)
ARE INITIALIZED AS NEEDED.
Calls to Other Routines
DMSFREE, DMSFRET, DMSDIOR, DMSACM (READMFD),