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