FIND File Search Utility Version V01.02 Operating System: RT-11 V4.0, V5.x, TSX+ Author: D. N. Tanner Livermore, Ca 94550 FIND is a device and sub-device file search utility. The program will search devices and .DSK files for a specified file or files. The information displayed is the device name, file name, file size and date. If the file is in a sub-device file that file name is also included. Wild cards are allowed in the file name and file type. The program operates on RT-11 Version 4 and 5 and TSX-Plus. It may work on V3 but has not been tested. It will not work on HT-11 or RT-11 V2C. Page 2 FIND - File Search Utilty FIND searches each physical device on the system for the specified file. Files found are listed on the terminal in the order found. The same devices are searched for files with a DSK file type. This is the Rt-11 Version 5 type for sub-device files. For each sub-device file, that directory is also searched for the file. It is not necessary to have the sub-device files mounted to a LD device. It is also not necessary to search the LD devices unless there are nested subdevices. Wild card, the *, is acceptable as part of the file name to be found. Command Syntax (RT-11 V5) Assuming that FIND.SAV is on the system disk (SY:) then the FIND command syntax is: .FIND filespec [dev:] Where: filespec is the file or files to be located. This should NOT have a device name included. dev: is an optional extra device to be included in the the search. The physical devices to be searched are included in the program, but it can be patched to add or delete devices. Up to 20 physical devices can be searched. The physical devices are searched first and then any sub-device files are searched. The files are listed on the terminal in the order found. An example of a FIND is: The command is: .FIND PROG.RNO The result is: Search for: PROG.RNO Dev. Directory File File Name Size Date DL0: B .DSK PROG .RNO 4 25-SEP-84 The program clears the screen (VT100 assumed) and types the first group of 22 files. If the number of files is greater than 22 then the listing pauses and the program waits for a return to be typed before continuing. See the patches at the end if you do not use a VT100. Page 3 File Specification The file specification can include the * as a wild card. The following forms are allowed. File name File type A B A* B* *A *B A*B C*D *A* *B* Where the letters represent 1 to 6 letters for file names and 1 to 3 letters for the file type. Any file name form can be used with any file type form. Additional Device The optional device specification is to include an additional device in the FIND search. The most likely example is the DY or DX devices which may not have a diskette installed most of the time. If the DY is included in the permanent device tables in FIND then the disk drive will by cycled several times before the system decides that it cannot read a directory. Logical devices or sub-devices can be included in the search, but FIND will look at those directories twice. The first search will be using the physical device name and the second will be using the sub-device file name. If some logical devices have logical device files in them FIND will not search them unless they are mounted and you search that LD. (A nested search version of FIND is planned) FIND Errors The current version has very brief error messages. A device error will result in a "Fetch Error" or a "Lookup Error", no further explaination. In some cases there is no message. Is all cases, errors are ignored and the search continues. File name testing is minimal. Long names are accepted and you just get no matches. Page 4 Command Syntax (RT-11 V4 or V5) If the program is run, as is required in version 4 of RT-11, the program prompts for the file. The input is the same as described above. An example is: .R FIND FIND V01.01> filespec [dev:] Customizing Patches The program has several options which can be changed using SIPP or PATCH. Sub-device file type. The sub-device file type defaults to DSK, the version 5 standard. If some other type is desired such as DEV, location 1000 needs to be changed. The new file type must be entered in octal RAD50 representation of the 3 letter file type. Page Size The page size for the file display is set to 22 lines. Location 1002 contains the page size. If no page pause is desired, enter zero into location 1002. Terminal Type The program assumes a VT100 terminal is being used. If some other terminal is being used, location 1004 can be patched. A zero represents no special terminal, and no screen clear is used. A one indicates a VT100 (default) and a 2 indicates a VT52. Physical Device Names The devices which FIND searches for files and sub-device files start at location 1006. Up to 20 device names can be included in the list. Each device name must be in RAD50 and the list must be ended with a zero. The program is distributed with one device, SY: RAD50 Values For Various Device Names Name RAD50 Name RAD50 Name RAD50 SY 75250 RK0 71126 DX0 16336 DY0 16406 RK1 71127 DX1 16337 DY1 16407 DM0 15446 DW0 16266 DL0 15376 DM1 15447 LD0 45676 DL1 15377 DU0 16146 LD7 45705 DL2 15400 DU1 16267 VM 105610