 Home
History
Products
VIP
|
|
SHOW SYSTEM
The SHOW SYSTEM command displays status information of current
processes.
Format:
$ VIP SHOW SYSTEM
QUALIFIERS:
/ACCESS_PORT_NAME
/ACCESS_PORT_NAME=(name[,...])
Selects only processes that match one of the specified access port
names. The access port name is associated with the terminal name of
a process and indicates the source from which a user is logged in,
eg. MSSDEV::JONES. Wildcards are allowed. When you specify the access
port name as "ANY", all processes that have an access port associated
with the terminal are selected. When you specify the access port name
as "NONE", all processes that have no access port associated with the
terminal are selected.
/ACCOUNT
/ACCOUNT=(account-name[,...])
Selects only those processes for display that have the same account
name as one of the specified account names. Wildcards are allowed.
/ACTION
/ACTION=keyword
Specifies the action to be taken when a process is selected. Choose
one of the following keywords:
DELETE Delete the selected process.
FORCE_EXIT[=status] Forces the $EXIT service call to be excecuted
by the selected process. When status is not
specified, the default value 1 will be used,
which means SUCCESS.
PRIORITY=keyword Modify the base priority of the selected
process. Choose one of the following keywords:
DECREMENT=n Decrement base priority of the
process with the specified
value.
INCREMENT=n Increment base priority of the
process with the specified
value.
SET=n Set base priority of the
process to the specified value.
RESUME Resume execution of the selected process.
SUSPEND Suspend execution of the selected process.
See also the /CONFIRM qualifier
/BATCH
Allows you to select for display all batch processes in the system.
When used with the /CLUSTER qualifier, the /BATCH qualifier displays
all batch processes in an OpenVMS cluster environment. When used with
the /NODENAME qualifier, the /BATCH qualifier displays all batch
processes of the specified nodes.
Using this qualifier gives the same result as using the qualifier
/MODE=BATCH.
/CLUSTER
Allows you to select processes on all nodes in an OpenVMS cluster
environment for display. This qualifier can not be used when the
/NODENAME qualifier is also specified.
/CONFIRM
/CONFIRM (default)
/NOCONFIRM
This qualifier is used in conjunction with the /ACTION qualifier. It
controls whether or not a request is issued before each operation
specified in the /ACTION qualifier to confirm that the operation
should be performed. The following responses are valid:
YES NO QUIT
TRUE FALSE Ctrl/Z
1 0 ALL
You can use any combination of uppercase and lowercase letters for
word responses. Word responses can be abbreviated to one or more
letters (for example, T, TR, or TRU for TRUE), but these
abbreviations must be unique. Affirmative answers are YES, TRUE,
and 1. Negative answers include: NO, FALSE, 0, and pressing the
Return key. Entering QUIT or pressing Ctrl/Z indicates that you want
to stop processing the command at that point. When you respond by
entering ALL, the command continues to process, but no further
prompts are given. If you type a response other than one of those in
the list, VIP issues an error message and redisplays the prompt.
/CPU
/CPU=(keyword[,...])
Allows you to select processes for display according to the amount of
used CPU time. Choose one of the following keywords:
MAXIMUM=n Displays processes that have used less cpu
time than the specified value.
MINIMUM=n Displays processes that have used more cpu
time than the specified value.
(MINIMUM=m,MAXIMUM=n) Displays processes whose used cpu time falls
within the specified MINIMUM and MAXIMUM
range.
/EXCLUDE
/EXCLUDE[=(process-name[,...])]
Allows you to exclude processes for monitoring according to the
process name. Wildcards are allowed. If you enter the /EXCLUDE
qualifier without a value, the current process will be excluded.
/FORCE_INSWAP
Controls whether outswapped processes are forced to swap-in in order
to retrieve process information.
/IDENTIFICATION
/IDENTIFICATION=(pid[,...])
Allows you to select processes for display according to the 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. This qualifier can not be used when the /PROCESS_NAME
qualifier is also specified.
/IMAGE_NAME
/IMAGE_NAME=(imagename[,...])
Allows you to select processes for display that are currently
executing an image that matches the specified image name. Wildcards
are allowed. When you specify the image name as "ANY", all processes
that are currently executing an image are selected. When you specify
the image name as "NONE", all processes that are currently not
executing an image are selected. Note that also device names and
directory names are included in the image name.
/IO
/IO=(keyword[,...])
Allows you to select processes for display according to the number of
performed I/O operations. Choose one or a combination of the following
keywords:
MAXIMUM=n Displays processes that have performed less
I/O operations than the specified value.
MINIMUM=n Displays processes that have performed more
I/O operations than the specified value.
(MINIMUM=m,MAXIMUM=n) Displays processes whose performed I/O
operations falls within the specified
MINIMUM and MAXIMUM range.
TYPE=io-type Selects the I/O type which value is to be
displayed and compared with the specified
value in the minimum and maximum keywords.
Choose one of the following I/O types:
ALL Compares with the sum of the
buffered I/O and the direct I/O
values.
BUFIO Compares with the buffered I/O
value only.
DIRIO Compares with the direct I/O value
only.
The default I/O type is ALL.
/JOB_NAME
/JOB_NAME=job-name
Allows you to select processes for display that are currently
executing in the specified batch job. Wildcards are allowed.
/JOBTYPE
/JOBTYPE=(keyword[,...])
Allows you to select processes according to the execution mode of the
process at the root of the job tree. Choose one of the following
keywords:
DETACHED
NETWORK
BATCH
LOCAL
DIALUP
REMOTE
/LIMIT
/LIMIT=count
Allows you to limitate the number of processes displayed.
/LOCK
/LOCK=(keyword[,...])
Allows you to select processes for display according to the process
lock information. Choose one of the following keywords:
ACCESS_MODE=access-mode Allows you maximize the access mode of
selected locks. Only locks of the
specified access mode or any less
privileged access modes will be used to
select locks. Choose one of the following
access modes:
KERNEL
EXECUTIVE
SUPERVISOR
USER
The default value is USER.
CREATE=(name[,...]) Creates a lock on the specified resources
at an access mode that has been specified
with the /ACCESS_MODE qualifier. It makes
it possible to select lock information of
locks on a resource at another node in an
OpenVMS cluster environment when no
process holding a lock on the same
resource at the local node in an OpenVMS
cluster environment.
The size of the resource name may not
exceed 31 characters.
LKID=(lock-id[,...]) Selects only those locks of which the
lock id matches one of the specified
lock id values. The lock id has to be
specified in hexadecimal format. If you
specify this keyword, you can not also
specify the NAME or QUEUE keywords.
NAME=(name[,...]) Selects only those locks that match one
of the specified names. Wildcards are
allowed. When you specify the lock name
as "ANY", all processes that have queued
a lock to at least one resource are
selected. When you specify the lock name
as "NONE", all processes that have no
locks queues to a resource are selected.
QUEUE=(name[,...]) Selects only those locks that currently
reside in one of the specified queues.
Choose the following queue names:
CONVERT
GRANTED
WAITING
/LOGIN_TIME
/LOGIN_TIME=(keyword[,...])
Allows you to select processes for display according to the login
time of the process. Choose one of the following keywords:
AFTER=m Allows you to select processes for display that
have been created after the specified date-time
value m.
BEFORE=n Allows you to select processes for display that
have been created before the specified
date-time value n.
(AFTER=m,BEFORE=n) Displays processes whose creation time falls
within the specified AFTER and BEFORE range.
The values of m and n may be an absolute time, a delta time or one of
the relative date strings YESTERDAY, TODAY or TOMORROW.
/MASTER_PID
/MASTER_PID=pid
Allows you to select processes for display that have all the same
master pid that has been specified in the /MASTER_PID qualifier. The
master process is the process at the job root, so it shows all the
processes currently in the same job including the master process
itself.
/MODE
/MODE=(keyword[,...])
Allows you to select processes according to the process execution
mode. Choose one of the following keywords:
BATCH
INTERACTIVE
NETWORK
OTHER
/NETWORK
Allows you to select for display all network processes in the system.
When used with the /CLUSTER qualifier, the /NETWORK qualifier
displays all network processes in an OpenVMS cluster environment.
When used with the /NODENAME qualifier, the /NETWORK qualifier
displays all network processes of the specified nodes.
Using this qualifier gives the same result as using the qualifier
/MODE=NETWORK.
/NODENAME
/NODENAME[=(name[,...])]
Selects only processes on the specified node or nodes. Wildcards are
allowed. If you enter the /NODENAME qualifier without a value, the
qualifier selects only the processes on the local node. This
qualifier can not be used when the /CLUSTER qualifier is also
specified.
/OWNER
/OWNER=pid
Allows you to select processes for display that are created by the
process with the specified pid.
/PAGE_FAULTS
/PAGEFAULTS=(keyword[,...])
Allows you to select processes for display according to the number of
generated pagefaults. Choose one of the following keywords:
MAXIMUM=n Displays processes that have generated less
pagefaults than the specified value.
MINIMUM=m Displays processes that have generated more
pagefaults than the specified value.
(MINIMUM=m,MAXIMUM=n) Displays processes whose generated
pagefaults falls within the specified
MINIMUM and MAXIMUM range.
/PHYSICAL_MEMORY
/PHYSICAL_MEMORY=(keyword[,...])
Allows you to select processes for display according to the number of
pages in the working set. Choose one of the following keywords:
MAXIMUM=n Displays processes that have less pages in
the working set than the specified value.
MINIMUM=m Displays processes that have more pages in
the working set than the specified value.
(MINIMUM=m,MAXIMUM=n) Displays processes whose number of pages in
the working set falls within the specified
MINIMUM and MAXIMUM range.
/PRIORITY
/PRIORITY=(keyword[,...])
Allows you to select processes for display according to the current
process priority. Choose one of the following keywords:
MAXIMUM=n Displays processes that have a current
priority lower than or equal to the
specified value.
MINIMUM=m Displays processes that have a current
priority equal to or higher than the
specified value.
(MINIMUM=m,MAXIMUM=n) Displays processes whose current priority
falls within the specified MINIMUM and
MAXIMUM range.
TYPE=prio-type Selects the priority type which value is to
be compared with the specified value in the
minimum and maximum keywords. Choose one of
the following priority types:
BASE Compares with the base priority
value only.
CURRENT Compares with the current
priority value only.
The default priority type is CURRENT.
/PRIVILEGES
/PRIVILEGES=(keyword[,...])
Allows you to select processes for display according to the process
privileges. Choose one of the following keywords:
NAME=(privilege-name[,...]) Selects processes for display that
have enabled the specified privileges.
Choose one or a combination of the
following privileges:
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,SETPRI,SETPRV,
SHARE,SHMEM,SYSGBL,SYSLCK,SYSNAM,
SYSPRV,TMPMBX,UPGRADE,VOLPRO,WORLD
TYPE=privilege-type Selects the privilege type on which
the specified privilege name has to
mapped. Choose one of the following
privilege types:
AUTHORIZED
CURRENT
IMAGE
The default privilege type is CURRENT.
/PROCESS_NAME
/PROCESS_NAME=(name[,...])
Allows you to select processes for display according to the process
name. Wildcards are allowed. This qualifier can not be used when the
/IDENTIFICATION qualifier is also specified.
/QUEUE_NAME
/QUEUE_NAME=name
Allows you to select processes for display that are currently
executing in a batch job that is executing in the specified queue.
Wildcards are allowed.
/REPLY
/REPLY=text-string
Allows you to broadcast a message to the terminal of a selected
process.
/SHOW
/SHOW=(item[,...])
Allows you to select the items for display. Choose one or a
combination of the following items:
ACCOUNTING Selects the accounting information for display. This
information contains several accounting items of a
process on a per line basis.
ADDITIONAL Displays additional process information. Choose one of
the following keywords:
ALL Displays process information that is
associated with all of the following
items: ACCESS_PORT_NAME, ACCOUNT,
IMAGE_NAME, JOB_NAME, JOBTYPE, LOCK,
LOGIN_TIME, MASTER_PID, MODE,
NODENAME, OWNER, PRIVILEGES,
QUEUE_NAME, TERMINAL and USERNAME.
SELECTED Displays process information that is
associated with one or more of the
following specified command
qualifiers: /ACCESS_PORT_NAME,
/ACCOUNT, /IMAGE_NAME, /JOB_NAME,
/JOBTYPE, /LOCK, /LOGIN_TIME,
/MASTER_PID, /MODE, /NODENAME,
/OWNER, /PRIVILEGES, /QUEUE_NAME,
/TERMINAL and /USERNAME.
LOCK Displays the information of a lock
on a resource that is currently
associated with the process.
JOB_QUEUE Displays the job name and queue name
of a batch process.
IMAGE_NAME Displays the name of the image the
process is currently running.
ACCESS_PORT_NAME Displays the access port name that
is associated with the process
terminal.
TERMINAL Displays the process terminal name.
PRIVILEGES Displays the process privileges.
LOGIN Displayes the process login time.
JOBTYPE Displays the jobtype of the process.
MODE Displays the execution mode of the
process.
USERNAME Displays the process username.
ACCOUNT Displays the process account.
MASTER_PID Displays the master pid of the
process.
OWNER Displays the owner pid of the
process.
NODENAME Displays the nodename the process
is currently running.
HEADER Selects the header for display.
NONE Selects no items for display. If selected, no
information will be shown. If used in a list, it clears
all previous named items. It may be used in combination
with the ADDITIONAL item to exclude the NORMAL items
(e.g. VIP SHOW SYSTEM /SHOW=(NONE,ADDITIONAL=IMAGE)
shows all image names without the HEADER, ACCOUNTING
AND SUMMARY items).
NORMAL Selects the normal information for display. The NORMAL
item consists of the items HEADER, ACCOUNTING and
SUMMARY. This is the default item.
SUMMARY Selects the summary for display.
/STATE
/STATE=(keyword[,...])
Allows you to select processes for display according to the current
process state. Choose one or a combination of the following states:
CEF Process is waiting for a common eventflag
COLPG Process is in a collided page wait
COM Process is computable
COMO Process is computable and outswapped
CUR Process is currently executing in the CPU
FPG Process is waiting for free memory on the free list
HIB Process is hibernating
HIBO Process is hibernating and outswapped
LEF Process is waiting for a local eventflag
LEFO Process is waiting for a local eventflag and outswapped
MWAIT Process is in a resource wait state
PFW Process is waiting for a page fault
SUSP Process is suspended
SUSPO Process is suspended and outswapped
When you select MWAIT, only processes in one of the following
resource wait states are displayed:
RWAST AST wait
RWMBX Mailbox full
RWNPG Nonpaged dynamic memory
RWPAG Paged dynamic memory
RWPGF Page file full
RWMPE Modified page list empty
RWMPB Modified page writer busy
RWSCS System Communication Services wait
RWCLU Cluster state transition
RWCAP CPU capability
RWCSV OpenVMS cluster server process
MUTEX Process is waiting for a semaphore
/SUBPROCESS
Allows you to select for display all subprocesses in the system. When
used with the /CLUSTER qualifier, the /SUBPROCESS qualifier displays
all subprocesses in an OpenVMS cluster environment. When used with
the /NODENAME qualifier, the /SUBPROCESS qualifier displays all
subprocesses of the specified nodes.
/SWAP_STATE
/SWAP_STATE=(swap-state[,...])
Allows you to select processes for display according to the current
process swap state. Choose one or a combination of the following swap
states:
ALL select all processes. This is the default value.
IN select only inswapped processes.
OUT select only outswapped processes.
/TERMINAL
/TERMINAL=(terminal-name[,...])
Allows you to select processes for display according to the process
terminal name. Wildcards and logicals are allowed. When you specify
the terminal name as "ANY", all processes that have currently
allocated a terminal device are selected. When you specify the
terminal name as "NONE", all processes that have currently not
allocated a terminal device are selected.
/USERNAME
/USERNAME=(user-name[,...])
Allows you to select processes for display according to the username
of the process. Wildcards are allowed.
EXAMPLES:
1. This example displays all processes of user FRED:
$ VIP SHOW SYSTEM /USER=FRED
OpenVMS V6.2 on node MSSDEV 29-SEP-1996 08:20:32.41 Uptime 35 08:43:44
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
2021B09F FRED_NET LEF 4 499 0 00:10:11.55 5646 518 N
2021A1D8 FRED_1 CUR 2 5 320 0 00:11:04.32 13280 954
%VIP-I-PROCTOTAL, 2 process(es) selected on node MSSDEV
The header information in this example includes the following:
o Operating system version
Version of the operating system that is currently running.
o Node name
A 1- to 6-character string used to identify the local node or the
remote node in an OpenVMS cluster environment.
o Current time
A 23-character string used to show the current time.
o Up time
A character string used to show the time that has passed since the
node has booted.
The body information in this example includes the following:
o A list of data items for every process on the local node or the
remote node in an OpenVMS cluster environment which contains:
- Process identification code
A 32-bit binary value that uniquely identifies a process.
- Process name
A 1- to 15-character string used to identify a process.
- Process state
The activity level of the process, such as COM (computing), HIB
(hibernation), LEF (local event flag) wait, or CUR (if the process
is current). If a multiprocessing environment exists, the display
also shows the CPU ID of the processor on which any current
process is executing.
- Current priority
The priority level assigned to the process.
- Total process I/O count
The number of I/O operations involved in executing the process.
This consists of both the direct I/O count and the buffered I/O
count.
- Charged CPU time
The amount of CPU time that a process has used thus far.
- Number of page faults
The number of exceptions generated by references to pages that are
not in the process's working set.
- Physical memory occupied (pages in working set)
The amount of space in physical memory that the process is
currently occupying (which is the number of pages currently in the
working set. These number of pages includes both private and
global pages).
- Process indicator
Letter B indicates a batch job; letter S indicates a subprocess;
letter N indicates a network process.
The summary information in this example includes the following:
o Process total
A numeric value to display the number of selected processes.
2. In this example all batch processes are deleted:
$ VIP SHOW SYSTEM/MODE=BATCH/ACTION=DELETE
OpenVMS V6.2 on node MSSDEV 29-SEP-1996 08:20:32.41 Uptime 35 08:43:44
Pid Process Name State Pri I/O CPU Pageflts Ph.Mem
2021B09F BATCH_667 PFW 1 499 0 00:00:01.55 5646 518 B
Delete process BATCH_667 with ID 2021B09F at node MSSDEV ? [N]: Y
%VIP-S-PROCDELETE, Process BATCH_667 deleted
2021ACA0 BATCH_668 LEF 1 492 0 00:00:01.33 5925 229 B
Delete process BATCH_668 with ID 2021ACA0 at node MSSDEV ? [N]: A
%VIP-S-PROCDELETE, Process BATCH_668 deleted
20216CA2 BATCH_669 LEF 1 425 0 00:00:01.15 5441 238 B
%VIP-S-PROCDELETE, Process BATCH_669 deleted
20218CA3 BATCH_670 LEF 2 406 0 00:00:01.07 5229 250 B
%VIP-S-PROCDELETE, Process BATCH_670 deleted
%VIP-I-PROCTOTAL, 4 process(es) selected on node MSSDEV
3. This example displays all processes that have used at least
10 minutes of CPU time:
$ VIP SHOW SYSTEM/CPU=MIN="0 00:10:00"
OpenVMS V6.2 on node MSSDEV 29-SEP-1996 08:20:32.41 Uptime 35 08:43:44
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
2021B09F USER_1 LEF 4 499 0 00:10:11.55 5646 518
2021A1D8 USER_2 LEF 5 320 0 00:11:04.32 13280 954
%VIP-I-PROCTOTAL, 2 process(es) selected on node MSSDEV
4. This example displays all processes that have performed at least
100 and no more than 2000 I/O operations:
$ VIP SHOW SYSTEM/IO=(MIN=100,MAX=2000)
OpenVMS V6.2 on node MSSDEV 29-SEP-1996 08:20:32.41 Uptime 35 08:43:44
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
2021B09F USER_1 LEF 4 101 0 00:00:11.55 5646 518
2021A1D8 USER_2 LEF 5 1320 0 00:01:04.32 13280 954
%VIP-I-PROCTOTAL, 2 process(es) selected on node MSSDEV
5. This example displays all processes that are created the last hour:
$ VIP SHOW SYSTEM/LOGIN_TIME=AFTER="0 01:00:00"
OpenVMS V6.2 on node MSSDEV 29-SEP-1996 08:20:32.41 Uptime 35 08:43:44
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
2021C15C USER_1 LEF 4 23655 0 00:04:11.55 5646 518
2021B09F USER_2 HIB 4 45 0 00:10:41.47 124 431
20215ADF USER_3 LEF 6 451 0 00:00:43.06 3296 1204
2021A1D8 USER_4 LEF 5 1320 0 00:01:04.32 13280 954
%VIP-I-PROCTOTAL, 4 process(es) selected on node MSSDEV
6. This example displays all processes that have generated at least
25000 pagefaults:
$ VIP SHOW SYSTEM/PAGE=MIN=25000
OpenVMS V6.2 on node MSSDEV 29-SEP-1996 08:20:32.41 Uptime 35 08:43:44
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
2021A776 USER_1 HIB 4 2312 0 00:22:32.25 26298 788
2021B5CD USER_2 LEF 5 5531 0 00:12:05.31 100322 1254
202143AA USER_3 LEF 4 5721 0 01:04:21.18 45886 1023
%VIP-I-PROCTOTAL, 3 process(es) selected on node MSSDEV
7. This example displays only the header information:
$ VIP SHOW SYSTEM/SHOW=HEADER
OpenVMS V6.2 on node MSSDEV 29-SEP-1996 08:20:32.41 Uptime 35 08:43:44
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
8. This example displays the accounting information:
$ VIP SHOW SYSTEM/PAGE=MIN=25000/SHOW=ACCOUNTING
2021A776 USER_1 HIB 4 2312 0 00:22:32.25 26298 788
2021B5CD USER_2 LEF 5 5531 0 00:12:05.31 100322 1254
202143AA USER_3 LEF 4 5721 0 01:04:21.18 45886 1023
9. This example displays the summary information:
$ VIP SHOW SYSTEM/SHOW=SUMMARY/CLUSTER
%VIP-I-PROCTOTAL, 73 process(es) selected on node MSSDEV
%VIP-I-PROCTOTAL, 145 process(es) selected on node MSSTST
%VIP-I-PROCGRAND, Grand total of 218 process(es) selected
10. This example selects only those processes that are logged in from
remote node SORTER that are running the OpenVMS Monitor Utility
and shows the selected values:
$ VIP SHOW SYSTEM /ACCESS_PORT=SORTER::* -
/IMAGE=*MONITOR* -
/SHOW=ADDITIONAL=SELECTED
OpenVMS V6.2 on node MSSDEV 29-SEP-1996 08:20:32.41 Uptime 35 08:43:44
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
2021A776 USER_1 HIB 4 2312 0 00:22:32.25 26298 788
Access port: SORTER::JONES
Image : DKA100:[SYS0.SYSCOMMON.][SYSEXE]MONITOR.EXE
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
2021B5CD USER_2 LEF 5 5531 0 00:12:05.31 100322 1254
Access port: SORTER::FRED
Image : DKA100:[SYS0.SYSCOMMON.][SYSEXE]MONITOR.EXE
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
202143AA USER_3 LEF 4 5721 0 01:04:21.18 45886 1023
Access port: SORTER::SYSTEM
Image : DKA100:[SYS0.SYSCOMMON.][SYSEXE]MONITOR.EXE
%VIP-I-PROCTOTAL, 3 process(es) selected on node MSSDEV
|
