Google
 

Trailing-Edge - PDP-10 Archives - BB-H138C-BM - 5-documentation/rms20.doc
There are 12 other files named rms20.doc in the archive. Click here to see a list.


RMS20.DOC -- V1(52)
May 1981






























COPYRIGHT (C) 1979,1980,1981,1982 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.
RMS20.DOC                                                       Page 2


RMS20.DOC -- V1(52)
May 1981


1.0  SUMMARY

This is Release 1 of RMS-10/20.   RMS  provides  multi-key  ISAM  file
support  for  COBOL-74/V12B.   The  components  of  RMS-10/20  are  as
follows:

     RMS       The run-time system of RMS-10/20.
     RMSUTL    RMS file manipulation utility.

RMS-20 requires release 4 or later of TOPS-20.  RMS  requires  version
12B of COBOL-74 or version 2.1 of BASIC-PLUS-TWO.

The relevant documentation is as follows:

     RMS Reference Manual (RMSREF.MEM)
     COBOL-74/V12B Language Manual, Appendix I



2.0 EXTERNAL CHANGES

None.



3.0 KNOWN BUGS AND DEFICIENCIES

     1.  RMSUTL does not handle stream, sequential, or relative files.

     2.  Only multi-key ISAM files can be accessed from  COBOL.   OPEN
         statements for RMS files may not contain the ALLOWING clause.

     3.  RMSUTL does not have facilities to display or  change  packed
         decimal or double integer fields.

     4.  If certain  prolog  fields  are  clobbered,  RMS  will  abort
         opening  of  a  file.   There  are no facilities in RMSUTL to
         "quick open" a file.  Thus it is not possible to  "unclobber"
         fields like ORG with RMSUTL.
RMS20.DOC                                                       Page 3


4.0 INSTALLATION INSTRUCTIONS


4.1  Installing RMS

To install RMS, you should do the following:

     1.  From the  Documentation  saveset  on  the  Distribution  Tape
         restore, print, and read the following files:

              RMS20.DOC (This file)
              RMSREF.MEM (Reference Manual)

         The reference manual describes RMSUTL, RMS concepts, and  RMS
         status  codes.   It  is mostly of use to those who design and
         maintain RMS files.

     2.  From the SUBSYS saveset on the Installation Tape restore  the
         following  files  to  SYS:  (or <RUN-directory> for testing).
         These files are:

           B362LB.REL  ;Required to be on SYS: for linking with RMS
           RMS.EXE
           RMS.REL
           RMSCOB.EXE
           RMSUTL.EXE
           RMSINT.R36  ;Required to be on SYS: for relinking RMS.

         RMS is now ready to use.  If you are going to run UETP tests,
         do steps 3, and 4, otherwise go to step 5.

     3.  From the UETP saveset on the Installation Tape,  restore  the
         following  files  to  the  directory PS:<UETP.LIB>.  The UETP
         modules are:

           RMS.VER
           RMTMKI.CBL
           RMTNAM.UTL
           RMTOK.MST
           RMTOK.UTL

         This is a self-checking group of tests, run under UETP,  that
         exercise RMSUTL.
RMS20.DOC                                                       Page 4


     4.  Run the UETP tests using the following procedure:

          @CONNECT <RUN-directory>       ;UNLESS RUN-directory IS SYS:
          @DEFINE DSK: DSK:,PS:<UETP.LIB>;SO AS TO FIND TESTS
          @RU UETP
          DEFAULT/DEPTH:VER
          ENABLE RMS
          BEGIN
          EXIT
          @DELETE RMS.LOG,RUN.LOG,EXCEPT.LOG

     5.  Run  your  own  tests  if  desired.    This   concludes   the
         installation.

     6.  If <RUN-directory> is  not  SYS:,  install  RMS  software  by
         giving the following command:

              COPY <RUN-directory>*.* SYS:*.*

4.2  Rebuilding RMS

Maintenance on RMS will be done via DDT patches and AUTOPATCH.  If  in
the future, you use AUTOPATCH, you will need to rebuild the software.

Included  in  this  release  are  linkable  files  for  creating   RMS
executable (.EXE) files.

To rebuild RMS you should copy, from the Language-sources  saveset  of
the Distribution Tape, the following files to an empty directory:

     RMS201.REL
     RMS2C1.LNK
     RMS2P1.REL
     RMS2S1.LNK
     RMS2U1.LNK
     RMS2U1.REL

You should then follow procedures documented in the AUTOPATCH kit.
RMS20.DOC                                                       Page 5


5.0  INTERNAL CHANGES

None.



6.0  SUGGESTIONS

None.



[End of RMS20.DOC]