                SRD (SoRt Directory) Reference Guide
 
SRD is a utility to list RSX-11 file directories in sorted order.  Switches
allow for selections based on a number of criteria, such as file creation
or revision date and time (before, after, or on), version number (higher
than a specified number, highest versions, lowest versions), file 
characteristics (locked, contiguous, multi-header, zero-length), and
file name (sub-string matching in the file name, type, and or version
number).  In addition, the directory may be written back to the disk in
sorted order.
 
Command format:
     SRD [outfile=][dev:][uic spec][file spec][/switch-1]...[/switch-n]
 
SRD switches are summarized on the next page.
 
Date/time specification for the /AE, /AF, /BE, /BF, /DA switches:
	The optional date and/or time parameters are in the form
	dd-mmm-yy hh:mm   or   hh:mm dd-mmm-yy  .  For example,
	/AF:01-JAN-83 10:30  .
	The date may also be specified without the hyphens:  ddmmmyy.
	If no date is specified, the current date is assumed.  If no
	time is specified, time checks are ignored.  If the /RD switch is
	in effect, the revision date is used; otherwise (/-RD) the 
	creation date is used.
 
Use of wildcards in file name search pattern:
	The pattern in the /SE:pattern switch represents a file specification
	in which some characters represent wildcards, matching any character
	in that position within the name.
	% or ? matches one wildcard character.
	* matches any number (including zero) of wildcard characters.
	Any combination of these characters may be used in any of the
	file name, extension, or version number fields.
	If RSX-11M V4.0 or greater or RSX-11M-PLUS V2.0 or greater is
	being used, the pattern may be used on the command line for the
	file specification without the /SE switch, as long as the ? is
	not used (use % instead) and no wildcard appears in the version
	number field.  The only difference is that the /WI switch, if
	specified or the default, is in effect for file specifications
	appearing without the /SE switch.
 
Sorting key specification:
	The major and minor keys for the sort may be specified as values in
	the /SR: switch.  The major key appears first.  The specification
	for each key consists of one or two letters.  The first letter 
	specifies the field to sort:
	  N - File Name;  T - File Type;  V - File Version;  D - File Date
	The second letter specifies the sort order, ascending or descending.
	D specifies a descending sort (ND, TD, VD, DD).  The sort will be 
	ascending if no character follows the key letter.
	The default is /SR:T:N:VD for /-NA.  It is /SR:N:T:VD for /NA.
	If only one or two of these three keys are given, the other keys
	are still used according to the default ordering.  For example,
	/SR:ND implies /SR:ND:T:VD.
	Restrictions:  (a) Null key fields are not allowed.
	(b) In order to specify one of the version selection switches 
	(/NV, /SV, /OV, or /PU), Name and Type (ascending or descending)
	must be the first two sort keys (either order), and Version 
	(ascending or descending) must be the third key.
SRD V6.6 - Spring 1985
 
                        SRD Switches
 
Listing format:
_______________
   /BK    	Precede each file name with 2 blank characters.
   /CM:xxx:xx	Generate command file format
   /HD		Display command line in header.	
   /FU:n  	Full Directory listing (with width "n", 72<=n<=132).
   /LI		Brief directory listing; suppress listing with /-LI.
   /M2    	Type 2 middle directory listing.
   /MI		Middle Directory listing (2 types - /M2 and /-M2).
   /PA		Pack file names (remove any blanks after name and type)
   /SM    	Include summary lines following the files listed.
   /TB		Include total number of blocks in summary lines.
File name selection:
____________________
   /NE    	Select files not matching the file name/type/version criteria.
   /SE:pattern	Use special wildcards for file name matching.
Date selection:
_______________  (The previous page describes the format of dtspec.)
   /AE:dtspec	Select files created on or after specified date(/time).
   /AF:dtspec 	Select files created after (but not on) specified date(/time).
   /BE:dtspec	Select files created on or before specified date(/time).
   /BF:dtspec	Select files created before (but not on) specified date(/time).
   /DA:dtspec 	Select files created on specified date(/time).
   /RD    	Use revision date in date selection, /MI/M2 listing, and
		  sorting by date.
Version selection:
__________________
   /HV:n  	Select files with version number >= "n" (default n = 2).
   /NV:n	Select "n" newest (highest) versions (default n=1);
		n=-1 selects oldest version.
   /OV:n  	Select obsolete versions:  all but "n" highest versions
		  (default n=1);  n=-1 selects all but oldest version.
   /SV:n	Same meaning as /NV:n.
File attribute selection:
_________________________
   /CO    	Select files with the contiguous attribute.
   /FI:n	Select file with file ID n (omit sequence number).
   /FO:[g,m]	Select files by file owner; may be negated (/-FO:[g,m])
   /GT:n	Select files with n or more blocks allocated.
   /LO    	Select locked files.
   /MU    	Select multi-header files.
   /ZE    	Select files with zero blocks used.
File maintenance:
________________
   /DE    	Delete files meeting the specification criteria.
   /PU:n  	Purge all but "n" highest versions in the directory
		  (default n=1);  n=-1 deletes all but the oldest version.
   /SD:pattern	Selectively delete files.
   /WB    	Write back the directory to disk in sorted order.
Miscellaneous switches:
_______________________
   /00    	Include [0,0] in [*,*] searches.
   /AP    	Append listing to an existing file.
   /AT    	Attach output device if a terminal.
   /HE    	Display help file.
   /ID    	Print current version number of SRD.
   /NA    	Sort by file name first, then by file type.
   /SI    	Print available buffer size.
   /SP    	Spool the output file.
   /SR:x:x:x:x 	Sort the directory listing according to sort keys specified;
		negate (/-SR) to list files in same order as in the directory.
		Ascending keys:   N  - Name; T  - Type; V  - Version; D  - Date;
		Descending keys:  ND - Name; TD - Type; VD - Version; DD - Date.
   /SY		Include system UFD's (group 1-10) in [*,*] and [*,n] searches.
   /WD    	Implicit wildcarding during delete.
   /WI    	Implicit wildcarding.
 
