[Digital logo]
[HR]

OpenVMS DCL Dictionary


Previous | Contents

For complete information on specifying time values, see the OpenVMS User's Manual or the topic SPECIFY Date_Time in online help.


Examples

#1
$  SHOW SECURITY LNM$SYSTEM_TABLE /CLASS=LOGICAL_NAME_TABLE
LNM$SYSTEM_TABLE object of class LOGICAL_NAME_TABLE
     Owner: [SYSTEM]
     Protection: (System: RWC, Owner: RWC, Group: R, World: R)
     Access Control List:
          (IDENTIFIER=[USER,SVENSEN],ACCESS=CONTROL)
 

This example shows a typical request to display the security elements of an object. The logical name table LNM$SYSTEM_TABLE is displayed with the settings of the security elements owner, protection, and ACL.

#2
$ SHOW SECURITY/CLASS=DEVICE $99$DUA22
_$99$DUA22: object of class DEVICE
    Owner: [SALES,TSUTTER]
    Protection: (System: RWPL, Owner: RWPL, Group: R, World)
    Access Control List: <empty>
RES17SEP object of class VOLUME
    Owner: [FEAST,FY93]
    Protection: (System: RWCD, Owner: RWCD, Group: RWCD, World: RWCD)
    Access Control List: <empty>
$ SHOW DEVICE $99$DUA22
Device               Device      Error    Volume      Free  Trans Mnt
 Name                Status      Count     Label     Blocks Count Cnt
$99$DUA22:  (KUDOS)  Mounted         0  RES17SEP     649904     1   2
 
 

This example shows a request for the security profile of a disk device. The resulting display provides both the profiles of the disk $99$DUA22 and the volume RES127SEP that is mounted on it. The subsequent SHOW DEVICE command confirms the volume is mounted on the device $99$DUA22.

#3
$  SHOW SECURITY LOGICAL_NAME_TABLE /CLASS=SECURITY_CLASS
LOGICAL_NAME_TABLE object of class SECURITY_CLASS
     Owner: [SYSTEM]
     Protection: (System: RWCD, Owner: RWCD, Group: R, World: R)
     Access Control List: <empty>
  Template: GROUP
     Owner: [SYSTEM]
     Protection: (System: RWCD, Owner: R, Group: R, World: R)
     Access Control List: <empty>
  Template: JOB
     Owner: [SYSTEM]
     Protection: (System: RWCD, Owner: RWCD, Group, World)
     Access Control List: <empty>
  Template: DEFAULT
     Owner: [SYSTEM]
     Protection: (System: RW, Owner: RW, Group: R, World: R)
     Access Control List: <empty>
 
 

This example shows the output for the special case of a security class object. The security class object LOGICAL_NAME_TABLE is displayed with the security profile. In addition, three templates are displayed.

#4
$  SHOW SECURITY * /CLASS=SECURITY_CLASS
SECURITY_CLASS object of class SECURITY_CLASS
     Owner: [SYSTEM]
     Protection: (System: RWCD, Owner: RWCD, Group: R, World: R)
     Access Control List:  <empty>
LOGICAL_NAME_TABLE object of class SECURITY_CLASS
     Owner: [SYSTEM]
     Protection: (System: RWCD, Owner: RWCD, Group: R, World: R)
     Access Control List:  <empty>
               .
               .
               .
 

This example shows the output for the special case of showing all the security classes currently registered. The asterisk (*) wildcard character is used; any other form of wildcard characters is not accepted. Security profiles are shown for each security class. Note that template information is not shown.


SHOW STATUS

Displays the current status of your process.

Format

SHOW STATUS


PARAMETERS

None.

DESCRIPTION

The SHOW STATUS command verifies that your current process is running. The SHOW STATUS information can also indicate if the process is using an abnormal amount of CPU time, is opening too many files, or is accruing too many page faults. The information displayed includes the following:

The information displayed by SHOW STATUS is similar to that displayed by the Ctrl/T function. (See the SET CONTROL command.)


Example

$ SHOW STATUS
Status on 14-DEC-1994 12:56:48.68    Elapsed CPU :   0 00:00:55.02
Buff. I/O :    5117    Cur. ws. :    300        Open files :     1
Dir. I/O :      458    Phys. Mem. :  162        Page Faults : 8323

