WESTAT UTILITIES

    This directory contains a number of utilities of general use.
Most of them are documented with help files of the same name with
the .HLP qualifiers.  All are written in PL/I or MACRO.  To run
them include the logical name assignment

    $ ASSIGN/SYSTEM (this directory) WES$UTILITIES

in SYSTARTUP.COM or a similar assignment with /SYSTEM in your LOGIN.COM.
If you recompile and relink them you need to specify WES$LIBRARY:WESLIB.TLB
as a text library for the compiler and WES$LIBRARY:WESLIB.OLB
as an object module library for the linker (See a parallel directory). 

To report bugs please contact Allan Jaworski or Alan Cutler at Westat
(301)-251-1500.

A brief description of each utility follows:


DUMPLIST--
    Produces a formatted dump of data on a tape.  The dump is especially
readable since nonprintable characters are dumped in hex format while
printable characters are printed directly.  To run use:

    $ DUMPLIST:==$WES$UTILITIES:DUMPLIST
    $ DUMPLIST options and parameters


SASLIST--
    Similar to DUMPLIST but dumps a disk data set.  Both DUMPLIST and
SASLIST are modeled on the LIST facility of the Statistical Analysis
System (SAS).

    $ SASLIST:==$WES$UTILITIES:SASLIST
    $ SASLIST options and parameters


FIXED,VARIABLE--
    Interactive programs to change file in variable length format to fixed
length and vice versa. 
  
    $ FIXED:==RUN WES$UTILITIES:FIXED
    $ FIXED

    $ VARIABLE:==RUN WES$UTILITIES:VARIABLE
    $ VARIABLE


FREQ,XTAB--
    Easy to use interactive/batch procedures for producing frequencies
and crosstabulations of selected character fields in files.  They
both may be used to create command files which may be repeatedly
run in interactive or batch mode.  Since both procedures do no
data conversion, they run considerably faster than most statistical
packages.

    $ FREQ:==$WES$UTILITIES:FREQ
    $ FREQ file options

    $ XTAB:==$WES$UTILITIES:XTAB
    $ XTAB file options


HOG--
    A system monitoring procedure useful in spotting processes that
hog important resources.  HOG must be run from a VT100-compatible
terminal.  Must be run from a privileged account.

    $ HOG:==RUN WES$UTILITIES:HOG
    $ HOG


FOREIGN--
    An interactive utility for reading and writing IBM and other foreign
format tapes.  It's better than most we have seen so far in the DECUS
library but still needs some improvement.  Prompting is self-explanatory. 

    $ FOREIGN*_TAPE:==RUN WES$UTILITIES:FOREIGN
    $ ALLOC MT: TAPE
    $ MOUNT/FOREIGN TAPE
    $ FOREIGN


SAMPLE--
    A program to copy a sample of a file to another file.  Several types
of sampling methodology are supported.

    $ SAMPLE:==RUN WES$UTLITIES:SAMPLE
    $ SAMPLE


SUSPENDN,RESUMEN--
    A tool to help the system manager to suspend and resume processes
when needed to aid system throughput.
  
    $ SUSPENDN:==$WES$UTILITIES:SUSPENDN
    $ SUSPENDN process name

    $ RESUMEN:==$WES$UTILITIES:RESUMEN
    $ RESUMEN process name