|
HP OpenVMS Systems Documentation |
|
HP OpenVMS DCL Dictionary
SHOW PROCESS
Displays information about a process and its subprocesses. FormatSHOW PROCESS [[node-name::]process-name] Parameters
DescriptionThe 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 Qualifiers
|
| #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.
Displays the current default process protection to be applied to all new files created during the terminal session or batch job.
SHOW PROTECTION
None.
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.
$ 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.
Displays information about queues and the jobs that are currently in queues.Requires read (R) access to the job.
SHOW QUEUE [queue-name]
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.
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.
/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 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.
EXECUTING
PRINTING
PROCESSING
STARTING
SUSPENDEDHOLDING 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.
Previous Next Contents Index