The SHOW STATUS command in this example displays the current status of your process.


SHOW SYMBOL

Displays the value of the specified symbol.

Format

SHOW SYMBOL [symbol-name]


PARAMETER

symbol-name

Specifies the name of the symbol whose value you want to display. You must specify a symbol name unless you use the /ALL qualifier. The asterisk (*) and the percent sign (%) wildcard characters are allowed in the symbol-name parameter.

DESCRIPTION

The SHOW SYMBOL command searches for the specified symbol name in several places. First, it looks in the local symbol table of the current command level. Next, it searches the local symbol tables of preceding command levels. Last, it searches the global symbol table. The SHOW SYMBOL command displays the first match it finds.

The /LOCAL and /GLOBAL qualifiers override the search order.


QUALIFIERS

/ALL

Displays the current values of all symbols in the specified symbol table (/LOCAL or /GLOBAL). If you specify the /ALL qualifier and do not specify either the /LOCAL or the /GLOBAL qualifier, the SHOW SYMBOL command displays the contents of the local symbol table for the current command level.

/GLOBAL

Searches only the global symbol table for the specified symbol name. If you specify both the /ALL and /GLOBAL qualifiers, all names in the global symbol table are displayed.

/LOCAL

Searches only the local symbol table for the current command level for the specified symbol name. If you specify both the /ALL and /LOCAL qualifiers, all names in the local symbol table for the current command level are displayed.

/LOG (default)

/NOLOG

Controls whether the system generates an informational message if the symbol value has been truncated. The value is truncated if it exceeds 255 characters.

Examples

#1
$ SHOW SYMBOL PURGE
  PURGE = "PURGE/KEEP=2"

The SHOW SYMBOL command in this example displays the current value of the symbol name PURGE. The command interpreter first searches the local symbol table for the current command level, then local symbol tables for preceding command levels, and finally the global symbol table. The single equal sign (=) following PURGE means it is a local symbol.

#2
$ SHOW SYMBOL/GLOBAL/ALL
  TIME == "SHOW TIME"
  LOG == "@LOG"
  $RESTART == "FALSE"
  $SEVERITY == "1"
  $STATUS == "%X00000001"

The SHOW SYMBOL command in this example displays all the symbols defined in the global symbol table. Note that the symbols $RESTART, $SEVERITY, and $STATUS, which are maintained by the system, are also displayed.

#3
$ SHOW SYMBOL/LOCAL TIME
%DCL-W-UNDSYM, undefined symbol

The SHOW SYMBOL command in this example searches only the local symbol table for the symbol TIME. The response indicates that TIME currently has no value.


SHOW SYSTEM

Displays status information about current processes.

Format

SHOW SYSTEM


PARAMETERS

None.

DESCRIPTION

The SHOW SYSTEM command displays the following information about processes on the system:

It also checks to see whether the machine is a multiprocessor. A machine is considered a multiprocessor if the following conditions are true:

If the machine is a multiprocessor, the SHOW SYSTEM command includes information about the multiprocessing environment. Each process in the currently executing state (indicated by the CUR symbol) reveals which processor it is running on. It does this by including a number beside the CUR symbol.

The SHOW SYSTEM command examines the processes on the system without stopping activity on the system. This means that process information may change during the time that SHOW SYSTEM collects the data to be displayed. As a result, there may be minor inconsistencies in the SHOW SYSTEM display. For example, SHOW SYSTEM may display two processes that schedule state CUR on the same CPU.


QUALIFIERS

/BATCH (default)

/NOBATCH

Displays all batch jobs for the local system. When used with the /CLUSTER qualifier, the /BATCH qualifier displays all batch jobs in the OpenVMS Cluster environment. When you use the /NOBATCH qualifier, all batch jobs are excluded from the display.

/CLUSTER

Displays the specified processes on all nodes in an OpenVMS Cluster.

/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.

/FULL

Displays the user identification code (UIC), the processor type, and the process size, in addition to the default information. The UIC is displayed below the process name.

/HEADING

/NOHEADING

