HELPLIB.HLB  —  SHOW  USERS
    Displays the user name and node name (in an OpenVMS Cluster
    environment) of interactive, subprocess, and batch users on the
    system.

    Format

      SHOW USERS  [username]

1  –  Parameter

 username

    Specifies the user about whom you want information. The asterisk
    (*)  and the percent sign (%) wildcard characters are allowed.
    If you specify a string, all users whose user names begin with
    the string are displayed. For example, if you specify the string
    MAR, all user names that begin with MAR are displayed. If no user
    exists whose name matches the specified string, an informational
    message tells you that no processes were found.

    If you omit the username parameter, a list of all interactive,
    subprocess, and batch users is displayed.

2  –  Qualifiers

2.1    /BATCH

       /BATCH
       /NOBATCH

    Displays all batch users in the OpenVMS Cluster environment. To
    restrict the display to users on specific nodes, use the /BATCH
    qualifier with the /NODE qualifier. When you use the /NOBATCH
    qualifier, all batch users are excluded from the display.

2.2    /CLUSTER

    Displays the specified user names on all nodes in an OpenVMS
    Cluster environment.

2.3    /EXACT

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a
    search string that must match the search string exactly and must
    be enclosed with quotation marks (" ").

    If you specify the /EXACT qualifier without the /SEARCH
    qualifier, exact search mode is enabled when you set the search
    string with the Find (E1) key.

2.4    /FULL

    Displays the user name, the node name, the process name,
    the process identification (PID) code, terminal names (both
    virtual and physical), and port information of all interactive,
    subprocess, and batch users on the system.

2.5    /HEADING

       /HEADING (default)
       /NOHEADING

    Displays a heading line above the system output. When you use
    the /NOHEADING qualifier, the heading line is excluded from the
    display.

2.6    /HIGHLIGHT

       /HIGHLIGHT[=keyword]

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the
    type of highlighting you want when a search string is found. When
    a string is found, the entire line is highlighted. You can use
    the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD
    is the default highlighting.

2.7    /INTERACTIVE

       /INTERACTIVE
       /NOINTERACTIVE

    Displays all interactive processes held by users in the OpenVMS
    Cluster environment. To restrict the display to users on specific
    nodes, use the /INTERACTIVE qualifier with the /NODE qualifier.
    When you use the /NOINTERACTIVE qualifier, all interactive
    processes held by users in the OpenVMS Cluster environment are
    excluded from the display.

2.8    /NETWORK

       /NETWORK
       /NONETWORK

    Displays all network users in the OpenVMS Cluster environment. To
    restrict the display to users on specific nodes, use the /NETWORK
    qualifier with the /NODE qualifier. When you use the /NONETWORK
    qualifier, all network users in the OpenVMS Cluster environment
    are excluded from the display.

2.9    /NODE

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

    Displays all interactive, subprocess, and batch users on the
    specified node or nodes. If you enter the /NODE qualifier without
    a value, the qualifier displays all the interactive, subprocess,
    and batch users on the local node.

2.10    /OUTPUT

       /OUTPUT[=filespec]
       /NOOUTPUT

    Controls where the output of the command is sent. By default,
    the output of the SHOW USERS command is sent to the current
    SYS$OUTPUT device (usually your terminal). To send the output
    to a file, use the /OUTPUT qualifier followed by a file
    specification.

    The asterisk (*)  and the percent sign (%) wildcard characters
    are not allowed in the file specification. If you enter a partial
    file specification (for example, specifying only a directory),
    SHOW is the default file name and .LIS is the default file type.

    If you enter the /NOOUTPUT qualifier, output is suppressed.

2.11    /PAGE

       /PAGE[=keyword]
       /NOPAGE (default)

    Controls the display of user information on the screen.

    You can use the following keywords with the /PAGE qualifier:

    CLEAR_SCREEN   Clears the screen before each page is displayed.

    SCROLL         Displays information one line at a time.

    SAVE[=n]       Enables screen navigation of information, where n
                   is the number of pages to store.

    The /PAGE=SAVE qualifier allows you to navigate through screens
    of information. The /PAGE=SAVE qualifier stores up to 5 screens
    of up to 255 columns of information. When you use the /PAGE=SAVE
    qualifier, you can use the following keys to navigate through the
    information:

    Key Sequence              Description

    Up arrow key, Ctrl/B      Scroll up one line.
    Down arrow key            Scroll down one line.
    Left arrow key            Scroll left one column.
    Right arrow key           Scroll right one column.
    Find (E1)                 Specify a string to find when the
                              information is displayed.
    Insert Here (E2)          Scroll right one half screen.
    Remove (E3)               Scroll left one half screen.
    Select (E4)               Toggle 80/132 column mode.
    Prev Screen (E5)          Get the previous page of information.
    Next Screen (E6),         Get the next page of information.
    Return, Enter, Space
    F10, Ctrl/Z               Exit. (Some utilities define these
                              differently.)
    Help (F15)                Display utility help text.
    Do (F16)                  Toggle the display to oldest/newest
                              page.
    Ctrl/W                    Refresh the display.

    The /PAGE qualifier is not compatible with the /OUTPUT qualifier.

