Google
 

Trailing-Edge - PDP-10 Archives - BB-L665A-BM - documentation/mountr.doc
There is 1 other file named mountr.doc in the archive. Click here to see a list.


MOUNTR.DOC -- Changes from V4(63) TO V4A(130)
June 1981






























COPYRIGHT (C) 1975,1978,1979,1980,1981 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.


THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND  COPIED
ONLY  IN  ACCORDANCE  WITH  THE  TERMS  OF  SUCH  LICENSE AND WITH THE
INCLUSION OF THE ABOVE COPYRIGHT NOTICE.  THIS SOFTWARE OR  ANY  OTHER
COPIES  THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
OTHER PERSON.  NO TITLE TO AND OWNERSHIP OF  THE  SOFTWARE  IS  HEREBY
TRANSFERRED.

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE
AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY  OF  ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
MOUNTR.DOC                                                      Page 2


MOUNTR.DOC -- Changes from V4(63) TO V4A(130)
June 1981



1.0  SUMMARY

Version 4A is a maintenance release of MOUNTR and contains  bug  fixes
and minor enhancements.

MOUNTR should  be  compiled  under  TOPS-20  V4  or  later.   For  the
successful  operation  of  MOUNTR  the  edits  described  in  the file
MOUNTR.BWR should be installed  in  the  appropriate  modules.   After
installing  these  edits  sites  should  reassemble ORNMAC, OPRQSR and
relink ORION.  In addition certain installations may wish  to  install
optional  edits  documented  in  the  file  MOUNTR.EDT.   Sites  using
AUTOPATCH for the TOPS-20 Monitor  should  not  install  patches  from
MOUNTR.EDT  however  these  patches  will  be  included on some future
AUTOPATCH tape.



2.0  EXTERNAL CHANGES

     1.0  No existing commands or actions have been changed.

     2.0  Mount requests displayed to the operator are accompanied  by
          a  ringing  of  the  terminal bell to attract the operator's
          attention.

     3.0  The following error message has been added.

          --MOUNTR System Task Error--

          Account  record  not  written  (user  information)   Reason:
          (reason)

          In the past this error caused MOUNTR to crash.

     4.0  The OPR display for SHOW STATUS DISK-DRIVE has been  changed
          to give more complete information.

     5.0  Certain displays have been changed to include the controller
          field  for  a disk controller.  This field is used only with
          RP20 disks.



3.0  KNOWN BUGS AND DEFICIENCIES

None.



4.0  INSTALLATION INSTRUCTIONS
MOUNTR.DOC                                                      Page 3


The following is for informational purposes only.  The edits described
in  the  file MOUNTR.BWR are necessary for the successful assembly and
operation of  MOUNTR  and  should  be  installed  in  the  appropriate
modules.   MOUNTR  can  be  assembled  using the file MOUNTR.CTL after
appropriate modifications have been made  to  reflect  logical  names,
structures, directories, etc.  as required by the installation.

The following is a sample installation session:

     @! ALL FILES MENTIONED CAN BE FOUND ON THE TOPS-20 DISTRIBUTION TAPE
     @! UNLESS ANOTHER SOURCE IS MENTIONED.
     @
     @! MOUNT THE TAPE PROVIDED AND COPY ALL MOUNTR.* FILES TO THE INSTALLATION
     @! AREA. WE ASSUME THAT THIS AREA IS CALLED PS:<4A-MOUNTR>
     @
     @! EDIT THE FILE ORNMAC.MAC SUPPLIED WITH THE TOPS-20 DISTRIBUTION TAPE
     @! AS SHOWN IN THE BEWARE FILE IF NECESSARY. IT WILL NOT BE NECESSARY IF
     @! THIS EDIT WAS INSTALLED IN THE PAST NOR WILL THE REBUILDING OF ORION.
     @!
     @! EDIT THE FILE OPRQSR.MAC SUPPLIED WITH THE TOPS-20 DISTRIBUTION TAPE
     @! AS SHOWN IN THE BEWARE FILE IF NECESSARY. IT WILL NOT BE NECESSARY IF
     @! THIS EDIT WAS INSTALLED IN THE PAST NOR WILL THE REBUILDING OF ORION.
     @
     @! NOW COMPILE THE EDITED ORNMAC. YOU MAY USE THE FILE OPERATOR.CTL
     @! FROM THE DISTRIBUTION TAPE TO DO THIS OR YOU MAY DO IT AS SHOWN
     @! THE FILE GALCNF.UNV MUST BE AVAILABLE FOR THIS COMPILATION.
     @COMPILE ORNMAC
     MACRO: ORNMAC
     BUILDING A GALAXY-20 ORNMAC

     EXIT
     @
     @! NOW COMPILE OPRQSR USING THE UNIVERSAL FILE ORNMAC.UNV WHICH YOU HAVE
     @! JUST COMPILED.
     @! THE FILE QSRMAC.UNV MUST BE AVAILABLE FOR THIS COMPILATION IN ADDITION TO
     @! ORNMAC.UNV
     @COMPILE OPRQSR
     MACRO: OPRQSR

     EXIT
     @! WE WILL NOW RELINK ORION. WE ASSUME ALL REL FILES OTHER THAN OPRQSR ARE ON 
     @! LOGICAL DEVICE PG: THE FOLLOWING STEP MAY BE ACCOMPLISHED BY SUBMITTING
     @! OPERATOR.CTL (FROM THE TOPS-20 DISTRIBUTION TAPE) AFTER ANY NECESSARY
     @! MODIFICATIONS HAVE BEEN MADE.
     @! THE FILE ARMAIL.REL (FROM THE TOPS-20 DISTRIBUTION TAPE) IS ASSUMED TO BE
     @! ON SYS:
     @! THE FILES OPRCMD.REL, CNTTAB.REL (DECNET ONLY), GLXINI.REL AND NCPTAB.REL
     @! ARE ALSO NEEDED. FOR THIS LOAD THEY ARE ASSUMED TO BE ON DSK:
     @
     @! THE FOLLOWING SEQUENCE OF COMMANDS CAN BE USED IN PLACE OF OPERATOR.CTL
     @
     @DEFINE M4A: PS:<4A-MOUNTR>
     @LOAD PG:ORION,M4A:OPRQSR,PG:OPRPAR,PG:OPRLOG,PG:OPRNET,PG:OPRERR,SYS:ARMAIL
     LINK: Loading

     EXIT