Displays a heading line above the system output. When you use the /NOHEADING qualifier, the heading line is excluded from the display.

/HIGHLIGHT[=keyword]

/NOHIGHLIGHT (default)

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.

/IDENT=pid

Displays all processes on the system that have the specified process identification (PID) code number.

/INTERACTIVE

/NOINTERACTIVE

Displays all interactive processes on the system. When you use the /NOINTERACTIVE qualifier, all interactive processes are excluded from the display.

/NETWORK

/NONETWORK

Displays all network processes on the system. When you use the /NONETWORK qualifier, all network processes are excluded from the display.

/NODE[=(name,...)]

Displays all the processes on the specified node or nodes. If you enter the /NODE qualifier without a value, the qualifier displays all the processes on the local node of an OpenVMS Cluster environment.

/OUTPUT[=filespec]

/NOOUTPUT

Controls where the output of the command is sent. By default, the output of the SHOW SYSTEM 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 file specification may not include the asterisk (*) and the percent sign (%) wildcard characters. 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.

/OWNER_UIC=uic

Displays all processes on the system that have the specified user identification code (UIC) number.

/PAGE[=keyword]

/NOPAGE (default)

Controls the display of system 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 (<uparrow symbol>), Ctrl/B Scroll up one line.
Down arrow (<downarrow symbol>) Scroll down one line.
Left arrow ( <-) Scroll left one column.
Right arrow (->) 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.

/PROCESS[=name] (default)

/NOPROCESS

Displays all specified processes on the system. If you do not specify a process name with the /PROCESS qualifier, all processes are displayed.

When you use the /NOPROCESS qualifier with the /CLUSTER qualifier, only the node or nodes available on the cluster are displayed with their respective uptimes and operating system version.

You can include the asterisk (*) and the percent sign (%) wildcard characters in the process name.

/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.

/STATE=process-state

Displays all processes with the specified process state. You can include the asterisk (*) and the percent sign (%) wildcard characters in the process-state name. The following process states are available:
CEF (Common event flag wait) COLPG (Collided page wait)
COM (Computable) COMO (Computable but outswapped)
CUR (Current) FPG (Free page wait)
HIB (Hibernating) HIBO (Hibernating and outswapped)
LEF (Local event flag wait) LEFO (Local event flag wait and outswapped)
MUTEX¹ (Miscellaneous wait) PFW (Page fault wait)
PSXFR (POSIX fork wait) RWAST (AST wait)
RWBRK (Waiting for BROADCAST to finish) RWCAP (CPU capability required)
RWCLU (Cluster transition wait) RWCSV (Cluster server)
RWIMG (Image activation lock) RWLCK (Lock ID database)
RWMBX (Mailbox full) RWMPB (Modified page writer busy)
RWMPE (Modified page list empty) RWNPG (Nonpaged pool)
RWPAG (Paged pool) RWPFF (Page file full)
RWQUO (Pooled quota) RWSCS (SCS wait)
RWSWP (Swapfile spacelist empty) SUSP (Suspended)
SUSPO (Suspended and outswapped)

¹MUTEX is output if one of the RW* states cannot be output.

/SUBPROCESS

/NOSUBPROCESS

Displays all subprocesses on the system. When you use the /NOSUBPROCESS qualifier, all subprocesses are excluded from the output.