2.12    /SEARCH

       /SEARCH="string"

    Use with the /PAGE=SAVE qualifier to specify a string that you
    want to find in the information being displayed. Quotation marks
    are required for the /SEARCH qualifier, if you include spaces in
    the text string.

    You can also dynamically change the search string by pressing the
    Find key (E1) while the information is being displayed. Quotation
    marks are not required for a dynamic search.

2.13    /SUBPROCESS

       /SUBPROCESS
       /NOSUBPROCESS

    Displays all subprocess users in the OpenVMS Cluster environment.
    To restrict the display to users on specific nodes, use the
    /SUBPROCESS qualifier with the /NODE qualifier. When you use
    the /NOSUBPROCESS qualifier, all subprocess users in the OpenVMS
    Cluster environment are excluded from the output.

2.14    /WRAP

       /WRAP
       /NOWRAP (default)

    Use with the /PAGE=SAVE qualifier to limit the number of columns
    to the width of the screen and to wrap lines that extend beyond
    the width of the screen to the next line.

    The /NOWRAP qualifier extends lines beyond the width of the
    screen and can be seen when you use the scrolling (left and
    right) features provided by the /PAGE=SAVE qualifier.

3  –  Examples

    1.$ SHOW USERS
            OpenVMS User Processes at 12-MAY-2001 10:37 AM
          Total number of users = 4,  number of processes = 14

       Username     Node     Interactive  Subprocess   Batch
       S_SKONETSKI BBBBBB            1
       WISNIEWSKI  XXXXXX            4         2
       HIBBITS     AAAAAA            1         4
       VAXMAN      AAAAAA            2

      The SHOW USERS command in this example displays the user names
      and node names of all current interactive, subprocess, and
      batch users on the system.

    2.$ SHOW USERS/NOHEADING/OUTPUT=SYSUSERS.DAT
      $ TYPE SYSUSERS.DAT
       S_SKONETSKI BBBBBB            1
       WISNIEWSKI  XXXXXX            4         2
       HIBBITS     AAAAAA            1         4
       VAXMAN      AAAAAA            2

      The SHOW USERS command in this example displays the user names
      and node names of all current interactive, subprocess, and
      batch users on the system without the heading text using the
      /NOHEADING qualifier. Using the /OUTPUT qualifier, you can
      write the output to a file for processing or later review.

    3.$ SHOW USERS *LES*
            OpenVMS User Processes at 12-MAY-2001 10:41 AM
          Total number of users = 3,  number of processes = 10

       Username     Node     Interactive  Subprocess   Batch
       THALES      MILETS            -         -          1
       PRAXITELES  LESBOS            5         2
       PERICLES    ISLAND            1

      The SHOW USERS command in this example displays the user name
      and node names of all users whose user names contain the string
      LES.

    4.$ SHOW USERS/FULL/NODE=AAAAAA
            OpenVMS User Processes at 9-JUN-2001 02:23 PM
          Total number of users = 3,  number of processes = 3

       Username    Node   Process Name    PID     Terminal
       DJONES     AAAAAA  Aaaaaa_fta2:  2180012D  FTA2:
       DYSLI      AAAAAA  DYSLI         2180011A  FTA1:
       SINDBY     AAAAAA  SINDBY        2180011E  RTA1:   (JJJJJ::SINDBY)
      <LOGIN> B4B4    _WSA1         3100009F

      The SHOW USERS command in this example displays the user name,
      the local node, the process name, the process identification
      (PID) number, the terminal names (both virtual and physical),
      and port information for all interactive, subprocess, and batch
      users on system AAAAAA. A user name of <LOGIN> indicates that
      someone is in the process of logging in.

    5.$ SHOW USERS /NODE=(AAAAAA,BBBBBB,MMMMMM)
            OpenVMS User Processes at 9-JUN-2001 02:23 PM
          Total number of users = 5,  number of processes = 7

       Username    Node   Process Name    PID     Terminal
       BRICKLEY   BBBBBB  BRICKLEY      21E0009E  RTA1:  (CBREEZ::BRICKLEY)
       DCLDCT     MMMMMM  Mmmmmm_rta1:  2020015D  RTA1:  (MMMMMM::DJOHNSON)
       SMITH      AAAAAA  Aaaaaa_fta2:  2180012D  FTA2:
       PETERSON   MMMMMM  Mmmmmm_fta1:  2020013E  FTA1:
       PRESTON    MMMMMM  Mmmmmm_rta3:  20200184  RTA3:  (DDRSND::PRESTON)
       PRUSS      AAAAAA  PRUSS         2180011E  RTA1:  (IVOK::PRUSS)
       RABAHY     AAAAAA  RABAHY        2180011A  FTA1:

      The SHOW USERS command in this example displays the user name
      and node name for all interactive, batch, and subprocess users
      on the nodes AAAAAA, BBBBBB, and MMMMMM.
Close Help