VAX 11 <---> KS500 COPY PROGRAM USER'S MANUAL ============================================= D.J.HONEY JUNE 1982 ========= ========= 1 INTRODUCTION ============ The KS500COPY program allows user's to transfer files between a KS500 system running OS500RT, and the VAX. Files may be UPLOADED into the VAX from the KS500, or DOWNLOADED from the VAX into the KS500 system. This file transfer is accomplished using two serial links between the KS500 and the VAX and can only be done on KS500 systems connected to the VAX in this manner. KS500COPY may be used to transfer ASCII files and Kongsberg absolute files. These files may access any valid KS500 device such as the paper tape reader or punch, as well as disc or tape files. The utility may also transfer binary blocks of data to/from bulk storage devices on the KS500, e.g. mag tape or disc. This may be used to copy binary data recordings to/from the VAX. 2 KS500 REQUIREMENTS ================== The KS500 system must be connected to the VAX using two bi-directional serial links. One link is used as a command link; the VAX becomes a virtual terminal user of the KS500 system. The other link is dedicated to the transmission of data between the two machines. The KS500 must be running OS500RT with at least one disc drive and a minimum of about 32k words of memory. Data transfers are peformed using a communications program in the KS500. The system must be configured so that the command macro VAXCOM loads and starts the KS500 program. Normally, the VAXCOM program resides on track D1 or F1. The macro VAXCOM is usually defined when the KS500 system is bootstrapped, by typing BATCH &MACROS D2 for example. The KS500 data link is best run at 9600 baud. The program expects this to be connected to the third channel of a CI500 card, as numbered 1 to 4. 3 OPERATION ========= The KS500COPY program is invoked by entering a command of the form shown below. The command KS500COPY may be abbreviated down to KS500C. The user must have assigned an appropriate KS500 system using the command GETKS500. KS500COPY [ /Option1 /Option2 ... /OptionN ] where [ ] encloses command options which may be omitted, and is a standard VAX/VMS file specification. The following command options are currently supported. /UPLOAD (D) Indicates that the copy is an UPLOAD from KS500 into the VAX. /DOWNLOAD Indicates that the copy is a DOWNLOAD from VAX into the KS500. /ASCII (D) Specifies that the file to be transferred is an ASCII file. A default Kongsberg filename is formed using up to the first six letters of the VAX filename. The default file is assumed to be on track A0. /ASCII= Specifies that the file to be transferred is an ASCII file, and that the specified KS500 filespec should be used. This may be any of the following: &FILE TRACK BLOCK nn TRACK DEVICE Examples: /ASCII=REA /ASCII=&KSFILE F0 /ASCII=BLOCK 2 A0 /ABSOLUTE Specifies that the file to be transferred is a standard Kongsberg absolute file. A default Kongsberg filename is formed using up to the first six letters of the VAX filename; the file is assumed to be on track A0. /ABSOLUTE= Specifies that the file to be transferred is a standard Kongsberg absolute file and that the specified KS500 filespec should be used. This may be any of the following: &FILE TRACK BLOCK nn TRACK DEVICE /BLOCK= Specifies that the data to be transferred consists of one or more 176 word Kongsberg blocks, starting at the block specified by on the track . Example: /BLOCK= 5 C0 /NO_OF_BLOCKS= Specifies the number of 176 word Kongsberg blocks to be transferred as an octal number . This is only relevant when using the /BLOCK option. A default of 1 block is assumed if the option is not specified. /ERRORS This tells the utility to print the number of transmission errors detected during the file transfer. This may be used to assess the reliability of the data link. Note that all data passed between the machines has checksums associated with it, and that it is virtually impossible for data to be incorrectly transferred without an error message being reported. /DIAGNOSTICS The KS500COPY program outputs diagnostics during the transfer process. This is primarily used for debugging purposes only. /NO_AUTO_START Normally the KS500COPY program in the VAX starts the VAXCOM program in the KS500. This may be inhibited for the purpose of debugging using this option. /AUTO_START (D) The KS500COPY program automatically starts the VAXCOM communications program in the KS500 using the command link.