/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 SYSTEM
OpenVMS 6.2 on node KRYPTN 14-DEC-1994 17:45:47:78 Uptime 2 21:53:59
   Pid    Process Name State  Pri    I/O       CPU   Page flts Pages
 27400201 SWAPPER        HIB   16      0  0 00:29:52.05      0    0
 27401E03 DOCBUILD       LEF    4  37530  0 00:05:47.62  96421  601
 27402604 BATCH_789      LEF    4   3106  0 00:00:48.67   4909 2636 B
 27401C05 BATCH_60       LEF    6    248  0 00:00:06.83   1439 1556 B
 27400207 ERRFMT         HIB    8   6332  0 00:00:41.83     89  229
 27400208 CACHE_SERVER   HIB   16   2235  0 00:00:05.85     67  202
 27400209 CLUSTER_SERVER HIB    8   4625  0 00:22:13.28    157  448
 2740020C JOB_CONTROL    HIB   10 270920  0 01:07:47.88   5163 1384
 2740020D CONFIGURE      HIB    9    125  0 00:00:00.53    104  264
  . 
  . 
  . 
 27400E8D Sir Lancelot   LEF    5    226  0 00:00:07.87   4560  697
 2740049A Guenevere      LEF    4    160  0 00:00:02.69    534  477
 27401EA0 BATCH_523      CUR 4  4  17470  0 03:25:49.67   8128 5616 B
 274026AF GAWAIN         CUR 6  4  14045  0 00:02:03.24  20032  397
 274016D5 GAHERIS        LEF    6    427  0 00:00:09.28   5275 1384
 27401ED6 knight_1       HIB    5    935  0 00:00:10.17   3029 2204 S
 274012D7 BATCH_689      LEF    4  49216  0 00:14:18.36   7021 3470 B
 274032D9 DECW$MAIL      LEF    4   2626  0 00:00:51.19   4328 3087 B
 274018E3 SERVER_0021    LEF    6    519  0 00:00:07.07   1500  389 N
 274016E8 NMAIL_0008     HIB    4  10955  0 00:00:55.73   5652  151
 274034EA MORDRED        LEF    4   2132  0 00:00:23.85   5318  452
 274022EB S. Whiplash    CUR 6  4    492  0 00:00:12.15   5181  459
 274018EF DwMail         LEF    5 121386  0 00:28:00.97   7233 4094
 27401AF0 EMACS$RTA43    LEF    4  14727  0 00:03:56.54   8411 4224 S
 27400CF4 TRISTRAM       HIB    5  25104  0 00:06:07.76  37407 1923
 274020F5 Morgan         LEF    7  14726  0 00:02:10.74  34262 1669
 27400CF6 mr. mike       LEF    9  40637  0 00:05:15.63  18454  463

The SHOW SYSTEM command in this example displays all processes on the system.

The information in this example includes the following:

#2
$ SHOW SYSTEM /CLUSTER
OpenVMS V6.2 on node ALPES 14-DEC-1994 09:09:58.61  Uptime 2 2:27:11
Pid       Process Name   State  Pri I/O       CPU     Page flts Pages
31E00041  SWAPPER        HIB    16    0  0 00:00:02.42       0     0
31E00047  CACHE_SERVER   HIB    16   58  0 00:00:00.26      80    36
31E00048  CLUSTER_SERVER CUR     9  156  0 00:00:58.15    1168    90
31E00049  OPCOM          HIB     7 8007  0 00:00:33.46    5506   305
31E0004A  AUDIT_SERVER   HIB     9  651  0 00:00:21.17    2267    22
31E0004B  JOB_CONTROL    HIB    10 1030  0 00:00:11.02     795   202
   .
   .
   .

The SHOW SYSTEM command in this example was issued from an Alpha system and shows all processes on all nodes of the cluster.

#3
$ SHOW SYSTEM /NODE=EON
OpenVMS V6.2 on node EON  14-DEC-1994 09:19:15.33  Uptime  2 02:29:07
Pid       Process Name   State  Pri I/O       CPU     Page flts Pages
36200041  SWAPPER        HIB    16    0  0 00:00:12.03       0     0
36200046  ERRFMT         HIB     8  263  0 00:00:05.89     152    87
36200047  CACHE_SERVER   CUR    16    9  0 00:00:00.26      80    51
36200048  CLUSTER_SERVER CUR     8   94  0 00:00:30.07     340    68
36200049  OPCOM          HIB     6 2188  0 00:02:01.04    1999   177
3620004A  AUDIT_SERVER   HIB    10  346  0 00:00:10.42    1707    72
   .
   .
   .

The SHOW SYSTEM command in this example was issued from a VAX system and shows all processes on the node EON.

#4
$ SHOW SYSTEM/NOPROCESS/CLUSTER/FULL
OpenVMS V6.2 on node AAAAAA MAY 12, 1995 10:29 AM Uptime 3 16:37:39
        DEC 3000 Model 500
OpenVMS V6.2 on node BBBBBB MAY 12, 1995 10:29 AM Uptime 3 12:42:56
        DEC 4000 Model 610
