The SHOW PROCESS command displays information about a process and its
subprocesses. If no qualifier is entered, only the following subset of
information is displayed:
Time
Process terminal
User name and user identification code (UIC)
Node name
Process name and process identification (PID)
Priority
Default directory
Allocated devices
Number of kernel threads
A local process name can look like a remote process name; therefore, if
you specify ATHENS::SMITH, the system checks for a process named
ATHENS::SMITH on the local node before checking node ATHENS for a
process named SMITH.
You also can use the /IDENTIFICATION=pid qualifier to specify a process
name. If you use the /IDENTIFICATION qualifier and the
process-name parameter together, the qualifier overrides the
parameter. If you do not specify either the process-name
parameter or the /IDENTIFICATION qualifier, information is displayed
for the current process.
If you have GROUP or WORLD privilege, you can display information about
processes other than your own. With GROUP privilege you can look at
other processes in your group. With WORLD privilege you can look at
processes outside of your group. You must use the /IDENTIFICATION
qualifier to look at processes outside of your group.
/ACCOUNTING
Shows the resources used by the process.
/ALL
Displays the basic subset of information as well as information about:
Accounting
Dynamic memory use
Privileges
Quotas
Shelving
Subprocesses
/CASE_LOOKUP
Lists the active case sensitivity setting in your process (either BLIND
or SENSITIVE).
HP strongly recommends that you use caution when enabling case
sensitivity in your processes.
Refer to the Guide to OpenVMS File Applications for additional information.
/CONTINUOUS
Displays continuously updated information about the local process in an
OpenVMS environment. You cannot use the /CONTINUOUS qualifier to
display information about a process on another node in a cluster
environment.
While the continuous display is running, you can press the T key to
display information for threads that make up the process. If there are
multiple threads, pressing the T key repeatedly cycles through all the
threads.
While the continuous display is running, you can press the V key to
display a map of the pages in the virtual address space of the process.
Each character displayed in the map represents the type of page. If the
current program counter is in the page, the page type is indicated by
an at sign (@). Pages locked in the working set are indicated by the
letter L. Global pages are indicated by the letter G. Other valid pages
in the working set are indicated by an asterisk (*).
To terminate the continuous display, press the E key. To return to the
original display, press the space bar.
The /CONTINUOUS qualifier may not be used with the /OUTPUT qualifier.
/DUMP
Displays the image dump setting which is set or cleared by the SET
PROCESS/DUMP command.
/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.
/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.
/IDENTIFICATION=pid
Requires GROUP or WORLD privilege to access processes other
than your own.
Displays information about the process with the specified process
identification (PID). The PID is assigned by the system when the
process is created. When you specify a PID, you can omit the leading
zeros.
If you specify the /IDENTIFICATION qualifier, it overrides the
process-name parameter. If, in addition, you specify the
/MEMORY qualifier, the PID value must be that of the current process.
/INTERVAL=n
Use with the /CONTINUOUS qualifier to update the information at the
specified number of seconds.
/MEMORY
Displays the process's use of dynamic memory areas. The /MEMORY
qualifier is allowed only for the current process.
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default, the
output of the SHOW PROCESS 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.
The /OUTPUT qualifier is incompatible with the /CONTINUOUS qualifier.
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of process 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.
/PRIVILEGES
Displays current privileges and rights for the process. To display only
privileges, also specify the /NORIGHTS qualifier. Use the SET
PROCESS/PRIVILEGES command to enable process privileges on a system.
/QUOTAS
Displays, for each resource, either a quota or a limit. The values
displayed for quotas reflect any quota reductions resulting from
subprocess creation. The values displayed for limits reflect the
resources available to a process at creation.
/RAD (Alpha/I64 only)
Displays home resource affinity domain (RAD).
Supported only on AlphaServer GS series systems.
/RIGHTS (default)
/NORIGHTS
Displays the current rights for the specified process. Use the
/NORIGHTS qualifier with the /PRIVILEGES qualifier to suppress the
rights display.
/SCHEDULING_CLASS
Displays the scheduling class of the specified process.
/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.
/SHELVING
Displays whether the process automatically unshelves files.
/SUBPROCESSES
Displays the current subprocesses in hierarchical order.
/TOKEN (Alpha/I64 Only)
Displays the current token size as either Traditional (255 bytes) or
Extended (4000 bytes). (A token is any element in a command line that
is bounded by spaces. For example, the command COPY X.TXT Y.TXT
contains three tokens.) The token size is determined by the setting of
bit 1 in the DCL_CTLFLAGS system parameter. You can use the SET
PROCESS/TOKEN command to change the token size.
/UNITS
Displays whether the process currently reports disk space in bytes or
blocks. You can change this setting using SET PROCESS/UNITS.
/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.
