HP OpenVMS Systems Documentation

HP OpenVMS DCL Dictionary

Displays the current characteristics of a specific terminal. Each
characteristic corresponds to an option of the SET TERMINAL command.

Format

SHOW TERMINAL [device-name[:]]

Parameter

device-name[:]

Specifies the name of the terminal for which you want the
characteristics displayed. The default is your terminal (SYS$COMMAND).

Description

The SHOW TERMINAL command displays the information about terminal
settings for such things as terminal speed, width, number of lines,
graphics, and device type.

Note that the SHOW TERMINAL command does not describe terminal fallback
characteristics if any are activated. If the Terminal Fallback Facility
(TFF) is enabled, you can invoke the Terminal Fallback Utility (TFU)
and issue the subcommand SHOW TERMINAL/FALLBACK. For more information,
see the OpenVMS Terminal Fallback Utility Manual (available on the Documentation CD-ROM).

Qualifiers

/BRIEF

Displays a subset of more commonly used terminal characteristics.

/FULL (default)

Displays all terminal characteristics.

/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.

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).

Format

Parameters

Example

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

Parameter

logical-name

Specifies the logical name whose translation you want to display.

Description

The SHOW TRANSLATION command searches one or more logical name tables
for a specified logical name and returns the equivalence name of the
first match found. You can specify the tables you want to search. If
you do not specify a table, SHOW TRANSLATION searches the tables
defined by the logical name LNM$DCL_LOGICAL.

The logical name LNM$DCL_LOGICAL contains the list of logical name
tables and the order in which they are searched. Unless LNM$DCL_LOGICAL
has been redefined for your process, the process, job, group, and
system logical name tables are searched, in that order. The first match
found is displayed. (To see how LNM$DCL_LOGICAL is defined for your
process, enter the command SHOW LOGICAL /TABLE=LNM$DIRECTORIES
LNM$DCL_LOGICAL.)

If a table contains more than one entry with the same name, but each
name has a different mode, then the translation for the name with the
outermost (least privileged) mode is returned.

The SHOW TRANSLATION command is similar to the SHOW LOGICAL command;
however, the SHOW TRANSLATION command is executed within the DCL
command interpreter (the SHOW LOGICAL command calls an image).
Therefore, the SHOW TRANSLATION command does not cause the current
image to exit and does not deassign user mode logical names. Also, the
SHOW TRANSLATION command does not display iterative translations of a
name.

Qualifier

/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.

Examples

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.

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.

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.

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.

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.

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.

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.

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.