MOUNTR.DOC                                                      Page 4


     @! NOW WE WILL SAVE THE NEW ORION ON THE SYSTEM AREA IN THIS CASE WE ASSUME
     @! THAT THIS AREA IS PS:<NEW-SUBSYS>
     @
     @SAVE PS:<NEW-SUBSYS>ORION
      <NEW-SUBSYS>ORION.EXE.2 Saved
     @
     @! ORION IS NOW REBUILT AND INSTALLED.
     @
     @! TO INSTALL MOUNTR SIMPLY COPY THE FILE MOUNTR.EXE TO THE SYSTEM AREA
     @COPY MOUNTR.EXE PS:<NEW-SUBSYS>MOUNTR.EXE
      MOUNTR.EXE.1 PS:<NEW-SUBSYS>MOUNTR.EXE.2 [OK]
     @
     @! SYSJOB WILL HAVE TO BE RELOADED IN ORDER FOR THE NEW VERSIONS OF MOUNTR
     @! AND ORION TO BE USED. A RELOAD OF THE SYSTEM WILL ALSO CAUSE THE NEW
     @! VERSIONS TO BE USED.
     @
     @! IF IT BECOMES NECESSARY TO REBUILD MOUNTR SIMPLY SUBMIT THE FILE 
     @! MOUNTR.CTL AFTER MAKING APPROPRIATE MODIFICATIONS SO THAT ALL PROPER 
     @! FILES MAY BE FOUND.
     @



5.0  INTERNAL CHANGES

The following is for informational purposes only.




EDIT        COMMENT


64        Get more unique PID name and enhance messages when
          debugging.


65        Add RP20 Support.


66        Change symbol name to avoid a conflict with MONSYM.  Also
          fix a bug which prevented the printing of 2 error messages.


67        Do not ask the operator to key in volume identifiers when
          initializing labelled tapes.


70        Store the device designator in the accounting block for
          tapes.  This prevents the account block from being
          inadvertantly deleted.


71        This edit was replaced by edit 120.
MOUNTR.DOC                                                      Page 5


72        Correctly initialize register STR in routine KSST.  Prevents
          memory trashing bug.


73        Do not set OF%OFL when opening a tape drive.  This allows
          MOUNTR to check for drive offline.


74        Give more complete status for SHOW STATUS DISK-DRIVE.


75        Prevent MOUNTR from crashing if LPTSPL is spooling to tape
          and the tape drive is set available.


76        More of edit 74, report drive offline.


77        Fix a bug which allowed a user to get an unlabelled tape
          without the operator IDENTIFYing the tape.


100       Change an AC in the new RP20 code.  Also change some symbol
          names for future GALAXY (later removed).


101       Make significant changes to magtape accounting.  Fixes many
          errors in the usage records.


102       Remove some old unneeded code.


103       Format change to SHOW STATUS DISK-DRIVE display.


104       Fix a bug which caused a structure to be unmountable if a
          DISMOUNT command with the REMOVE switch was cancelled.


105       Prevent USAGE JSYS failure by storing zeros in the account
          block when a negative number is found.  This edit was
          removed when the problem which caused the incorrect negative
          numbers was fixed.


106       Improve the processing of MOUNTR.CMD.  This edit causes the
          DEFAULT status to be used for all structures.  Prior to this
          edit DEFAULT affected only structures which had no other
          command lines in MOUNTR.CMD.


107       Fix a bug which prevented account blocks from being zeroed
          during their allocation.
MOUNTR.DOC                                                      Page 6


110       Display the user supplied remark, if any, during a tape set
          request.


111      Remove edit 71.


112      Change the symbol names modified by edit 110 back to their
          origional definitions.


113      Add MOUNTRs name and version number to the usage records
          which it writes.


114      Make a format change to SHOW STATUS DISK-DRIVE display.


115      More of edit 77.  Do not allow a user to get an unlabelled
          tape without the operator IDENTIFYing it under any
          circumstances.


116      This edit was removed.


117      Insure that account blocks are not destroyed by a tape volume
          switch.


120      Reorganize the handling of structure accounting blocks to
          make the times meaningful.  Also rewrite edit 117 to fit
          into this framework.


121      Ring the console bell when displaying a mount request.


122      Fix a bug which caused an operator generated structure
          dismount request to remain active forever.


123      Change accounting code in routine VRA so that it is executed
          before the tape drive is given to the user.


124      Add a new error message for the operator indicating failure
          to write an accounting record.  Also ignore failure of the
          DIRST JSYS rather than crashing.


125      Prevent the loss of an account block when a non-regulated
          structure is physically mounted.  Also correct the test for
          a domestic structure when doing accounting.
MOUNTR.DOC                                                      Page 7


126      Remove edit 116.


127      Remove edit 105 since this is a non-fatal error due to edit
          124 and should never happen anymore due to edit 120.


130      Add local symbols which are usually found in universal files.
          This change allows MOUNTR to be assembled using field image
          software.



[End of MOUNTR.DOC]