34.1 – Parameter
device-name[:]
Specifies the name of the terminal for which you want the
characteristics displayed. The default is your terminal
(SYS$COMMAND).
34.2 – Qualifiers
34.2.1 /BRIEF
Displays a subset of more commonly used terminal characteristics.
34.2.2 /FULL
/FULL (default)
Displays all terminal characteristics.
34.2.3 /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter the /OUTPUT qualifier
without a file specification, the output is sent to the current
process default output stream or device, identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS the default file type. If you
enter a file specification, it cannot include the asterisk (*)
and the percent sign (%) wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
34.2.4 /PERMANENT
Requires LOG_IO (logical I/O) or PHY_IO (physical I/O) privilege.
Displays the permanent characteristics of the terminal.
34.3 – Examples
1.$ SHOW TERMINAL/BRIEF
Terminal: _RTA1: Device_Type: VT300_Series Owner: _RTA1:
Username: REHOR
Terminal Characteristics:
Speed: 9600 Page: 62 Width: 80
No Remote Hostsync TTsync
No Modem Broadcast Wrap
No Hangup No Disconnect Overstrike editing
No Dialup Application keypad Line Editing
In this example, the SHOW TERMINAL command displays a subset of
the more commonly used terminal characteristics.
2.$ SHOW TERMINAL/FULL
Terminal: _TTE4: Device_Type: VT102 Owner: FRANKLIN
Physical Terminal: _LTA49
Input: 9600 LFfill: 0 Width: 80 Parity: None
Output: 9600 CRfill: 0 Page: 24
Terminal Characteristics:
Interactive Echo Type_ahead No Escape
No Hostsync TTsync Lowercase Tab
Wrap Scope No Remote Eightbit
Broadcast No Readsync No Form Fulldup
No Modem No Local_echo No Autobaud Hangup
No Brdcstmbx No DMA No Altypeahd Set_speed
Line Editing Overstrike editing No Fallback No Dialup
No Secure server No Disconnect No Pasthru No Syspassword
No SIXEL Graphics Soft Characters Printer port Numeric Keypad
ANSI_CRT No Regis No Block_mode Advanced_video
Edit_mode DEC_CRT DEC_CRT2 No DEC_CRT3
In this example, the SHOW TERMINAL command displays the
characteristics of this specific terminal. If you are
displaying statistics about a terminal allocated to another
user, the input, output, LFfill, CRfill, width, page, and
parity statistics are not shown (see the next example).
3.$ SHOW TERMINAL/FULL
Terminal: _RTA1: Device_Type: VT300_Series Owner: _RTA1:
Username: VILLA
Remote Port Info: NODE12::VILLA
Input: 9600 LFfill: 0 Width: 80 Parity: None
Output: 9600 CRfill: 0 Page: 62
Terminal Characteristics:
Interactive Echo Type_ahead No Escape
Hostsync TTsync Lowercase Tab
Wrap Scope No Remote Eightbit
Broadcast No Readsync No Form Fulldup
No Modem No Local_echo No Autobaud No Hangup
No Brdcstmbx No DMA No Altypeahd Set_speed
No Commsync Line Editing Overstrike editing No Fallback
No Dialup No Secure server No Disconnect No Pasthru
No Syspassword SIXEL Graphics No Soft Characters Printer port
Application keypad ANSI_CRT Regis No Block_mode
Advanced_video Edit_mode DEC_CRT DEC_CRT2
DEC_CRT3 No DEC_CRT4 No DEC_CRT5 Ansi_Color
VMS Style Input <CTRL-H> Delete
In this example, the SHOW TERMINAL command displays the full
terminal characteristics.
35 – TIME
Displays the current date and time.
Format
SHOW [DAY]TIME
35.1 – Example
$ SHOW TIME
3-NOV-2001 00:02:00
The SHOW TIME command in this example displays the current date
and time.
36 – TRANSLATION
Displays the first translation found for the specified logical
name. You can specify the tables that are searched.
Requires read (R) access to a logical name table to display
information about any logical name cataloged in that table.
Format
SHOW TRANSLATION logical-name
36.1 – Parameter
logical-name
Specifies the logical name whose translation you want to display.
36.2 – Qualifier
36.2.1 /TABLE
/TABLE=name
Searches the specified table. The default value for the name
parameter is LNM$DCL_LOGICAL.
If you specify the table name by using a logical name that
translates to more than one table, then each table is searched
in the order specified until a match is found.
36.3 – Examples
1.$ SHOW TRANSLATION PAYROLL
PAYROLL = DISK1:[ACCOUNTS.WORKING]FACTOR1.DAT;37 (LNM$PROCESS_TABLE)
The SHOW TRANSLATION command in this example displays the
translation for the logical name PAYROLL and also displays
the name of the table where the logical name was found. In this
example, PAYROLL was found in LNM$PROCESS_TABLE, the process
logical name table.
2.$ DEFINE DISK DKA1:
$ DEFINE/GROUP DISK DKA2:
$ SHOW TRANSLATION DISK
DISK = DKA1:(LNM$PROCESS_TABLE)
The DEFINE commands in this example place entries for the
logical name DISK in both the process and group logical
name tables. Then, the SHOW TRANSLATION command shows the
translation associated with the logical name DISK. By default,
the process, job, group, and system tables are searched (in
that order). The first match found is displayed. The logical
name DISK from the process table (LNM$PROCESS_TABLE) is
displayed because it is found before the name DISK in the group
table.
3.$ RUN ORION
<Ctrl/Y>
$ SHOW TRANSLATION TERMINAL
TERMINAL = _TTT3: (LNM$PROCESS_TABLE)
$ CONTINUE
The RUN command in this example executes the image ORION.EXE.
After the Ctrl/Y function interrupts the image, the SHOW
TRANSLATION command displays a logical name assignment. The
CONTINUE command resumes the execution of the image.
4.$ SHOW TRANSLATION/TABLE=LNM$SYSTEM USER
USER = "DKA2:" (LNM$SYSTEM_TABLE)
The SHOW TRANSLATION command in this example displays the
translation for the logical name USER. Because a table name
is specified, the SHOW TRANSLATION command does not use the
default search order. Only the specified table, LNM$SYSTEM, is
searched. LNM$SYSTEM is the system logical name table.
5.$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY MYPROC -
_$ TEST_TABLE, LNM$PROCESS
$ SHOW TRANSLATION/TABLE=MYPROC FILER
FILER = "[SMITH.FILER]" (TEST_TABLE)
In this example, MYPROC defines a list of logical name
tables that you want searched. It asks the system to first
search TEST_TABLE (a user-defined table) and then to search
LNM$PROCESS (the process logical name table). MYPROC is stored
in LNM$PROCESS_DIRECTORY, the process directory table. When you
enter the SHOW TRANSLATION command to find FILER in the MYPROC
table, the tables TEST_TABLE and LNM$PROCESS are searched, in
that order. The first match found is displayed.
37 – 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]
37.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.
37.2 – Qualifiers
37.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.
37.2.2 /CLUSTER
Displays the specified user names on all nodes in an OpenVMS
Cluster environment.
37.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.
37.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.
37.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.
37.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.
37.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.
37.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.
37.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.
37.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.
37.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.
37.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.
37.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.
37.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.
37.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.
38 – WORKING_SET
Displays the working set limit, quota, and extent (in pagelets
and CPU-specific pages) assigned to the current process.
This information also can be output in bytes.
Format
SHOW WORKING_SET
38.1 – Qualifier
38.1.1 /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter the /OUTPUT qualifier
without a file specification, the output is sent to the current
process default output stream or device, identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS the default file type. The
asterisk (*) and the percent sign (%) wildcard characters are
not allowed in the file specification.
If you enter the /NOOUTPUT qualifier, output is suppressed.
38.2 – Examples
1.$ SHOW WORKING_SET
Working Set (pagelets) /Limit= 2000 /Quota= 4000 /Extent= 6000
Adjustment enabled Authorized Quota= 4000 Authorized Extent= 6000
Working Set (8Kb pages) /Limit= 125 /Quota= 250 /Extent= 375
Authorized Quota= 250 Authorized Extent= 375
This example shows the SHOW WORKING_SET command on Alpha. The
process has a working set limit of 2000 pagelets (125 pages)
and a quota of 4000 pagelets (250 pages), and the current quota
is equal to the authorized limit (4000 pagelets; 250 pages). It
also shows that the current process has a working set extent of
6000 pagelets (375 pages) and that the current extent is equal
to the authorized limit (6000 pagelets; 375 pages). A pagelet
is 512 bytes.
2.$ SHOW WORKING_SET
Working Set (pagelets) /Limit=3632 /Quota=8192 /Extent=524288
Adjustment enabled Authorized Quota=8192 Authorized Extent=524288
Working Set (8Kb pages) /Limit=227 /Quota=512 /Extent=32768
Authorized Quota=512 Authorized Extent=32768
$ SET PROCESS/UNITS=BYTES
$ SHOW WORKING_SET
Working Set (bytes) /Limit=1.77MB /Quota=4MB /Extent=256MB
Adjustment enabled Authorized Quota=4MB Authorized Extent=256MB
This example shows the same display, first in bits and then in
bytes.
3.$ SHOW WORKING_SET
Working Set /Limit= 180 /Quota= 350 /Extent=1200
Adjustment enabled Authorized Quota= 350 Authorized Extent=1200
This example shows the SHOW WORKING_SET command . The process
has a working set limit of 180 pages, a quota of 350 pages, and
the quota is equal to the authorized limit (350 pages). It also
shows that the current process has a working set extent of 1200
and that the current extent is equal to the authorized limit
(1200).
39 – ZONE
Displays the current state of a VAXft system. For more
information on the SHOW ZONE command, see the VAXft systems
documentation.
Applies only to a VAXft system.
Format
SHOW ZONE [zone-id]