

TREAD/TWRITE SUBROUTINES























                            TREAD/TWRITE SUBROUTINES
                      INSTALLATION GUIDE AND RELEASE NOTES
                                 VERSION 3.02A










                            AUTHOR: FRANK J. MANION



                           CHI COMPUTER HORIZONS INC.
                            1050 KINGS HIGHWAY NORTH
                            CHERRY HILL, N.J. 08034
                                 (609)-779-0911


TREAD/TWRITE SUBROUTINES                                             PAGE 2



     1.0  PREPARING FOR INSTALLATION



        To install the TREAD/TWRITE subroutine system you should first  log
     in  to  your  computer under any account.  Then simply use FLX to copy
     all files on the distribution tape to your account.

        Before you attempt to install the subroutines, the macro  assembler
     and the librarian program should be INStalled on your system.



     2.0  INSTALLATION


        To install the TREAD/TWRITE system, YOU MUST RUN THE INDIRECT  COM-
     MAND  FILE  "TRWGEN".  This file will automatically create an assembly
     prefix file used in the assembly of  the  TREAD/TWRITE  system.   This
     prefix  file  is  not present on the distribution tape, hence you must
     run the command file.  To run the file, simply type "@TRWGEN".  I sug-
     gest  that you run the file once with the /NOMCR switch to familiarize
     yourself with the command file before you actually try to install  the
     subroutines.  The command file is self documenting and needs no furth-
     er explaination here.  Plase note that all files created by  the  ins-
     tallation process take the account that you are currently logged in to
     as the default input and output account (i.e.  files are searched  for
     and created under the current account and no other).



     3.0  DISTRIBUTION FILES


        The following is a list of files found on the distribution tape.

        TREAD.MAC is the source code for the TREAD/TWRITE  subroutine  sys-
     tem.

        TREAD.DOC is the users guide to the subroutine system.   It  should
     be printed and read thoroughly before you attempt to use the routines.
     The entire manual up to and including appendix a is of intrest to any-
     one  using  the  routines.  Appendix b to the end of the manual are of
     intrest to the advanced user/programmer primarily.

        TREAD.RNO is a copy of the users guide (TREAD.DOC) in  RUNOFF  for-
     mat.


TREAD/TWRITE SUBROUTINES                                             PAGE 3



        ASTOEB.MAC is the ASCII to EBCDIC translation  subroutine  used  by
     the TREAD system.

        EBTOAS.MAC is the EBCDIC to ASCII translation  subroutine  used  by
     the TREAD system.

        TRWGEN.CMD is the MCR indirect command file used to create the  as-
     sembly prefix file TREADPRAM.MAC, and to assemble the TREAD system.

        TREADPARM.MAC is created by the file TRWGEN.CMD.  This is  the  as-
     sembly prefix file.  This file is not on the distribution tape, but is
     created only by running TRWGEN.

        README.1ST is this file.

        README.RNO is the run-off version of this file.

        COPYMT.FTN is a FORTRAN program which uses the TREAD/TWRITE  system
     to  copy magnetic tapes written in IBM RECFM=FB format (all tapes read
     and written by TREAD/TWRITE are in this format).  The  program  allows
     users  to  specify nearly all options possible (i.e.  file number, la-
     beled or unlabeled, density, etc.) for magnetic tape input and output.
     Two tape drives are needed to run the program.  The program COPYMT can
     copy any such tape up to one containing input  blocks  of  data  about
     22000  bytes  in size.  The program is rather self explanatory, and it
     is also a fair example of how to use the subroutines.

        MAKBUF.MAC is a macro subroutine needed by COPYMT.



     4.0  COMPATIBILITY WITH IAS/RSX11D


        The TREAD/TWRITE system was written for an RSX11M system.   I  have
     been  unable to test it on an IAS or 11D system, but I assume it would
     work on those systems with little or no modification.



     5.0  GENERATING THE TASK "COPYMT"


        To compile and link the task COPYMT, do the following:



          1.  FOR COPYMT,LP=COPYMT/NOSN


          2.  MAC MAKBUF,LP=MAKBUF


          3.  TKB MAKBUF/CP,LP=COPYMT,MAKBUF,LB:[1,1]SYSLIB/LB:$SHORT


TREAD/TWRITE SUBROUTINES                                             PAGE 4



          4.  TKB OPTIONS:  UNITS=3,ACTFIL=1,MAXBUF=80,ASG=TI:3



