HP OpenVMS DCL Dictionary
HP OpenVMS DCL Dictionary
SHOW PROCESS
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.
Format
SHOW PROCESS [[node-name::]process-name]
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.
Description
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.
Qualifiers
/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
/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 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.
/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.
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 in 512-byte pages on VAX 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 512-byte
pages on VAX and 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 memory heading appears on VAX and the Virtual pages heading
appears on Alpha; both indicate 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/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 pages on VAX (512-byte 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 (VAX) Blocks LEQU 64 (Alpha)
|
Displays the number of free blocks that are 32 bytes or shorter on VAX
or 64 bytes or shorter on 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.
|
| #8 |
$ 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 displays the basic subset of
information for the process MALIK on node OCALA.
| #9 |
$ 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.
| #10 |
$ 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.
SHOW PROTECTION
Displays the current default process protection to be applied to all
new files created during the terminal session or batch job.
Format
SHOW PROTECTION
Parameters
None.
Description
The SHOW PROTECTION command displays the current default file
protection to be applied to all new files created during the terminal
session or batch job. You can change the default protection at any time
with the SET PROTECTION/DEFAULT command.
Use the DIRECTORY/PROTECTION command to see the current protection for
one or more specific files.
Example
|
$ SHOW PROTECTION
SYSTEM=RWED, OWNER=RWED, GROUP=RE, WORLD=NO ACCESS
$ SET PROTECTION=(GROUP:RWED,WORLD:RE)/DEFAULT
$ SHOW PROTECTION
SYSTEM=RWED, OWNER=RWED, GROUP=RWED, WORLD=RE
|
The SHOW PROTECTION command in this example requests a display of the
current protection defaults and the user identifiers; the SET
PROTECTION/DEFAULT command changes the file access allowed to other
users in the same group and to miscellaneous system users. The next
SHOW PROTECTION command shows the modified protection defaults.
SHOW QUEUE
Displays information about queues and the jobs that are currently in
queues.
Requires read (R) access to the job.
Format
SHOW QUEUE [queue-name]
Parameter
queue-name
Specifies the name of the queue for which you want information
displayed. The asterisk (*) and the percent sign (%) wildcard
characters are allowed. The default value for the queue-name
parameter is the asterisk (*) wildcard character. If no queue name is
specified, information on all queues is displayed.
Description
The SHOW QUEUE command displays the name, type, status, and attributes
of batch and output queues as well as information about jobs in the
queues. When you enter the SHOW QUEUE command with no qualifiers, the
OpenVMS system lists the names, types, and status of all the specified
queues along with information about your jobs in those queues. The SHOW
QUEUE command assumes the /BRIEF qualifier by default.
In an OpenVMS Cluster, the SHOW QUEUE command displays information on
all the queues available for the cluster.
If you want information about queues or a complete list of the jobs in
those queues, use the SHOW QUEUE command. For information about
specific jobs, use the SHOW ENTRY command.
Qualifiers
/ALL_JOBS
Displays all the jobs in the specified queues. You must have read (R)
access to the job to show information about any jobs.
/BATCH
Displays only batch queues and jobs in those queues.
/BRIEF (default)
Displays a one-line description of each queue and jobs that are in it.
This information includes the name, type, and status of each queue. It
also includes the entry number, the job name, the user name, and the
status for each job shown. The /FULL and /FILES qualifiers override the
/BRIEF qualifier.
/BY_JOB_STATUS=(keyword-list)
Displays queues that contain jobs that match the specified status. By
default, jobs owned by the user are displayed. Specify the status with
one or more of the following keywords:
|
EXECUTING
|
Requests the display of jobs in any of the following states:
ABORTING
EXECUTING
PRINTING
PROCESSING
|
STALLED
STARTING
SUSPENDED
|
ABORTING means that the job is halting prior to normal completion and will not continue processing. A SUSPENDED state means that the job stopped during processing, but should continue when the cause of the SUSPENDED state is resolved. PROCESSING is the executing state for server queues. PRINTING is the executing state for printer and terminal queues. STARTING means the job is beginning to be processed or printed. A STALLED or SUSPENDED state means that the job stopped during processing, but should continue when the cause of the STALLED or SUSPENDED state is resolved.
|
|
HOLDING
|
Requests the display of jobs on hold. Holding status indicates that the
job is being held in the queue indefinitely.
|
|
PENDING
|
Requests the display of jobs with pending status. Pending status
indicates that the job is waiting its turn to execute.
|
|
RETAINED
|
Requests the display of jobs retained in the queue after execution.
Retained status indicates that the job has completed, but it remains in
the queue.
|
|
TIMED_RELEASE
|
Requests the display of jobs on hold until a specified time. Timed
release status indicates that the job is being held in the queue for
execution at a specified time.
|
Note that if you specify the qualifier without a keyword, the system
will only display queues that actually contain jobs.
/DEVICE[=(keyword-list)]
Displays a particular type of queue and jobs in that queue.
Specify the type of device queue with one or more of the following
keywords:
|
PRINTER
|
Requests the display of print queues.
|
|
SERVER
|
Requests the display of server queues.
|
|
TERMINAL
|
Requests the display of terminal queues.
|
You can specify more than one keyword. If you do not specify a keyword
with the /DEVICE qualifier, all printer, terminal, and server queues
are displayed.
/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.
/FILES
Adds to the display the list of files associated with each job. The
/FILES qualifier overrides the /BRIEF qualifier.
/FULL
Displays complete information about queues, jobs contained in queues,
and the files associated with the jobs. The /FULL qualifier overrides
the /BRIEF qualifier.
/GENERIC
Displays only generic queues and jobs in those queues. A generic queue
is not an execution queue. Its function is to hold jobs of a particular
type (line printer jobs, for example) and direct them to execution
queues for processing.
/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.
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default, the
output of the SHOW QUEUE 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.
|
