1 WHAT
 WHAT

 Invokes the WHAT utility to report user information on one or
 more VMS systems in the network.  WHAT with no qualifiers produces
 a "SHOW USERS" like display of users on the current system.

 WHAT is an RIT developed utility

2 Qualifiers

/ALL

 /ALL

 Directs WHAT to include system processes in the display.  This
 qualifier generates the same display format as /FULL. This qualifier
 is ignored unless it is specified with /FULL.

/BRIEF

 /BRIEF (Default)

 Directs WHAT to produce a SHOW USERS like display.  This is the
 default action for WHAT.

/FULL

 /FULL

 Directs WHAT to expand the /BRIEF to provide a more detailed list of
 user processes on the specified node(s)

/HEADER

 /HEADER (Default)
 /NOHEADER

  Specifies whether or not a header line precedes the report
/USERNAME

 /USERNAME=string

  1) Directs WHAT to subset the report generated by /BRIEF, /FULL and
     /FULL/ALL to include only those processes that belong to a
     username beginning with "string".

  2) If the user has defined a logical name "WHAT_USER_string" then WHAT
     will translate this logical name for a list of users to use in the
     subset operation.  Logical Names may have up to 127 translations.
/STATUS

 /STATUS

  Directs WHAT to produce a one line system status report for each of
  the specified nodes.

/SILENT

 /SILENT
 /NOSILENT (Default)

  Directs WHAT to not display the VMS error messages that are caused
  by inability to connect to any remote nodes.

/TOTAL

 /TOTAL

 Directs WHAT to report a total line of Processes, Users and Batch
 jobs. This qualifier applies only to the /STATUS qualifier.

/OUTPUT

 /OUTPUT=filename

  Redirects the report from WHAT to the specified filename.  The filename
  is required when /OUTPUT is specified.
/NODE

 /N0DE=(NODE[,...])

  Specifies one or more nodes for WHAT to query. Do NOT specify
  the nodename with two colons "::"
/SELECT

 /SELECT=xxxxx

  Directs WHAT to translate the logical name WHAT_xxxxx for the list
  of nodes to translate.  There are a set of default node groups defined
  on the system.  These may be determined by the DCL command:

        $ SHOW LOGICAL/SYSTEM WHAT_*

  You may define your own groups of interest as follows:

        $ DEFINE WHAT_ME VAXA,VAXB,VAXC

  The command WHAT/SELECT=ME  will report on the nodes VAXA, VAXB and
  VAXC.

2 Examples

 1)   $ WHAT/SELECT=RITVAX

        Generates a SHOW USERS like display of all users logged in to
        the RITVAX VAXcluster.


 2)   $ WHAT/NODE=(VAXA,VAXB,VAXIMG)

        Generates a SHOW USERS like display of all users logged in to
        The nodes VAXA, VAXB and VAXIMG

 3)   $ WHAT/SELECT=RITVAX/STATUS

        Generates a report of system utilization on all systems in
        the RITVAX cluster

 4)   $ WHAT/FULL/SELECT=RITVAX/USER=BE

        Generates a full users report for all users who have a username
        beginning with the string "BE"

 5)    Logical Lists

       You may define a list of users for use in the /USER subsetting
       operations as a list as follows.

        $ define WHAT_USER_MYLIST -
           ABC1234,-
           BCDICS, -
           999DEPT,-
           JKL9876

        $ WHAT/SELECT=RITVAX/USER=MYLIST

         Causes WHAT to look for specified users in WHAT_USER_MYLIST
         on RITVAX

2 Authors

        Pete Portante, (most of the work)

        Andrew W. Potter
        David Mulvihill
        Rochester Institute of Technology

        Distributed and supported by:

        Andrew W. Potter
        Systems Programmer
        Information Systems and Computing
        Rochester Institute of Technology
        Rochester NY, 14623  PH (716) 475-6994
        Email:    awpsys@ritvax.BITNET
                  awp8101@ritcv.UUCP

        Any Questions please send Electronic Mail
