Type ASSEMBLE
Source Lines : 1,232
Fixes Applied : 6
Most Recent Version : Tuesday, December 12, 1978
Last Fix ID : [HRC010DS]
Module
DMSACC (ACCESS)
Function
TO BRING INTO CORE THE USER FILE DIRECTORY FOR A
GIVEN DISK (E.G., 191, 192), SETTING UP THE NECESSARY
INFORMATION IN THE ACTIVE DISK TABLE FOR THE GIVEN
DISK MODE LETTER.
Attributes
TRANSIENT; SERIALLY REUSABLE.
Operation
DMSACC IS THE
COMMAND WHICH IS USED TO BRING INTO STORAGE THE USER
FILE DIRECTORY (UFD) FOR THE USER'S A-DISK OR ANY
OTHER DISK (EXCEPT THE S-DISK, WHICH IS LOGGED IN
EARLIER BY DMSING & DMSACF), ALSO TO READ THE LABEL &
FORMAT 1 DSCB OF ANY O/S DISK BEING ACCESSED AND TO
CREATE AN ACTIVE DISK TABLE FOR SUCH O/S DISK.
IN THE CMS INTIALIZATION PROCESS, IF THE USER'S FIRST
COMMAND IS NOT ACCESS OR FORMAT,
DMSACC
IS INVOKED AUTOMATICALLY TO LOG IN A USER'S FILES
FROM HIS A-DISK. IF A PROFILE EXEC EXISTS IN THE
USER'S DIRECTORY, THIS IS EXECUTED, FOLLOWED BY THE
FIRST COMMAND TYPED IN. IF THE USER WISHES TO BYPASS
THE AUTOMATIC CALL OF HIS PROFILE EXEC, HIS FIRST
COMMAND MUST BE ACCESSWITH THE NO PROFILE OPTION SPECIFIED.
THIS LOGS IN HIS FILES AS USUAL, BUT BYPASSES THE CALL TO THE
PROFILE EXEC.
IF AN ACCESS IS ISSUED AT A LATER TIME, FOR ANY DISK,
NO SUCH AUTOMATIC CALL TO PROFILE EXEC IS MADE--IT IS
EFFECTIVE ONLY ON THE FIRST COMMAND, AS DESCRIBED
ABOVE.
IF DESIRED, THE PROFILE EXEC ON A USER'S A-DISK CAN
CONTAIN EXEC COMMANDS TO ACCESS OTHER DISKS.
WHEN DMSACC IS INVOKED TO ACCESS AN O/S DISK, THE
OPTIONS NODISK,NOPROF,ERASE AND THE FILEID PARAMETER
ARE INVAILD AND A WARNING MESSAGE IS ISSUED TO NOTIFY
THE USER.
AFTER THE PARAMETER LIST HAS BEEN CHECKED FOR ERRORS AND
SPECIAL OPTIONS, DMSACC PROCESSES THE REQUEST DEPENDING
ON WHETHER OR NOT THE ERASE OPTION WAS SPECIFIED:
CASE 1: ACCESS WITHOUT THE ERASE OPTION BRINGS IN
THE DIRECTORY OF EXISTING FILES FOR THE GIVEN
DISK. IF THE DISK IS READ-WRITE, THE DIRECTORY
OF ALL EXISTING FILES IS BROUGHT INTO STORAGE
(REGARDLESS OF ANY REMAINING OPERANDS IN THE
PARAMETER LIST). IF THE DISK IS READ-ONLY, THE
DIRECTORY OF ONLY THOSE FILES SPECIFIED AS
OPERANDS IN THE P-LIST IS BROUGHT INTO STORAGE;
IF NO SPECIFIC FILENAMES, FILETYPES, OR
FILEMODES WERE SPECIFIED, THEN THE DIRECTORY OF
ALL FILES (EXCEPT 0 FILES) IS BROUGHT IN.
IF THE DISK IS AN O/S DISK, THE FORMAT 1 DSCB IS
READ AND THE ACTIVE DISK TABLE IS COMPLETED TO
CONTAIN THE LABEL,UPPER AND LOWER EXTENTS OF THE
VTOC AND THE O/S FLAG IN ADTFLG2 IS SET.
1. DMSALU IS CALLED TO CLEAR
ALL PERTINENT INFORMATION IN THE OLD ACTIVE DISK
TABLE.
2. IF THE DISK TO BE LOGGED IN WILL BE A READ-ONLY
EXTENSION OF ANOTHER (OR OF ITSELF), THE READ-ONLY
Calls to Other Routines
DMSLAD, DMSLADN, DMSFREE, DMSFRET, DMSACF, DMSACM,
DMSALU, DMSERR