 
		       SRD - Sort Directory Utility
 
 
 SRD is a utility that can be used to examine the contents of a users
 directory (e.g. a listing of all the files that the user has created)
 and/or delete selected entries (files).
 
 The files can be listed alphabetically, by extension (default) or by name.
 The files can be viewed selectively, by partial name, character string,
 extension or date.
 
 In much the same way that the files can be listed or selectively viewed,
 the user can be prompted, (one file at a time and in order), to delete or
 not delete an entry (file).
 
 For additional information, type:
 
		   HELP SRD  Command   The SRD Command Line
			     Switch    List of SRD switches (options)
 
2 COMMAND
 
			  SRD COMMAND LINE
 
 
     The following is the SRD command line:
 
		SRD <outfile> = <dev:><[uic]><string></switch>
 
     where  outfile  file or device where the listing will be sent; default
		     is to TI: (the device you are logged onto.)
	    dev      device where the directory is stored; default is to
		     SY:  colon (:) is required syntax.
	    uic      user file directory to be examined or modified; default
		     is to current UIC; brackets ( [] ) are required syntax.
	    string   character string to be used to selectively access files;
		     default is all files.
	    switch   any combination of allowable SRD switches; default is
		     LI;  slash (/) is required syntax.
 
    For additional information, type:   HELP SRD STring
						 SWitch
 
2 STRING
 
			    SRD STRING
 
 
    A selective access of the directory (listing of files) can be accomplished
    with a sub-string match.  The selection is satisfied if the end of the
    string is reached without finding a character in the filename that does
    not match.  If a period (.) is found in the string, the comparison is made
    between the characters following the period in the string and those
    following the period in the filename.
 
	      Example:  DA   would match  DATA.SCT, DAYLITE.TXT & DA.FTN
			E.T  would match  ENERGY.TXT & ELEMENT.TSK
		       .DAT  would match  YOUR.DAT, OUR.DAT & THERE.DAT
 
2 SWITCH
 
			    SRD SWITCHES
 
		 /AF - after and inclusive of a date
		 /BE - before and inclusive of a date
		 /DA - on a date
		 /FU - full listing of directory
		 /LI - no listing
		 /NA - sort by name
		 /SD - selective delete
		 /SE - selective list
		 /SV - select version
		 /WB - write back
 
     For additional information, type:
 
	    HELP SRD /switch     where switch is one of the above.
 
	      Example:  HELP SRD /NA
 
2 /LI
# /FU
2 /FU
 
			     SRD LISTING SWITCHES
 
       /LI    short listing that includes the name, extension and version
       /-LI   suppresses the listing of filenames
       /FU:n  full listing that, in addition to the above, includes
 
			 1. Creation date and time.
			 2. File size (used and allocated)
			 3. File ID
			 4. Owner UIC
			 5. Protection code
 
	      The :n is optional and if specified, is the width of the listing
	      (normally the screen width)
 
    NOTE: All of the above can be used with any other SRD switch or string.
	  If used alone they will produce an alphabetic listing of all files
	   in the directory by extension and name.
 
2 /WB
 
			  /WB      Write Back
 
    A directory may be permanently sorted (or at least until more files
    are added) by use of the /WB switch.
 
	      Example:  DK3:/WB   will alphabetically sort the user's directory
				  on DK3:
 
2 /SE
 
			  /SE      Selective Extent
 
    There are cases in which the user would like to have only part of his
    directory listed.  For example all files beginning with 'B', or having
    the first three letters 'TSK', or having a '.BAS' extension.  This may
    be done using the /SE switch.  The format is /SE:xyz where xyz is any
    character string to search for.  Wildcards (*) may be used to specify
    any name, extension, or a version as a match.  In addition the '?' may
    be used to indicate that any single character found in the specified
    position is a match.
 
	  Exanmple:  /SE:HEL???.CMD,HELBLD.CMD,HELASM.CMD
 
2 /AF
#DA
2 /BE
#DA
2 /DA
 
		  /DA   Date      /AF   After      /BE   Before
 
    SRD may be used to list only those files produced on a given date, after
    a given date, or before a given date.
 
	  /DA                   list all files produced today
	  /DA:DD-MMM-YY         list all files created on DD-MMM-YY. (14-JAN-78)
	  /AF:DD-MMM-YY         list all files created after  DD-MMM-YY.
	  /BE:DD-MMM-YY         list all files created before DD-MMM-YY.
 
2 /SD
 
			  /SD      Selective Delete
 
    /SD may be used in combination with any of the display switches ( /NA,
    /DA, /AF, /BE, /LI, /FU, /SE) to selectively delete those files  no
    longer needed.  If this option is chosen, the user will be prompted to
    delete or not to delete a given file.  A Y(es) response will wipe off
    file.  Any other response will cause no action to be taken.  The user
    will be prompted for those files that would have been displayed had the
    /SD switch not been used.
 
    /DE may be used in conjunction with /SD, in which case, the user will
    not be prompted and all specified files will be deleted.
 
2 /NA
 
			  /NA      Name
 
    /NA will list the specified files, sorted alphabetically by name and
    (then by) extension.