OpenVMS V5.5-2 on node CCCCCC MAY 12, 1995 10:29 AM Uptime 3 16:26:52
        MicroVAX 3400 Series
OpenVMS V6.1 on node DDDDDD MAY 12, 1995 10:29 AM Uptime 3 16:41:35
        DEC 4000 Model 610
OpenVMS V6.1 on node EEEEEE MAY 12, 1995 10:29 AM Uptime 3 16:26:10
        VAXstation 3100/GPX

This example displays only the nodes available on the cluster with their respective uptimes and operating system versions because the /NOPROCESS qualifier suppresses the display of processes. The /FULL qualifier also displays the type of hardware on which the system is running.

#5
$ SHOW SYSTEM/PROCESS=S*
OpenVMS V6.2 on node AAAAAA MAY 12, 1995 10:30 AM  Uptime 3 12:43:55
  Pid    Process Name  State   Pri  I/O      CPU      Page flts Pages
20C00101 SWAPPER         HIB    16    0  0 00:00:00.05        0     0
20C0010E SHADOW_SERVER   HIB     6    7  0 00:00:00.03       32     4
20C0010F SECURITY_SERVER HIB    10   35  0 00:00:02.16      292   323
20C00110 SMISERVER       HIB     9   67  0 00:00:00.20      152   131
20C0011A SMITH           CUR 0   4   63  0 00:00:00.29      538    55

This example displays only the processes on the system that begin with the letter S.

#6
$ SHOW SYSTEM/NOHEADING/OUTPUT=SYSPROC.DAT
20C00101 SWAPPER         HIB    16    0  0 00:00:00.05        0     0
20C00105 CONFIGURE       HIB    10   24  0 00:02:00.86       41    21
20C00107 IPCACP          HIB    10    9  0 00:00:00.04       33    43
20C00108 ERRFMT          HIB     7 3583  0 00:00:04.31       50    61
20C00109 CACHE_SERVER    HIB    16    3  0 00:00:00.02       27    35
20C0010A CLUSTER_SERVER  HIB    10   11  0 00:00:00.10       59    75

This example places the display of system processes into the SYSPROC.DAT file without the heading information using the /OUTPUT qualifier. In this way, you can create a data file for processing because the heading is suppressed using the /NOHEADING qualifier.

#7
$ SHOW SYSTEM/IDENT=20C0010D/FULL
OpenVMS V6.2 on node AAAAAA MAY 12, 1995 10:35 AM  Uptime 3 12:48:19
        DEC 4000 Model 610
  Pid    Process Name State  Pri   I/O      CPU      Page flts  Pages
20C0010D JOB_CONTROL   HIB    10    41  0 00:00:00.25       51     66
         [SYSTEM]                                               528Kb

This example displays a system process by PID number.

#8
$ SHOW SYSTEM/OWNER=SMITH
OpenVMS V6.2 on node AAAAAA MAY 12, 1995 10:34 AM  Uptime 3 12:47:37
  Pid    Process Name State  Pri   I/O      CPU      Page flts  Pages
20C00119 DECW$TE_0119  LEF     6   334  0 00:00:01.00      975    657
20C0011A SMITH         LEF     8    63  0 00:00:00.29      538     55
20C0011B _RTA1:        CUR 0   4   554  0 00:00:01.72     1771     70

This example displays the system processes belonging to user SMITH.

#9
$ SHOW SYSTEM/STATE=L*
OpenVMS V6.2 on node AAAAAA MAY 12, 1995 10:36 AM  Uptime 3 12:49:46
  Pid    Process Name State  Pri   I/O      CPU      Page flts  Pages
20C00119 DECW$TE_0119  LEF     6   334  0 00:00:01.00      975    657
20C0011A SMITH         LEF     8    63  0 00:00:00.29      538     55

This example displays the system processes with process states that begin with the letter L.


Note

¹ This information is displayed only if the process is currently in the balance set; if the process is not in the balance set, these columns contain the following message:
 -- 
swapped out -- 



Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  9996P059.HTM
  OSSG Documentation
  26-NOV-1996 11:18:35.68

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal