Displays information about a process and its subprocesses.
Requires GROUP privilege to show other processes in the same
group. Requires WORLD privilege to show processes outside your
group. You must use the /IDENTIFICATION qualifier to look at
processes outside of your group.
Format
SHOW PROCESS [[node-name::]process-name]
1 – Parameters
node-name::
The name of the node on which the specified process is running.
You must specify a node name on the same OpenVMS Cluster on which
the current process is running.
process-name
The name of the process about which information is to be
displayed. The process name can have up to 15 alphanumeric
characters.
The specified process name must be in the same group as the
current process. You must use the /IDENTIFICATION qualifier to
look at processes outside of your group.
2 – Qualifiers
2.1 /ACCOUNTING
Shows the resources used by the process.
2.2 /ALL
Displays the basic subset of information as well as information
about:
Accounting
Dynamic memory use
Privileges
Quotas
Shelving
Subprocesses
Wildcard status
2.3 /CASE_LOOKUP
Lists the active case sensitivity setting in your process (either
BLIND or SENSITIVE).
VSI strongly recommends that you use caution when enabling case
sensitivity in your processes.
See the Guide to OpenVMS File Applications for additional
information.
2.4 /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
following keys to customize the output display:
Key Action
E Exits the continuous display.
Q Dynamically displays process quotas.
T Displays information for threads in the process. Press
the T key repeatedly to cycle through multiple threads.
V Displays 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 (*).
Space Returns to the default display.
bar
The /CONTINUOUS qualifier cannot be used with the /OUTPUT
qualifier.
2.5 /DUMP
Displays the image dump setting which is set or cleared by the
SET PROCESS/DUMP command.
2.6 /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.7 /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.8 /IDENTIFICATION
/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.
2.9 /INTERVAL
/INTERVAL=n
Use with the /CONTINUOUS qualifier to update the information at
the specified number of seconds.
2.10 /MEMORY
Displays the process's use of dynamic memory areas. The /MEMORY
qualifier is allowed only for the current process.
2.11 /OUTPUT
/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.
2.12 /PAGE
/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), 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.13 /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.
Use the SHOW PROCESS/PRIVILEGES command to determine what
authorized privileges are enabled on an OpenVMS system:
ACNT ALLSPOOL ALTPRI AUDIT
BUGCHK BYPASS CMEXEC CMKRNL
DETACH DIAGNOSE DOWNGRADE EXQUOTA
GROUP GRPNAM GRPPRV IMPORT
LOG_IO MOUNT NETMBX OPER
PFNMAP PHY_IO PRMCEB PRMGBL
PRMMBX PSWAPM READALL SECURITY
SETPRV SHARE SHMEM SYSGBL
SYSLCK SYSNAM SYSPRV TMPMBX
UPGRADE VOLPRO WORLD
2.14 /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.
2.15 /RAD
Displays home resource affinity domain (RAD).
OpenVMS support for RADs is available on the Alpha GS series
systems and Integrity server NUMA capable systems.
2.16 /RIGHTS
/RIGHTS (default)
/NORIGHTS
Displays the current rights for the specified process. Use the
/NORIGHTS qualifier with the /PRIVILEGES qualifier to suppress
the rights display.
2.17 /SCHEDULING_CLASS
Displays the scheduling class of the specified process.
2.18 /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.19 /SHELVING
Displays whether the process automatically unshelves files.
2.20 /SUBPROCESSES
Displays the current subprocesses in hierarchical order.
2.21 /SYMLINK
The SHOW PROCESS/ALL and SHOW PROCESS/SYMLINK commands display
the status of the symlink wildcard search mode.
2.22 /TOKEN
/TOKEN (Alpha/Integrity servers 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.
2.23 /UNITS
Displays whether the process currently reports disk space
in bytes or blocks. You can change this setting using SET
PROCESS/UNITS.
2.24 /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 PROCESS OCALA::MALIK
14-DEC-2001 15:35:19.39 User: MALIK Process ID: 28200364
Node: OCALA Process name: MALIK
Terminal: RTA5:
User identifier: [VMS,MALIK]
Base priority: 4
Default file spec: WORK5:[MALIK]
Devices allocated: RTA5:
The SHOW PROCESS command in this example is entered by the
user MALIK. The system displays the subset of information for
the owned process on node OCALA. The information includes the
following:
Date and time the SHOW PROCESS command is entered
User name
Process identification (PID) number
Node name
Process name
Device name of the current SYS$INPUT device
User identification code (UIC)
Base execution priority
Default device (only for processes on the same node)
Default directory (only for current processes)
Devices allocated to the process and volumes mounted, if any
2.$ SHOW PROCESS/ACCOUNTING
14-DEC-2001 14:48:01.31 User: MALIK Process ID: 28200364
Node: OCALA Process name: "MALIK"
Accounting information:
Buffered I/O count: 4878 Peak working set size: 844
Direct I/O count: 1284 Peak virtual size: 1176
Page faults: 6100 Mounted volumes: 0
Images activated: 22
Elapsed CPU time: 0 00:01:20.51
Connect time: 0 04:06:03.75
The SHOW PROCESS command in this example displays the
accounting statistics for the process. The values under Peak
working set size and Peak virtual size are rendered and in
pagelets on Alpha.
3.$ SHOW PROCESS/PRIVILEGES
14-DEC-2001 14:59:28.53 User: MALIK Process ID: 28200364
Node: OCALA Process name: "MALIK"
Process privileges:
GROUP may affect other processes in same group
TMPMBX may create temporary mailbox
NETMBX may create network device
Process rights identifiers:
INTERACTIVE
DIALUP
The SHOW PROCESS command in this example displays the current
privileges for the process.
4.$ SHOW PROCESS/QUOTAS
14-DEC-2001 15:00:28.79 User: MALIK Process ID: 28200364
Node: OCALA Process name: "MALIK"
Process Quotas:
Account name: VMS
CPU limit: Infinite Direct I/O limit: 6
Buffered I/O byte count quota: 17904 Buffered I/O limit: 6
Timer queue entry quota: 10 Open file quota: 31
Paging file quota: 24945 Subprocess quota: 8
Default page fault cluster: 64 AST limit: 14
Enqueue quota: 30 Shared file limit: 9
Max detached processes: 11 Max active jobs: 14
The SHOW PROCESS command in this example displays the available
quotas and limits. The value under Paging file quota is
rendered in pagelets on Alpha.
5.$ SHOW PROCESS/SUBPROCESSES
14-DEC-2001 15:44:59.39 User: MALIK Process ID: 28200364
Node: OCALA Process name: "MALIK_1"
Processes in this tree:
MALIK
MALIK_1 (*)
MALIK_2
The SHOW PROCESS command in this example shows the current
process tree. The current process is indicated by the asterisk
(*). Processes both below and above the current process are
shown.
6.$ SHOW PROCESS/CONTINUOUS BOB
Process BOB 12:26:53
State CUR Working set 269
Cur/base priority 8/4 Virtual memory 1713
Current PC 7FFEE07E CPU time 00:00:13.82
Current PSL 03C00000 Direct I/O 246
Current user SP 7FF785A4 Buffered I/O 646
PID 226006C0 Page faults 3417
UIC [VMS,BOB] Event flags C8000007
C0000000
SYS$SYSROOT:[SYSEXE]SHOW.EXE
In this example, the /CONTINUOUS qualifier causes the display
of information about process BOB to be updated continuously.
Note that the Virtual pages heading appears on Alpha indicating
the virtual memory used as a number of CPU-specific pages.
The value displayed for Working set is also a number of CPU-
specific pages.
7.$ SHOW PROCESS/CONTINUOUS CIMSERVER
Process CIMSERVER 07:38:02
State LEF Working set 2599
Cur/base priority 9/4 Virtual pages 15135
Current PC 8065BDC0 CPU time 0 00:00:14.33
Current PSL 00000000 Direct I/O 5889
Current user SP 7ACE6680 Buffered I/O 88641
PID 20200822 Page faults 1487
UIC [SYSTEM] Event flags C0000001
80000000
$1$DGA02:[SYS0.SYSCOMMON.][WBEM_SERVICES]CIMSERVER.EXE;1
[Press Q key]
Process CIMSERVER 07:38:18
State LEF Working set 2599
PID 20200822 Page faults 1487
UIC [SYSTEM] Event flags C0000001
80000000
# open files remaining 125/128 ( 97%)
Direct I/O count/limit 100/100 (100%)
Buffered I/O count/limit 99/100 ( 99%)
BUFIO byte count/limit 251840/251840 (100%)
ASTs remaining 98/100 ( 98%)
Timer entries remaining 15/16 ( 93%)
PGFL quota count/limit 42408/43750 ( 96%)
ENQ quota count/limit 2048/2048 (100%)
$1$DGA02:[SYS0.SYSCOMMON.][WBEM_SERVICES]CIMSERVER.EXE;1
In this example, the standard continuous display is interrupted
when the Q key is pressed. The display then dynamically changes
to show the quotas in two columns: one column with the actual
counts and another with percentages.
8.$ SHOW PROCESS/MEMORY
14-DEC-2001 14:59:04.48 User: MALIK Process ID: 28200364
Node: OCALA Process Name: "MALIK"
Process Dynamic Memory Area
Current Size (bytes) 25600 Current Total Size (pages) 50
Free Space (bytes) 22698 Space in Use (bytes) 2902
Size of Largest Block 22496 Size of Smallest Block 15
Number of Free Blocks 7 Free Blocks LEQU 32 Bytes 3
The SHOW PROCESS command in this example displays the use of
dynamic memory areas for the current process, MALIK. These
areas are described as follows:
Current size Displays the current size in bytes and
pagelets on Alpha of each dynamic memory
area.
Free space Displays the amount of free space in each
dynamic memory area.
Space in use Displays the amount of space currently
allocated from each area.
Largest block Displays the size of the largest contiguous
area in each pool area.
Smallest block Displays the size of the smallest free block
in each pool area.
Free blocks Displays the total number of free blocks in
each pool area. The size of this number is a
measure of pool fragmentation.
Blocks LEQU 32 Displays the number of free blocks that are
Blocks LEQU 64 32 bytes or 64 bytes or shorter on Alpha.
(Alpha) This number is another measure of pool
fragmentation, because while allocation
of these small blocks is unlikely, they
contribute to the allocation time whenever
an allocation request is made.
9.$ SHOW PROCESS REDSOX::RAMIREZ
27-OCT-2004 23:40:20.04 User: RAMIREZ Process ID: 19182004
Node: REDSOX Process name: RAMIREZ
Terminal: RTA5:
User identifier: [VMS,RAMIREZ]
Base priority: 4
Default file spec: WORK5:[RAMIREZ]
Devices allocated: RTA5:
The SHOW PROCESS command in this example displays the basic
subset of information for the process RAMIREZ on node REDSOX.
10$ SHOW PROCESS/SHELVING LYONS
15-JUNE-2001 10:07:25.11 User: LYONS Process ID: 20206A50
Node: BANANA Process name: "LYONS"
Auto-unshelve: on
The SHOW PROCESS command in this example shows that the LYONS
process automatically unshelves files.
11$ SHOW PROCESS/DUMP RALSTON
31-DEC-2001 10:38:32.48 User: RALSTON Process ID: 20C0011B
Node: AAAAAA Process name: "_RTA1:"
Image Dump: on
The SHOW PROCESS command in this example shows that the image
dump capability for the RALSTON process is enabled. This causes
the contents of the address space to be written to the file
named SYS$LOGIN:(image-name).DMP (where the image name is
the same as the file name) when an image terminates due to
an unhandled error.
See the SET PROCESS/DUMP command for additional information.
12$ SHOW/SYMLINK
$17-SEP-2009 05:31:34.92 User: SYSTEM Process ID: 20A0045C
Node: LENOX1 Process name: "SYSTEM"
Symlink search mode: No wildcard
This example shows that wildcard is not used for symlink
search.