 |
HP OpenVMS DCL Dictionary
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]
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.
Qualifiers
/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.
/CLUSTER
Displays the specified user names on all nodes in an OpenVMS Cluster
environment.
/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.
/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.
/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.
/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.
/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.
/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.
/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.
/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.
/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), Return, Enter, Space
|
Get the next page of information.
|
|
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.
/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.
/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.
/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.
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.
|
