!*******************************************************************************
!* WHAT                                                                        *
!*      Verb that returns various combinations of user formats from different  *
!* nodes.                                                                      *
!*******************************************************************************

define verb what
        image what_dir:what

        qualifier node, value(required, type=$file, list) ! Get specified nodes
        qualifier select, value(required, type=$file)     ! Select a particular group of nodes

        qualifier user, value(required, type=$file)       ! Select a particular user

        qualifier brief, default, negatable               ! In show users format
        qualifier full, negatable                         ! In where/users format
        qualifier all                                     ! Show all the processes
        qualifier status, negatable                       ! Output status lines only

        qualifier silent                                  ! Dont output errors talking to the nodes
        qualifier total, negatable                        ! Total up /STATUSes
        qualifier header, default, negatable              ! Do we want the header line present

        qualifier output, value(required, type=$file)     ! Send output to a file name

        disallow select and node
        disallow brief and all
        disallow brief and full
        disallow total and (full or all or brief)
        disallow status and (all or brief or full or user)

!*******************************************************************************
!* Note:  The /SELECT qualifier will take a given value, and translate the     *
!*      logical name WHAT_value to get a list of the nodes to get info on.     *
!*      For instance, WHAT/SELECT=CLUSTER would translate the logical name     *
!*      WHAT_CLUSTER and talk to all the nodes there.  Define WHAT_value       *
!*      in this manner:                                                        *
!*                                                                             *
!*      DEFINE WHAT_cluster node0, node1, node2, ... , nodeN                   *
!*                                                                             *
!*      Using this technique, one could set up various combinations of         *
!*      nodes to be search, i.e. One for your cluster, you local network,      *
!*      specific work nodes, etc.                                              *
!*******************************************************************************