.LITERAL FAST FLX-TAPE READER (FFL) V1.7 Sept 14,1979 Harry Atherton University of Cincinnati Medical Center Department of Pediatrics, Room 6253 231 Bethesda Ave. Cincinnati, Ohio 45267 phone (513) 872-5341 .END LITERAL .AUTOPARAGRAPH Your comments and suggestions are welcome, although I cannot promise they will be acted upon. No responsibility is assumed for the use or reliability of this software. .TITLE FAST FLX-TAPE READER (FFL) .PAGE This program transfers files from FLX mag tape (DOS-11) to disk (FILES-11). It differs from FLX in that it will: read all files specified in the command line in a single pass through the tape, place the selected files in the directory corresponding to the UIC of the file, and create a directory for the file if one does not exist. FFL may also be requested to place all files in the same directory (as FLX does). The mode of operation is determined by the output file specification. .LITERAL Tape UIC Mode The command line for this mode is: OUTDEV:/SW=infilespec .END LITERAL OUTDEV may be any mounted FILES-11 device. If not specified, SY: is used. The directory and file name is obtained from the tape file. In this mode the files are placed in the directory corresponding to the UIC of the file as it appears on the tape. For this to be successful, the program must have appropriate access to the directories. To create a directory the program must be running under a system UIC. If you do not have proper access you will be overwhelmed with error messages. This version will accept label records up to 20 bytes long, to handle "DOS" format tapes (sic!) generated on systems that can't produce real 14-byte label records a la real DOS-11/FLX. .TEST PAGE 16 .LITERAL OUTPUT SWITCHES Switch Default Function /SL /-SL Will print a line identifying each file at completion of transfer. /UF /-UF Causes a user file directory to be created if one does not already exist for the UIC of the file. The program must be run under a system UIC for this to work. /FO /FO Sets the file owner to the UIC corre- sponding to the directory in which the file is stored. If /-FO is specified, the owner will be the UIC which is running FFL. /ER /-ER Causes FFL to ignore all errors on tape input except EOF, EOT, and priv- ilege violations. Useful for cases of bad tapes with valuable data, but can be dangerous on total wildcards. .END LITERAL .TEST PAGE 10 .LITERAL Single Directory Mode The command line for this mode is: OUTDEV:[UIC]/SW=infilespec .END LITERAL The presence of the UIC indicates that all files are to be placed in the specified directory. The file owner is the UIC under which FFL is running. The directory must exist, as FFL will not create it. The only switch which is applicable in this mode is /SL. .LITERAL INPUT FILE SPECIFICATION The input file specification has the usual format: INDEV:FILESPEC/SW[,FILESPEC]... .END LITERAL .TEST PAGE 5 If INDEV is not specified, the device assigned to LUN 2 will be used. Wild cards may be used for UIC, filename, filetype. File version is not used since the DOS format does not contain version numbers. To be consistent with FLX operation, only the first six characters of the file name are compared, although all characters in the tape label will be used for the file name. The UIC specified will continue to be used with subsequent file specs until another UIC is specified. If a UIC is not given with the first file spec, the UIC of the terminal running FFL is used. The input specification may be continued on multiple lines by typing a hyphen at the end of the line. All file specs are processed before the tape is read; specifying more than one input device will cause strange things to happen. As assembled, there is space for 20 input file specs. The assembly parameter TABLSZ may be changed to adjust the size to your needs. This program was designed on the assumption that there will be multiple input file specifications with wildcards. This places limitations on the flexibility of the program (it also makes the program simpler). No check is made to see if the files specified are actually read. Thus the tape is always searched to the end of volume, and no "file not found" diagnostic is made; also, most FLX switch options are not available. Most important, all files are processed in the mode indicated by the file type. .TEST PAGE 12 .LITERAL TRANSFER PROCESSING MODES (FLX DEFAULT) Mode Filetype Image TSK, OLB, MLB, SYS, SML, ULB HLB, CLB, DOS, DSK, EXE Formatted Binary OBJ, STB, BIN, LDA Formatted ASCII All other filetypes Also the blocksize is assumed to be 512 bytes, and that is the maximum that can be processed. .END LITERAL .TEST PAGE 20 .LITERAL There are two input file specification switches. INPUT SWITCHES Switch Default Function /RW /RW Rewind tape before searching for files. /-RW will suppress rewinding. /DNS Leave density Change tape density as indicated. as previously Only /DNS:800 or /DNS:1600 is set. allowed. Startup default is 800 BPI. .END LITERAL The /-RW switch is a little dangerous. FFL expects the first record it reads to be a file label; if it isn't an error will result. The tape can be properly positioned by using FLX to read or list directory of the file immediately preceeding the area FFL is to start searching.