This file documents the recent history of this version of SRD. It has been updated through V6.3. -------------------------------------------------------------- This is an improved version of SRD, dated 3-DEC-1980. From: Phil Stephensen-Payne, c/o Systime Ltd., Concourse Computer Centre, 432 Dewsbury Road, LEEDS LS11 7DF, England. This version is intended to combine all the versions of SRD I know of (Ray van Tassle's, Bob Turkelson's and my own) into one (easily tailorable) unit, which can then hopefully be used as a base for future modifications. The changes from 'standard SRD' fall into three categories, as follows:- 1. Those made by:- Ray Van Tassle Motorola 1301 E. Algonquin Rd. Room 4135 Schaumburg, Ill. It has been sporadically updated over the last year and a half, so long that I forgot what it's original base was. I think it was the version distributed with our IAS V 2.0 system. The original SRD had a massive number of bugs, the worst one was probably that it would loose files on a Write-back (but mostly only on very large directories) !!!!!!! This version has had all the bugs I could find fixed, plus a lot of enhancements. Some of the key things are: Write-back works properly, and it also re-tries if it gets an I/O error on the write. It will dynamically expand it's core buffer (via EXTSK$ directive) if the directory won't fit. If the entire directory won't fit, it will do it in chunks, each of which is sorted properly; along with a warning message. A trailer line for each directory is given, showing the number of files in the UFD, and the number of files selected. If a switch that causes the file header to be read is specified (/MI, /FU, or a date switch), the number of blocks used/allocated is also given. A "nolist" switch is added, so you can get the above trailer info, without getting a list of the individual files (very handy for scanning an entire disk). The user write-up has been re-written. On date select, the "before" and "after" dates can now both be specified. The format of the output has been slightly modified so that a simple TECO macro can make a PIP command file to copy (or whatever) the selected files. Two macros to do just that are also on this tape, in my UFD for TECO macros. To use them, do: SRD XXX.CMD=???? TEC XXX.CMD *EISTRIP$$ *EIGET$$ * (any other edit you may want to do) *EX$$ 2. Those made by: BOB TURKELSON NASA/GODDARD SPACE FLIGHT CENTER CODE 934 GREENBELT, MARYLAND 20771 (301) 344-8864 Dave Parker, Henry Tumblin Duke University Medical Center Box 3181 Durham, NC 27710 (919) 684-6804 Support for /CO/LO/MU switches (to select contiguous, locked, or multi-header files). Support selection of files created between two dates when both /BE and /AF are used in the same command line. Yes/No/Quit/Go responses for selective delete (obtained from another version of SRD). Support /OV:[n] switch to select obsolete versions of files, which are those files which would be deleted if the /PU:[n] switch were used, and those which would not be selected if the /SV:[n] switch were specified. This provides a convenient method for users to see their obsolete files, and for system managers to determine which users are not regularly purging their files. Fixes for a few bugs (including the one reported in the October 1979 Multi-Tasker). Remove the requirement that a period must be included in the /SE: switch file specification, even if the file searched for has the null type. If the conditional symbol WILD$ is defined in SRDPRE.MAC, treat the file specification string given in the command line as if it has wild card matching after the name and type fields given, unless /DE, /SD, or /PU is specified (but never if the file specification appears in an /SE: or /SD: switch). A previous version of SRD treated any file specification in this manner, even if it appeared in the /SE: switch. Thus there was no method of obtaining only *.CM files, if any *.CMD files existed, or only TALL.* files if any TALLER.* files existed. The version from the New Orleans tape corrected this problem. However, to list all files beginning with OMSI, one must specify >SRD /SE:OMSI* rather than simply >SRD OMSI . In order to make SRD easier to use in our most common situation, without removing its new capability, we chose to make this modification. If any files are to be deleted, we always require the stricter syntax, to help insure that no file is deleted just because its name may be similar to those being deleted. Support for the /ID switch to identify which version of SRD is being used. Current version is V5.0. Support for the /BF switch which displays how much buffer space is available for use by SRD to read in the directory file. The code for reading the directory file into memory has been modified to read in as much of the directory as possible into memory, compress the directory, then if there is still more to read, attempt to continue reading it in. This seems to work on directories which are large but not logically dense. The dynamic checkpoint allocation does not seem to be working properly and SRD should not be built with this feature until it is resolved. 3. Those made by me:- Phil Stephensen-Payne, c/o Systime Ltd., Concourse Computer Centre, 432 Dewsbury Road, LEEDS LS11 7DF, England. a. Modify SRD.CMD (as developed in 2) to contain all the code for building SRD, thus removing SRDASM.CMD. b. Set up initial values of switch masks from Task Builder GBLDEF statements (and add code to SRD.CMD to set them up), thus allowing users to configure various aspects of SRD defaults (e.g. inclusion/exclusion of [0,0]) as they wish. c. Replace the conditionalised code under WILD$ (from 2) with a pair of switches /WI and /WD. If /WI is set (by specification or task builder parameter) then FRED implies FRED* (and so on). In addition the switch /WD indicates whether such wild-carding is valid for delete operations. Note that if /WI is not specified then FRED will still imply FRED.*, but FRED. will look only for files with a null extension. d. /BF switch (in 2) renamed to /SI (size) to avoid conflict with date switches. e. /DA, /AF and /BE modified to handle inclusion of time and/or date. f. Date handling extended to cover:- /AE = After or on a given date/time. /AF = After (but not on) a given date/time. /BE = Before or on a given date/time. /BF = Before (but not on) a given date/time. /DA = On a given date/time. g. Added /HE to provide help. h. Added /AT to determine whether or not output device should be attached if a terminal. i. Added /M2 to allow a different flavour of 'Middle-Sized Listing' (as developed in 1). If /M2 is not set (by specification or TKB) then the format is as defined by Ray van Tassle viz:- Filename Creation Date/Time Revision Date/Time If it is set, the format is one I prefer, viz:- Filename Filesize CLM flags File ID Creation Date/Time j. Added a /00 switch to specify whether [0,0] should be included in [*,*] searches. k. Added a /SY switch to specify whether system accounts ([0,*] to [10,*]) should be included in [*,*] searches. l. Modified output so that if /RD (Revision Date selection) is specified with a date selection or /MI/M2 the date output is the revision Date instead of the Creation Date. m. Combined the methods of 1 and 2 for coping with big directories, so that now SRD will read the directory a bit at a time (if necessary), compressing as we go (as in 2) and if there is still insufficient room, will do it in chunks (as in 1). As far as I can tell the method works, but I have been unable to test it properly as I cannot now create a directory too big for it to handle (I gave up after about 1600 files - if you have more than that in one directory you've probably got problems anyway!). n. Updated the version to 6.0. For full details on this version of SRD consult SRD.DOC. <<< THE FOLLOWING DOCUMENTS UPDATES FROM THE SRD WORKING GROUP, FALL '81 >>> [352,1]README.1ST - LOS ANGELES FALL 81 - FILES SUBMITTED BY: Bob Turkelson NASA/Goddard Space Flight Center Code 935 Greenbelt, MD 20771 (301) 344-5003 This UIC contains correction files for SRD V6.0, which was submitted to the Spring 1981 Miami RSX SIG tape, in [373,4]. The modifications I made are: o Corrected the problem with SRD.CMD which caused the generation of incorrect initialization defaults when the feature was used. o Changed SRD.CMD so that a different SRD.ODL file is generated when SRD is built with FCSRES. o Corrected a but which prevented /WB/-LI from working properly (the directory was not sorted before the write-back). o Changed SRD so that when the /SE switch is specified, /WI and /WD are ignored; that is, there is no implicit wild-carding whenever the /SE switch is used. o Added the /ZE switch to list zero used block files. o Added code so that if the file attributes area of the header contains a value of 0 for the number of blocks allocated, SRD will calculate the number of allocated blocks from the retrieval pointers. The SLP *.COR files assume the Version 6.0 *.MAC files are in the current UIC, and that they have file version number 1. The correction files create *.MAC;2. Procedure: SLP @SRD.COR ! Corrects all necessary files @SRD ! Asks configuration questions and builds SRD I plan to make additional modifications before the next SIG tape. I will keep Version 6.0 *.MAC files as the base, and add on to these correction files. I would appreciate hearing from those who have made changes or plan to make changes to this version, so we can continue to improve this useful utility. [352,1]README.1ST - END Modifications by: Bob Denny Creative System Design Co. Pasadena, CA (213) 792-9474 ** SRD - Version 6.2 ** Fall 1982 o Altered SRD.CMD for RSX-11M Version 4.0. If you are not running under MCR, it automatically inserts "MCR " before all MCR commands. builds a simple ODL file for V4.0 PLAS FCSRES. Asks if "extend task" directive is supported, and if so, defaults task extension to 1024. o Changed all text and error messages to lower case, in the spirit of 'M Version 4.0. o Spawn for HELP now conditionally assembles for RSX-11M V4 to spawn to CLI... instead of MCR... so command will function with the CLI in current use, rather than always MCR. o Version numbers updated for Version 6.2 o SLP files contain all changes since baseline V6.0 Modifications by: SRD Working Group Bob Turkelson NASA/Goddard Space Flight Center Code 933 Greenbelt, MD 20771 (301) 344-5003 ** SRD - Version 6.3 ** Spring 1983 The modifications made since V6.2 are: o Merged in /SM, /HD, and /BK switches from Glen Everhart's Fall 1982 version ([312,332]). o Added a requirement that a file specification appear on the command line (with or without /SE:) whenever /DE is specified. Command SRD /DE using the previous version deleted every file in the directory, which would surprise you if you had meant to type SRD /BE instead. o Changed SRD so that the command NAME/DE will now delete all NAME.;* files, rather than all NAME.*;* files; that is, when no period is specified in the file specification, SRD will no longer delete all files of any type with that name field. o Corrected bug which caused version number selection to fail to list the proper files in many cases. Sometimes files were listed which should not have been, and sometimes files which satisfied the selection criteria were not listed. o Added Psects to every module (Carl Friedberg, Seaport Systems Inc, NYC) in order to facilitate /MU on MPLUS and perhaps, in the future, use of separate I and D spaces on 44/70/74's. Revised SRD.CMD to process MPLUS/SUPLIB. Flattened out MPLUS version.