AAAREADME.TXT							12/01/92

				Brian Lomasky
			      c/o TERADYNE, INC.
			321 Harrison Ave., Mail Stop H87
			      Boston, MA  02118
			       (617) 422-2259

The DIRECTORY command has always been missing a few notable features:

   1) The ability to display a directory listing sorted by file type.
   2) The ability to display a directory listing sorted by creation date.
   3) The ability to display a directory listing sorted by revision date.
   4) The ability to display a directory listing sorted by file (end-of-file
      or allocated) size.  (Especially useful when you really want to know the
      ten most largest files on a disk!)
   5) The ability to display just the File Id, File Organization, Record Type
      Attributes, and/or Carriage Control Attributes, without having to resort
      to a DIRECTORY/FULL command.

This has been solved by a new utility which can display sorted (and unsorted)
directory listings in many different forms.

The utility is called is called:  DS

Define DS as a foreign DCL command.  Example:
    (assuming that DS.EXE has been placed in a directory called TOOLS:)

	$ DS :== $TOOLS:DS

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

The syntax for the DS utility is:

	DS [filespec][/qualifier(s)]
		    or
	DS [/qualifier(s)][filespec]

(which is similar to the normal DIR utility); Note that the filespec may appear
either before all of the qualifiers or after all of the qualifiers (separated
by at least one space or tab, of course).  The qualifiers (which may be
abbreviated so long as they're umambiguous) specify which fields are to be
printed and/or sorted, as well as some other functions.

The possible fields (other than the normal device/directory/name/type/version)
which can be printed by specifying one or more of the qualifiers are:
	File Allocation Size         (as shown by DIRECTORY/SIZE=ALLOCATION)
	File EOF Size                (as shown by DIRECTORY/SIZE)
	Creation Date                (Date and time as MM/DD/YY HH:MM:SS)
	Revision Date                (Date and time as MM/DD/YY HH:MM:SS)
	File ID                      (3-word internal File ID)
	File Organization            (Sequential, Relative, Indexed, etc)
	Record Type Attributes       (Fixed length, Variable Length, etc)
	Carriage Control Attributes  (Fortran, Carriage Return, Print, etc)

You can also cause the report to be sorted (in ascending or descending order)
by any of the following fields.  (Note that specifying a sorted field will
also cause that field to be printed on the report):
	File Allocation Size
	File EOF Size
	Creation Date
	Revision Date
	File Type
You can specify as many sort specifications as you want; multiple
specifications will cause subsequent secondary sorts to be performed after
the first (primary) sort specification has been performed.  If you do not
specify any of the sort qualifiers, the report will be automatically sorted
in ascending order by the File Type.

Miscellaneous qualifiers allow you to specify any of the following options:

  1) Create comma-delimitted output fields (with no header or trailer) (so that
     you can take the output of this utility and easily read it from DCL).

  2) Display each device/directory name as it's processed.

  3) Cause the sort to not "page break" on each new directory (useful when you
     want to sort by the largest file size on an entire disk volume, regardless
     of which directory the file is in).

  4) Suppress the normal directory header and/or trailer lines.

  5) Specify an output device/filespec, instead of the normal terminal output.

  6) Specify the print width for the device:[dir]name.typ;ver fields.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

If you type:  DS ?
         or:  DS /HELP

a help screen will be displayed listing all of the possible options.

SYSUAF - System UAF reporting tool

DEC's AUTHORIZE utility has two reporting options for the SYSUAF.DAT file:

	1) Too little (AUTHORIZE LIST/BRIEF)

	2) Too much (AUTHORIZE LIST/FULL)

This is almost useless for meeting the system manager's requirements of
maintaining and monitoring the SYSUAF and its users.

SYSUAF V5.47 is a reporting program for the SYSUAF and RIGHTSLIST data files.

You can print reports either to the screen, to a data file (SYSUAF.LIS), or to
create a DCL command procedure (SYSUAF.COM) which can then be easily edited and
then executed.

Many options including merging UAF files are provided.