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