SHOW
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help SHOW *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
Displays information about the current status of a process, the
system, or devices in the system.
Format
SHOW option
| 1 - Description |
The following table lists all the SHOW command options.
Option Displays
ACCOUNTING Resources the current accounting file is
tracking
AUDIT Security auditing characteristics in effect
on the system
BROADCAST Message classes for which broadcast is
enabled
CLUSTER OpenVMS Cluster activity and performance
CPU Current state of the attached processor
DEFAULT Current default device and directory
DEVICES Status of devices in the system
DEVICE/SERVED Status of devices served by the MSCP server
on an OpenVMS Cluster system
DISPLAY Node where the output from a DECwindows
application running on the current node
will be displayed
ENTRY Information about a user's batch and print
jobs or about specific job entries
ERROR Error count for the CPU, memory, and
physical devices
INTRUSION Contents of the intrusion database
KEY Key definitions created by the DEFINE/KEY
command
LICENSE Software product licenses active on the
current node as well as list of the names
attached to a license (known as the RESERVE
list)
LOGICAL Current logical name assignments
MEMORY Availability and usage of memory resources
NETWORK Information about network services
registered on a node
PRINTER Printer characteristics
PROCESS Attributes of the current process,
including privileges, resource quotas,
memory usage, priority, and accounting
information
PROTECTION Current default protection applied to files
QUEUE Names and types of queues that are
available on the system as well as any
current jobs belonging to your process
QUEUE/CHARACTERISTICS Characteristic names and numbers that have
been defined for system queues
QUEUE/FORM Form names and numbers that have been
defined for system queues
QUEUE/MANAGERS Information about the queue manager(s) on
the system or OpenVMS Cluster
QUOTA Current disk quota authorized for and used
by a specific user on a specific disk
RMS_DEFAULT Current default multiblock and multibuffer
counts used by OpenVMS Record Management
Services (RMS) for file operations
SECURITY Name, class, and profile of a security
object
SERVER Information about the servers
STATUS Status of the current job, including
accumulated CPU time, open file count, and
count of I/O operations
SYMBOL Current symbol definitions
SYSTEM List of all processes in the system
TERMINAL Device characteristics of a terminal
[DAY]TIME Current date and time
TRANSLATION Current logical name assignment
USERS Information about users currently on the
system
WORKING_SET CURRENT working set size limit and quota
ZONE Current state of a VAXft system
| 2 - ACCOUNTING |
Shows what resources the current accounting file is tracking.
Format
SHOW ACCOUNTING
2.1 - Qualifier
2. 1.1 - /OUTPUT
/OUTPUT[=filespec]
Requires read (R) and write (W) access to the directory in which
the specified file is created.
Controls the output destination of the command. By default, the
output is the current SYS$OUTPUT device. To send the output
to a file, use the /OUTPUT qualifier followed by the file
specification.
If the file specification does not include the file name or file
type, the defaults SHOW and .LIS are used respectively.
2.2 - Example
$ SHOW ACCOUNTING
Accounting is currently enabled to log the following activities:
PROCESS any process termination
IMAGE image execution
INTERACTIVE interactive job termination
LOGIN_FAILURE login failures
NETWORK network job termination
PRINT all print jobs
The keywords in this example show that the local node is
tracking the resources used by each:
o Interactive and network process
o Image running in an interactive or network process
o Login failure
o Print job
| 3 - AUDIT |
Displays the security auditing characteristics in effect on the
system.
Requires the SECURITY privilege.
Format
SHOW AUDIT
3.1 - Qualifiers
3. 1.1 - /ALL
Displays all available auditing information including the
following:
o Location of the system security audit log file
o Security events enabled for auditing
o Location of the security archive file
o Audit server characteristics, such as the action taken if the
audit server runs out of memory.
3. 1.2 - /ALARM
Displays the categories of events that are currently enabled;
these events will generate messages on any operator's terminal
accepting security class messages.
3. 1.3 - /ARCHIVE
Displays the name and location of the security archive file (if
archiving is enabled).
3. 1.4 - /AUDIT
Displays the categories of events that are currently enabled to
write messages to the system security audit log file.
3. 1.5 - /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.
3. 1.6 - /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.
3. 1.7 - /JOURNAL
Displays characteristics of the system audit journal.
3. 1.8 - /OUTPUT
/OUTPUT[=filespec]
Controls where the output of the command is sent. If you do not
enter the /OUTPUT qualifier or if you enter it without a file
specification, the output is sent to the default output stream
or device for the current process, which is identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, only a directory name), SET AUDIT
assigns the file name SHOW with the default file type of .LIS.
The file specification cannot include the asterisk (*) and the
percent sign (%) wildcard characters.
3. 1.9 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of 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.
3. 1.10 - /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.
3. 1.11 - /SERVER
Displays audit server characteristics.
3. 1.12 - /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.2 - Example
$ SHOW AUDIT/ALL
List of audit journals:
Journal name: SECURITY
Journal owner: (system audit journal)
Destination: SYS$COMMON:[SYSMGR]SECURITY.AUDIT$JOURNAL
Monitoring: enabled
Warning thresholds, Block count: 100 Duration: 2 00:00:00.0
Action thresholds, Block count: 25 Duration: 0 00:30:00.0
Security auditing server characteristics:
Database version: 4.4
Backlog (total): 100, 200, 300
Backlog (process): 5, 2
Server processing intervals:
Archive flush: 0 00:01:00:00
Journal flush: 0 00:05:00:00
Resource scan: 0 00:05:00:00
Final resource action: purge oldest audit events
Security archiving information:
Archiving events: none
Archive destination:
System security alarms currently enabled for:
ACL
Authorization
INSTALL
Time
Audit: illformed
Breakin: dialup,local,remote,network,detached
Login: batch,dialup,local,remote,network,subprocess,detached
Logfailure: batch,dialup,local,remote,network,subprocess,detached,server
System security audits currently enabled for:
ACL
Mount
Authorization
INSTALL
Time
Audit: illformed
Breakin: dialup,local,remote,network,detached
Login: batch,dialup,local,remote,network,subprocess,detached,server
Logfailure: batch,dialup,local,remote,network,subprocess,detached,server
Logout: batch,dialup,local,remote,network,subprocess,detached,server
FILE access:
Failure: read,write,execute,delete,control
The SHOW AUDIT command in this example displays the auditing
settings after a system installation. See the SET AUDIT/ENABLE
command for descriptions of the individual audit items.
| 4 - BROADCAST |
Displays the message classes that are currently affected by the
SET BROADCAST command.
Format
SHOW BROADCAST
4.1 - Qualifier
4. 1.1 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter the /OUTPUT qualifier
without a file specification, the output is sent to the current
process default output stream or device, identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS is the default file type. The
asterisk (*) and the percent sign (%) wildcard characters are
not allowed.
If you enter the /NOOUTPUT qualifier, output is suppressed.
4.2 - Examples
1.$ SET BROADCAST=ALL
$ SET TERMINAL/NOBROADCAST
$ SHOW BROADCAST
Broadcasts are enabled for all classes
Terminal is set "No Broadcast", no broadcast messages
will be displayed.
The display in this example shows that all message classes
are enabled for broadcast, but that these messages will not be
received because the terminal is set NO BROADCAST.
2.$ SHOW BROADCAST
Broadcasts are currently disabled for:
MAIL
The SHOW BROADCAST display in this example indicates that SET
BROADCAST=NOMAIL is in effect.
3.$ SET BROADCAST=(NOALL,USER1)
$ SET TERMINAL/NOBROADCAST
$ SHOW BROADCAST
Broadcasts are currently disabled for:
GENERAL
PHONE
MAIL
QUEUE
SHUTDOWN
URGENT
DCL
OPCOM
USER2
USER3
USER4
USER5
USER6
USER7
USER8
USER9
USER10
USER11
USER12
USER13
USER14
USER15
USER16
Terminal is set "No Broadcast", no broadcast messages
will be displayed.
This example shows the display you see when messages from USER1
are enabled, but will not be received, because the terminal is
set NO BROADCAST.
4.$ SET BROADCAST=NONE
$ SHOW BROADCAST
Broadcasts are disabled for all classes
This example shows the display you see when SET BROADCAST=NONE
is in effect.
| 5 - CLUSTER |
Invokes the Show Cluster utility to monitor and display cluster
activity and performance.
For more information about the Show Cluster utility, refer to the
OpenVMS System Management Utilities Reference Manual or online
help.
Format
SHOW CLUSTER
If you specify the command without any qualifiers, SHOW CLUSTER
displays a single cluster report and then returns control to the
DCL level.
To invoke a continuous SHOW CLUSTER display, enter the following
command:
$ SHOW CLUSTER/CONTINUOUS
SHOW CLUSTER requires no special privileges because it is
installed with the CMKRNL privilege.
In a continuous display, you can control report output with
SHOW CLUSTER commands. For information about the SHOW CLUSTER
commands, invoke a continuous SHOW CLUSTER display and type HELP
at the Command> prompt.
5.1 - Qualifiers
5. 1.1 - /BEGINNING
/BEGINNING=time
Specifies the time that the SHOW CLUSTER session is to begin. You
can specify absolute time, a delta time, or a combination of the
two. Observe the syntax rules for time values described in the
OpenVMS User's Manual or the online help topic DCL_Tips (subtopic
Date_Time).
If you specify a future time, your process is placed in a state
of hibernation until the specified time. Use this qualifier with
the /OUTPUT and /ENDING qualifiers to run SHOW CLUSTER without
direct user intervention.
You can specify time as absolute time expressed as
[dd-mmm-yyyy[:]] [hh:mm:ss.cc], or a delta time expressed as
[dddd-][hh:mm:ss.cc], or a combination of the two. Observe the
syntax rules for time values described in the OpenVMS User's
Manual or the online help topic DCL_Tips (subtopic Date_Time).
5. 1.2 - /CONTINUOUS
Specifies a continuously updating display. If you omit the
qualifier, SHOW CLUSTER produces a single display and returns
control to the DCL command level.
Running SHOW CLUSTER in the continuous mode allows you to use
SHOW CLUSTER commands to control the display. In a continuous
display, you can control report output with SHOW CLUSTER
commands. For information about the SHOW CLUSTER commands, invoke
a continuous SHOW CLUSTER display and type HELP at the Command>
prompt.
SHOW CLUSTER has commands that allow you to customize the
display. You can add and remove fields and classes, rearrange
the position of windows, scroll their contents, or create
an initialization or command procedure that can recreate a
particular window setup.
To exit from a continuous display and return to the DCL level,
type the EXIT command or press Ctrl/Z.
To exit from SHOW CLUSTER without erasing the screen, press
Ctrl/C.
To interrupt SHOW CLUSTER, press Ctrl/Y.
For a complete description of the Show Cluster utility and
commands, refer to the OpenVMS System Manager's Manual for
overview information and the OpenVMS System Management Utilities
Reference Manual for reference information.
5. 1.3 - /ENDING
/ENDING=time
Specifies the time that the SHOW CLUSTER session is to end. You
can specify an absolute time, a delta time, or a combination
of the two. Observe the syntax rules for time values described
in the OpenVMS User's Manual or the online help topic DCL_Tips
(subtopic Date_Time).
Use this qualifier with the /BEGINNING and /OUTPUT qualifiers to
run SHOW CLUSTER without direct user intervention.
You can specify time as absolute time expressed as [dd-mmm-
yyyy[:]][hh:mm:ss.cc], or a delta time expressed as [dddd-
][hh:mm:s.cc], or a combination of the two. Observe the syntax
rules for time values described in the OpenVMS User's Manual or
the online help topic DCL_Tips (subtopic Date_Time).
5. 1.4 - /INTERVAL
/INTERVAL=seconds
Specifies the number of seconds that display information remains
on the screen before it is updated. By default, the interval time
is 15 seconds.
If you use an initialization file in noncontinuous mode and the
initialization file contains a SET SCREEN command that changes
the screen size, SHOW CLUSTER sets the screen to the specified
size for one update interval and then sets the screen to the
original size.
5. 1.5 - /OUTPUT
/OUTPUT=filespec
Directs the output from SHOW CLUSTER to the specified file
instead of the current SYS$OUTPUT device.
SHOW CLUSTER output is always in printable file format,
regardless of the file or device type specified. Output can be
up to 132 columns wide and can be sent to any file, terminal, or
print device.
You can also direct output to a file with the WRITE command.
The filespec is the name of the file or device to which SHOW
CLUSTER output is directed. The default file name is SHOW_
CLUSTER.LIS.
You can direct output to a device other than SYS$OUTPUT, by
specifying a valid device name.
| 6 - CPU |
Displays the current state of the processors in an OpenVMS
system.
Format
SHOW CPU [cpu-id[,...]]
6.1 - Parameter
cpu-id[,...]
Specifies a decimal value representing the identity of a
processor in a OpenVMS multiprocessing system. On a VAX 6000
system or an Alpha 7000 system, the CPU ID is the backplane slot
number of the processor.
6.2 - Qualifiers
6. 2.1 - /ACTIVE
Selects as the subject of the display only those processors that
are members of the system's active set.
6. 2.2 - /ALL
Selects all configured processors, active and inactive, as the
subject of the display.
6. 2.3 - /BRIEF
Produces information from the summary display and also lists the
current CPU state and current process (if any) for each processor
in the configuration.
6. 2.4 - /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.
6. 2.5 - /FULL
Produces information from the summary display. The /FULL
qualifier also lists the current CPU state, the current process
(if any), the revision levels, and the capabilities for each
configured processor. It indicates which processes can execute
only on certain processors in the configuration. In addition, if
one or more uniprocessing drivers are present in the system, the
/FULL qualifier lists them by name.
The SHOW CPU/FULL command lists the current process on each
configured processor without stopping other activity on the
system. The current process may change while the data is
displayed. As a result, there may be apparent inconsistencies in
the display. For example, a process may be listed as the current
process on more than one CPU.
This qualifier also displays whether the CPU is enabled or
disabled for use as a Fast Path preferred CPU, then lists the
Fast Path ports assigned to it, and shows whether or not the
ports are user-assigned.
For more information about using Fast Path features to improve
I/O performance, refer to the OpenVMS I/O User's Reference
Manual.
6. 2.6 - /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.
6. 2.7 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter the /OUTPUT qualifier
without a file specification, the output is sent to the current
process default output stream or device, identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS the default file type. If you
enter a file specification, it may not include the asterisk (*)
and the percent sign (%) wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
6. 2.8 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of device 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.
6. 2.9 - /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.
6. 2.10 - /SUMMARY
Produces a display listing the processors in the OpenVMS
multiprocessing or single-CPU system, indicating which is the
primary processor, which processors are configured, and which
processors are active. The /SUMMARY qualifier also indicates the
minimum revision levels required for processors in the system,
which OpenVMS synchronization image has been loaded into the
operating system, and whether multiprocessing is enabled. If
the presence of one or more uniprocessing drivers in the system
prohibits the enabling of multiprocessing, the SHOW CPU command
displays a warning message.
6. 2.11 - /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.
6.3 - Examples
1.$ SHOW CPU
SOWHAT, A VAX 8800
Multiprocessing is ENABLED. Full checking synchronization image
loaded.
Minimum multiprocessing revision levels: CPU = 0 uCODE = 0 UWCS = 0.
PRIMARY CPU = 01
Active CPUs: 00 01
Configured CPUs: 00 01
The SHOW CPU command in this example produces a configuration
summary of all configured processors in the VAX 8800 system
SOWHAT. The primary processor is CPU 01, and all configured
processors are active.
2.$ SHOW CPU/BRIEF
SOWHAT, A VAX 8800
Multiprocessing is ENABLED. Full checking synchronization image
loaded.
Minimum multiprocessing revision levels: CPU = 0 uCODE = 0 UWCS = 0.
PRIMARY CPU = 01
CPU 00 is in RUN state
Current Process: AIREGIN PID = 4A8001E5
CPU 01 is in RUN state
Current Process: ***None***
The SHOW CPU/BRIEF command in this example produces a
configuration summary of the VAX 8800 system SOWHAT and also
indicates that its two processors are in the RUN state. Only
CPU 00 has a current process.
3.$ SHOW CPU/FULL
BIG1, a AlphaServer 4100 5/466 4MB
Multiprocessing is ENABLED. Full checking synchronization image loaded.
System Information:
Page Size = 8192
Revision Code =
Serial Number = NI83603713
Default CPU Capabilities:
System: QUORUM RUN
Default Process Capabilities:
System: QUORUM RUN
Primary CPU = 000
CPU 000 State: RUN
Process Name: SYSTEM
PID: 00000438
Capabilities:
System: PRIMARY QUORUM RUN RAD0
Slot Context:
CPU - Type...........: EV56 (21164A), Pass 2
State..........: RC, PA, PP, CV, PV, PMV, PL
Variation......: VAX FP, IEEE FP, Primary Eligible
Serial Number..:
Revision.......:
Halt Request...: 0
Software Comp..: 5.5
PALCODE - Revision Code..: 1.21-01
Compatibility..: 1
Max Shared CPUs: 4
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings:
NETACP PID = 00000417 Reason: PRIMARY Capability
Features:
AUTOSTART is enabled.
Enabled for use as a Fastpath Preferred CPU.
Fastpath ports assigned:
*** None ***
CPU 001 State: RUN
Process Name: SETI@home 10%
PID: 0000041F
Capabilities:
System: QUORUM RUN RAD0
Slot Context:
CPU - Type...........: EV56 (21164A), Pass 2
State..........: RC, PA, PP, CV, PV, PMV, PL
Variation......: VAX FP, IEEE FP
Serial Number..:
Revision.......:
Halt Request...: 0
Software Comp..: 5.5
PALCODE - Revision Code..: 1.21-01
Compatibility..: 1
Max Shared CPUs: 4
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings:
*** None ***
Features:
AUTOSTART is enabled.
Enabled for use as a Fastpath Preferred CPU.
Fastpath ports assigned:
PKC0
*** None ***
CPU 002 State: RUN
Process Name: SETI@home 19%
PID: 00000420
Capabilities:
System: QUORUM RUN RAD0
Slot Context:
CPU - Type...........: EV56 (21164A), Pass 2
State..........: RC, PA, PP, CV, PV, PMV, PL
Variation......: VAX FP, IEEE FP
Serial Number..:
Revision.......:
Halt Request...: 0
Software Comp..: 5.5
PALCODE - Revision Code..: 1.21-01
Compatibility..: 1
Max Shared CPUs: 4
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings:
*** None ***
Features:
AUTOSTART is enabled.
Enabled for use as a Fastpath Preferred CPU.
Fastpath ports assigned:
PKB0
*** None ***
CPU 003 State: RUN
Process Name: SETI@home 92%
PID: 00000422
Capabilities:
System: QUORUM RUN RAD0
Slot Context:
CPU - Type...........: EV56 (21164A), Pass 2
State..........: RC, PA, PP, CV, PV, PMV, PL
Variation......: VAX FP, IEEE FP
Serial Number..:
Revision.......:
Halt Request...: 0
Software Comp..: 5.5
PALCODE - Revision Code..: 1.21-01
Compatibility..: 1
Max Shared CPUs: 4
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings:
*** None ***
Features:
AUTOSTART is enabled.
Enabled for use as a Fastpath Preferred CPU.
Fastpath ports assigned:
*** None ***
The SHOW CPU/FULL command in this example produces a
configuration summary of the AlphaServer 4100 5/466 4MB system,
BIG1. All are in the RUN state and all have a current process.
Note that NETACP can only run on CPU 0, because only CPU 0 has
primary capability. Note also that CPUs 1 and 2 have Fastpath
ports, PKC0 and PKB0 respectively assigned.
4.$ SHOW CPU/FULL
OLEO, A VAX 6000-420
Multiprocessing is DISABLED. MULTIPROCESSING System parameter = 02
Minimum multiprocessing revision levels -- CPU: 0 uCODE: 0 UWCS: 21.
PRIMARY CPU = 02
*Loaded unmodified device drivers prevent multiprocessor operation.*
RBDRIVER
CPU 02 is in RUN state
Current Process: Koko PID = 2A6001E3
Revision levels: CPU: 0 uCODE: 0 UWCS: 0.
Capabilities of this CPU:
PRIMARY VECTOR RUN
Processes which can only execute on this CPU:
CONFIGURE PID = 2A40010B Reason = PRIMARY Capability
Reason = RUN Capability
CPU 07 is in INIT state
Current Process: *** None ***
Revision levels: CPU: 0 uCODE: 0 UWCS: 0.
Capabilities of this CPU:
*** None ***
Processes which can only execute on this CPU:
*** None ***
The SHOW CPU/FULL command in this example produces a
configuration summary of the VAX 6000-420 system OLEO,
indicating that only CPU 02, the primary CPU, is active and
in the RUN state. It also shows that there is a uniprocessing
driver loaded in the system, thus preventing the system from
being enabled as a multiprocessor.
5.$ SET PROCESS /AFFINITY /SET=3 SYSTEM/PERMANENT
$ SHOW CPU 3/FULL
BIG1, a AlphaServer 4100 5/466 4MB
Multiprocessing is ENABLED. Full checking synchronization image loaded.
System Information:
Page Size = 8192
Revision Code =
Serial Number = NI83603713
Default CPU Capabilities:
System: QUORUM RUN
Default Process Capabilities:
System: QUORUM RUN
Primary CPU = 000
CPU 003 State: RUN
Process Name: SYSTEM
PID: 00000438
Capabilities:
System: QUORUM RUN RAD0
Slot Context:
CPU - Type...........: EV56 (21164A), Pass 2
State..........: RC, PA, PP, CV, PV, PMV, PL
Variation......: VAX FP, IEEE FP
Serial Number..:
Revision.......:
Halt Request...: 0
Software Comp..: 5.5
PALCODE - Revision Code..: 1.21-01
Compatibility..: 1
Max Shared CPUs: 4
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings:
SYSTEM PID = 00000438 Reason: Affinitized to this CPU
Features:
AUTOSTART is enabled.
Disabled for use as a Fastpath Preferred CPU.
Fastpath ports assigned to this CPU:
PNA0 (user assigned)
In this example, the SYSTEM process has its affinity set
permanently to CPU3. The SHOW CPU command indicates this is
the BINDINGS list.
The port PNA0 was assigned to CPU 3 by a user when CPU 3 was
enabled as a Fast Path preferred CPU. Subsequent to that
operation, CPU 3's bit was cleared in the IO_PREFER_CPUS
system parameter. This disabled CPU 3 for use as a Fast Path
preferred CPU. Normally this is a transient condition, as
changing IO_PREFER_CPUS results in the FASTPATH_SERVER process
redistributing the Fast Path ports across the set of usable
CPUs.
However, if there is no FASTPATH_SERVER process, PNA0 remains
assigned to this CPU until any of the following actions occur:
1. The user tries to move the port to another CPU by using the
SET DEVICE/PREFERRED_CPU command, $QIO, or the $IO_FASTPATH
system service.
2. The CPU is stopped.
| 7 - DEFAULT |
Displays the current default device and directory.
Format
SHOW DEFAULT
7.1 - Examples
1.$ SHOW DEFAULT
DISK1:[ALAMO]
$ SET DEFAULT DISK5:[SKONETSKI.SOURCES]
$ SHOW DEFAULT
DISK5:[SKONETSKI.SOURCES]
The SHOW DEFAULT command in this example displays the current
default device and directory names. The SET DEFAULT command
changes these defaults, and the next SHOW DEFAULT command
displays the new default device and directory.
2.$ SET DEFAULT NOSUCH:[NOWAY]
$ SHOW DEFAULT
NOSUCH:[NOWAY]
%DCL-I-INVDEF, NOSUCH:[NOWAY] does not exist
In this example, the default has been set to a nonexistent
device and directory. An error message is displayed.
3.$ DEFINE/TRANSLATION_ATTRIBUTES=CONCEALED XYZ WORK:[INVOICES.]
$ SET DEFAULT XYZ:[HESHELMAN]
$ SHOW DEFAULT
XYZ:[HESHELMAN]
In this example, a logical name, XYZ, is defined to represent
WORK:[INVOICES]. The /TRANSLATION_ATTRIBUTES=CONCEALED
qualifier tells the system not to display the translation of
XYZ in file specifications. Thus, the SHOW DEFAULT command
displays the logical name XYZ and not its translation.
4.$ SET DEFAULT WRK:[SCHENKENBERGER]
$ SHOW DEFAULT
WRK:[SCHENKENBERGER]
$ DEFINE KUDOS WRK:[SCHENKENBERGER.TEMP1],WRK:[SCHENKENBERGER.TEMP2]
$ SET DEFAULT KUDOS
$ SHOW DEFAULT
KUDOS:[SCHENKENBERGER]
In this example, the logical name KUDOS is defined as a search
list containing the directories [SCHENKENBERGER.TEMP1] and
[SCHENKENBERGER.TEMP2] on device WRK. The SET DEFAULT command
equates this search list logical name with the logical name
SYS$DISK. The subsequent SHOW DEFAULT command displays the
search list logical name along with its equivalence strings.
Because the directory field has not been explicitly specified,
the original [SCHENKENBERGER] directory remains in effect as
the current default directory; however, unless the current
default directory syntax ([]) is explicitly used, all file
references are to those directories contained in the search
list.
| 8 - DEVICES |
Displays the status of a device on the system.
See the qualifier descriptions for restrictions.
Format
SHOW DEVICES [device-name[:]]
8.1 - Parameter
device-name[:]
Specifies the name of a device for which information is to be
displayed. The device name displayed by the system uses the
format ddcu where dd is the device code, c is the controller
designation, and u is the unit number. If the system is part
of an OpenVMS Cluster that is running with HSC controllers, the
device name must include the node name using the format node$ddcu
(where node is the node name).
You can specify a complete device name or only a portion of
a device name. The SHOW DEVICES command provides defaults for
nonspecified portions of device names, as follows:
o If you truncate a device name (for example, if you specify D),
the command lists information about all devices whose device
names begin with what you entered (in this case, D). However,
if you specify a device in an OpenVMS Cluster that is running
with HSC controllers, you must include the entire node portion
of the device name.
o If you omit a controller designation, the SHOW DEVICES command
lists all devices on all controllers with the specified unit
number.
o If you omit a unit number, the SHOW DEVICES command lists all
devices on the specified controller.
Note that the /FILES qualifier does not support defaults for
nonspecified portions of device names; you must supply a complete
device specification.
8.2 - Qualifiers
8. 2.1 - /ALLOCATED
Displays all devices currently allocated to processes.
If you specify a device name, the characteristics of only that
device are displayed. If the device is not currently allocated,
the command displays a message indicating that there is no such
device. If you specify a generic device name, the characteristics
of all allocated devices of that type are displayed.
8. 2.2 - /BRIEF
/BRIEF (default)
Displays brief information about the specified devices.
8. 2.3 - /BITMAP
/BITMAP ddcu:
Creates a new table showing all active bitmaps for a given
device. Included in the display are the size and index number
of the bitmaps.
Initially, up to 6 bitmaps can be active on a particular device.
Note that the SHOW DEVICE/FULL ddcu: display also displays status
to indicate that bitmaps are active on the device.
8. 2.4 - /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.
8. 2.5 - /FILES
Requires SYSPRV (system privilege) or BYPASS privileges to list
read-protected files.
Displays a list of the names of all files open on a volume and
their associated process name and process identification (PID).
The specified device must be a mounted Files-11 volume. If the
specified volume is a multivolume set, the files on each volume
in the set are listed.
NOTE
The SHOW DEVICES/FILES command does not support defaults
for nonspecified portions of device names. You must supply
a complete device specification when using the /FILES
qualifier.
If the /SYSTEM qualifier is also specified, only the names of
installed files and files opened by the system are displayed.
Files opened by the system are those that have been opened
without the use of an ancillary control process (ACP), such
as INDEXF.SYS and QUOTA.SYS, as well as system files such as
JBCSYSQUE.EXE and SYSMSG.EXE.
If the /NOSYSTEM qualifier is specified, only those files opened
by processes are displayed. To list files opened by a process in
your group, your process must have at least GROUP privilege. If
the process is not in your group, you need WORLD privilege.
If neither the /SYSTEM nor the /NOSYSTEM qualifier is specified,
the names of all files currently opened on the system are
displayed.
If a file is read-protected from your user identification code
(UIC), the "No privilege" message is displayed instead of the
file name. You must have SYSPRV (system privilege) privilege or
BYPASS privilege to display the file name.
A space in place of a file name represents a work file (such as
a temporary edit file) not entered in any directory. To display
temporary file names, you must have BYPASS privilege in addition
to GROUP or WORLD privilege.
Do not use the /FILES qualifier with the /ALLOCATED, /BRIEF,
/FULL, or /MOUNTED qualifier. The functions of the /FILES
qualifier and these qualifiers are mutually exclusive.
8. 2.6 - /FULL
Displays a complete list of information about the devices, except
for rebuild status. You must use the /REBUILD_STATUS qualifier to
get that information.
8. 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.
8. 2.8 - /MOUNTED
Displays all devices that currently have volumes mounted on them.
If you specify a device name, only the characteristics of that
device are displayed; however, if the device is not currently
mounted, the command issues a message indicating there is no such
device. If you specify a generic device name, the characteristics
of all such devices that currently have volumes mounted are
displayed.
8. 2.9 - /MULTIPATH
Displays all devices that are currently multipath sets.
If you specify a device name, only the characteristics of that
device are displayed; however, if the device is not a multipath
set, the command issues a message indicating there is no such
device. If you specify a generic device name, the characteristics
of all such devices that are currently multipath sets are
displayed.
8. 2.10 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter the /OUTPUT qualifier
without a file specification, the output is sent to the current
process default output stream or device, identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS the default file type. If you
enter a file specification, it may not include the asterisk (*)
and the percent sign (%) wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
8. 2.11 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of device 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.
8. 2.12 - /REBUILD_STATUS
Tells you whether volumes need rebuilding.
You may need to rebuild a volume if the volume was improperly
dismounted. Volumes are improperly dismounted when, for example,
the system crashes.
For each volume, SHOW DEVICES/REBUILD_STATUS returns one of these
values:
Value Meaning
Yes Rebuild needed.
No Rebuild not needed.
Not applicable You cannot rebuild this volume. This value is
returned if, for example, the volume is not a
disk, or the volume is write-locked.
Information Rebuild information is unavailable. This value
unavailable is returned when, for example, the volume is
not mounted, or mount verification is taking
place.
To rebuild a volume, either:
o Use SET VOLUME/REBUILD
o Dismount the volume, then mount the volume again using
MOUNT/REBUILD
You cannot use the /REBUILD_STATUS qualifier with any other SHOW
DEVICES qualifiers, except /OUTPUT.
8. 2.13 - /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.
8. 2.14 - /SYSTEM
/SYSTEM
/NOSYSTEM
Controls whether the names of installed files and files opened
by the system are displayed. Files opened by the system are those
that have been opened without the use of an ancillary control
process (ACP), such as INDEXF.SYS and QUOTA.SYS.
If you specify the /NOSYSTEM qualifier with the /FILES qualifier,
only files opened by processes are displayed. If you omit both
the /SYSTEM and /NOSYSTEM qualifiers and specify the /FILES
qualifier, the names of all files currently open on the system
are displayed.
You can use this qualifier only with the /FILES qualifier. See
the description of the /FILES qualifier for more details.
8. 2.15 - /WINDOWS
Displays the window count and total size of all windows for files
open on a volume. The file name and related process name and
process identification (PID) are also displayed. The letter C
in a display indicates that the file is open with "cathedral
windows" (segmented windows).
8. 2.16 - /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.
8.3 - Examples
1.$ SHOW DEVICES
Device Device Err. Volume Free Trans Mount
Name Status Count Label Blocks Count Count
DKA0: Online mnt 0 VMS 47088 115 1
DKA1: Online mnt 0 USERPACK1 45216 2 1
DKA2: Online mnt 3 DOCUMENT 8068 20 1
DKA5: Online mnt 0 MASTERP 28668 1 1
DKA6: Online 0
DKA7: Online mnt 0 PROJECT 110547 1 1
DMA0: Online 0
DLA0: Online 0
DYA0: Online 0
DYA1: Online 0
DRA3: Online mnt 0 RES26APR 29317 1 1
In this example, the SHOW DEVICES command displays the
following information for each device on the system:
o Device name
o Device status and characteristics (status indicates whether
the device is on line; characteristics indicate whether the
device is allocated, is spooled, has a volume mounted on it,
or has a foreign volume mounted on it)
o Error count
o Volume label (for disk and tape volumes only)
o Number of free blocks on the volume
o Transaction count
o Number of mount requests issued for the volume (disk devices
only)
2.$ SHOW DEVICE/FULL DKB0:
Disk $DKB0:, device type RZ56, is online, mounted, file-oriented
device, shareable, error logging is enabled.
Error count 0 Operations completed 392750
Owner process "" Owner UIC [1,4]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W
Reference count 317 Default buffer size 512
Total blocks 1299174 Sectors per track 54
Total cylinders 1604 Tracks per cylinder 15
Volume label "SYSTEM_DISK" Relative volume number 0
Cluster size 3 Transaction count 278
Free blocks 367632 Maximum files allowed 162396
Extend quantity 5 Mount count 1
Mount status System Cache name "$DKB0:XQPCACHE"
Extent cache size 64 Maximum blocks in extent cache 36763
File ID cache size 64 Blocks currently in extent cache 36258
Quota cache size 0 Maximum buffers in FCP cache 210
Volume owner UIC [1,1] Vol Prot S:RWCD,O:RWCD,G:RWCD,W:RWCD
Volume status: ODS-2, subject to mount verification, protected
subsystems enabled, file high-water marking, write-through
caching enabled.
In this example, the SHOW DEVICES command requests a full
listing of the status of the RZ56 device DKB0.
3.$ SHOW DEVICES/REBUILD_STATUS
Device Name Rebuild needed?
ADU15$DKA300: Information unavailable
EDIV$DKA300: Information unavailable
EMUL$DKB200: No
EMUL$DKB300: No
EMUL$DKB500: Yes
FTA0: Not applicable
OPA0: Not applicable
In this example, the volume mounted on device EMUL$DKB500 needs
rebuilding.
4.$ SHOW DEVICES/FULL NODE2$
Disk NODE2$DUA0:, device type RA81, is online, mounted,
error logging enabled
Error count 0 Operations completed 24195
Owner UIC [11,177] Owner process name
Owner process ID 20200000 Dev Prot S:RWPL,O:RWPL,G:RWPL,W:RWPL
Reference count 16 Default buffer size 512
Volume label VMSDOCLIB Relative volume no. 0
Cluster size 3 Transaction count 17
Free blocks 525447 Maximum files allowed 111384
Extend quantity 5 Mount count 1
Volume status System ACP process name
Caching disabled
Volume is subject to mount verification, file high-water marking
Disk NODE2$DUA1:, device type RA81, is online, error logging enabled
Error count 0 Operations completed 0
Owner UIC [0,0] Owner process name
Owner process ID 20200000 Dev Prot S:RWED,O:RWED,G:RWED,W:RWED
Reference count 0 Default buffer size 512
.
.
.
In this example, the user requested a full display of
information about each device on NODE2 in the OpenVMS Cluster.
Information is shown here only for the first two devices: a
mounted device and a device that is not mounted.
5.$ SHOW DEVICE $1$DKB1:/FULL
Disk $1$DKB1: (VMSRMS), device type RRD40, is online, allocated,
deallocate on dismount, mounted, software write-locked, file-oriented
device, shareable, served to cluster via MSCP Server
Error count 0 Operations completed 15
Owner process "_FTA5:" Owner UIC [1,4]
Owner process ID 2020005D Dev Prot S:RWPL,O:RWPL,G:R,W
Reference count 2 Default buffer size 512
Total blocks 256 Sectors per track 32
Total cylinders 1 Tracks per cylinder 8
Allocation class 1
Volume label "VOLUME_1" Relative volume number 64
Cluster size 0 Transaction count 1
Free blocks 0 Maximum files allowed 0
Extend quantity 0 Mount count 1
Mount status Process ACP process name "DAD2CACP"
Volume status: ISO 9660.
Members of this volume set are $1$DKB7: (rvn 64), $1$DKB4: (rvn 8),
$1$DKB1: (rvn 1), $1$DKB12: (rvn 4096), $1$DKB16: (rvn 65535),
$1$DKB6: (rvn 32).
In this example, the user requested a full display on a
VAX system of a device contained on a member of an ISO 9660
partially mounted volume set. Note the volume status displays
the media format as ISO 9660, and the volume set list shows a
sparce list of the currently mounted members of the volume set.
6.$ SHOW DEVICES MUA1/FULL
Magtape $4$MUA1: (HSC70), device type TA79, is online, device is
equipped with a stacker/loader, file-oriented device, available
to cluster, error logging is enabled.
Error count 0 Operations completed 0
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W
Reference count 0 Default buffer size 2048
Density 1600 Format Normal-11
Host name "HSC70" Host type, avail HS70, yes
Allocation class 4
Volume status: no-unload on dismount, odd parity.
In this example, the user requested a full display of the tape
device MUA1.
7.$ SHOW DEVICE/FULL $1$DKA221
Disk $1$DKA221: (HSC952), device type RZ29, is online, mounted,
file-oriented device, shareable, available to cluster, error
logging is enabled.
Error count 0 Operations completed 6509
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W
Reference count 108 Default buffer size 512
Current preferred CPU Id 1 FastPath 1
Total blocks 8380080 Sectors per track 4
Total cylinders 65470 Tracks per cylinder 32
Host name "HSC952" Host type, avail HS95, yes
Allocation class 1
Volume label "GALAXY_X6L5" Relative volume number 0
Cluster size 4 Transaction count 302
Free blocks 4691760 Maximum files allowed 838008
Extend quantity 5 Mount count 2
Mount status System Cache name "_$1$DKA221:XQPCACHE"
Extent cache size 64 Maximum blocks in extent cache 469176
File ID cache size 64 Blocks currently in extent cache 237504
Quota cache size 0 Maximum buffers in FCP cache 1734
Volume owner UIC [1,1] Vol Prot S:RWCD,O:RWCD,G:RWCD,W:RWCD
Volume Status: ODS-2, subject to mount verification, protected
subsystems enabled, file high-water marking, write-through
caching enabled.
Volume is also mounted on MEAD.
This disk is a device that performs its I/O through the Fast
Path port PNA0. Fast Path is enabled for this disk, and its
I/O will be processed on the preferred CPU, CPU 1, which is
associated with its Fast Path port PNA0.
The /FULL qualifier also displays additional information about
Fast Path devices. A Fast Path device may be either a class
device or a port device. An example of a class device is an
HSC disk, and an example of a port device is the CI. For both
Fast Path class devices and ports, the display indicates that
Fast Path is enabled and lists the current CPU ID to which that
device is assigned. Additionally, for a Fast Path port, the
display indicates the port's user-established CPU preference
(if any).
The current preferred CPU and the User Preferred CPU can be
set by using the DCL command, SET DEVICES/PREFERRED_CPU, or by
issuing a $QIO.
For more information about using Fast Path features to improve
I/O performance, refer to the OpenVMS I/O User's Reference
Manual.
8.$ SHOW DEVICE/FULL PNA0
Device PNA0:, device type CIXCD, is online, shareable, error logging
is enabled.
Error count 0 Operations completed 0
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W
Reference count 0 Default buffer size 0
Current preferred CPU Id 1 FastPath 1
The above display shows that port PNA0 is assigned to CPU 1 and
that Fast Path is enabled.
9.$ SHOW DEVICE/FULL PNA0
Device PNA0:, device type CIXCD, is online, shareable, error logging
is enabled.
Error count 0 Operations completed 0
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W
Reference count 0 Default buffer size 0
Current preferred CPU Id 1 FastPath 1
User preferred CPU Id 2
This example shows a Fast Path assignment made by a user.
Normally, the User Preferred CPU ID matches the current
preferred CPU ID. The reason for the mismatch in the above
display is because CPU 2 was stopped. The port was previously
assigned to CPU 2. But when CPU 2 was stopped, the operating
system moved the port assignment from CPU 2 to CPU 1.
If CPU 2 were started, the operating system would assign the
device to the User Preferred CPU.
10$ SHOW DEVICE/FULL DSA0
Disk DSA0:, device type RAM Disk, is online, mounted, file-oriented
device, shareable, available to cluster, error logging is enabled,
device supports bitmaps (no bitmaps active).
Error count 0 Operations completed 47
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W
Reference count 2 Default buffer size 512
Total blocks 1000 Sectors per track 64
Total cylinders 1 Tracks per cylinder 32
Volume label "TST0" Relative volume number 0
Cluster size 1 Transaction count 1
Free blocks 969 Maximum files allowed 250
Extend quantity 5 Mount count 1
Mount status System Cache name "_$252$DUA721:XQPCACHE"
Extent cache size 64 Maximum blocks in extent cache 96
File ID cache size 64 Blocks currently in extent cache 0
Quota cache size 0 Maximum buffers in FCP cache 404
Volume owner UIC [SYSTEM] Vol Prot S:RWCD,O:RWCD,G:RWCD,W:RWCD
Volume Status: ODS-2, subject to mount verification, file high-water
marking, write-back caching enabled.
Disk $252$MDA0:, device type RAM Disk, is online, member of shadow set DSA0:.
Error count 0 Shadow member operation count 128
Allocation class 252
Disk $252$MDA1:, device type RAM Disk, is online, member of shadow set DSA0:.
Error count 0 Shadow member operation count 157
Allocation class 252
This example shows that a write bitmap exists for a shadow set,
and that no write bitmap is active. If a shadow set supports
write bitmaps, "device supports bitmaps" is displayed along
with either "bitmaps active" or "no bitmaps active". If the
device does not support write bitmaps, no message pertaining to
write bitmaps is displayed.
11$ SHOW DEVICE/BITMAP DSA1
Device BitMap Size Percent of
Name ID (Bytes) Full Copy
DSA12: 00010001 652 11%
This example shows a SHOW DEVICE/BITMAP display. You can find
out the ID of each write bitmap on a node with this command.
The /BITMAP qualifier is similar to the /REBUILD qualifier
in that neither can be combined with most other SHOW DEVICE
qualifiers. The SHOW DEVICE/BITMAP display can be brief or
full; brief is the default.
If no bitmap is active, no bitmap file ID is displayed. The
phrase "no bitmaps active" is displayed.
8.4 - /SERVED
Displays information on devices served by the mass storage
control protocol (MSCP) server on this node. The /SERVED
qualifier is required.
Format
SHOW DEVICES/SERVED
8. 4.1 - Qualifiers
8. 4. 1.1 - /ALL
This qualifier displays the information displayed by all of the
qualifiers listed below except the /OUTPUT qualifier.
8. 4. 1.2 - /COUNT
Displays the number of transfer operations completed, sorted by
the size of the transfers, and the number of MSCP operations that
have taken place since the MSCP server was started.
8. 4. 1.3 - /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.
8. 4. 1.4 - /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.
8. 4. 1.5 - /HOST
Displays the names of the processors that have MSCP served
devices on line. The System Generation utility (SYSGEN) command
MSCP/HOST determines how many hosts in the OpenVMS Cluster can
connect to the MSCP server at one time.
8. 4. 1.6 - /OUTPUT
/OUTPUT=[filespec]
Redirects output from your terminal to the specified file. If
you do not specify a file, or if you do not use this qualifier,
output is sent to SYS$OUTPUT.
8. 4. 1.7 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of device 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.
8. 4. 1.8 - /RESOURCE
Displays information about the resources available to the MSCP
server for use in processing I/O requests for the devices it
serves.
You make these resources available by using the following system
parameters: MSCP_BUFFER, MSCP_CREDITS, MSCP_LOAD, and MSCP_SERVE_
ALL.
Refer to OpenVMS Cluster Systems or SYSGEN online help for more
information.
8. 4. 1.9 - /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.
8. 4.2 - Examples
1.$ SHOW DEVICES/SERVED
MSCP-Served Devices on BIAK 28-MAY-2001 13:48:01.32
Queue Requests
Device: Status Total Size Current Max Hosts
11$DUA8 Online 2376153 0 2 6
11$DUA9 Avail 2376153 0 0 0
11$DUA10 Online 2376153 0 2 8
11$DUA11 Online 2376153 0 2 7
11$DUA13 Online 2376153 0 2 7
11$DUA14 Avail 2376153 0 0 0
11$DUA16 Avail 2376153 0 0 0
11$DUS16 Avail 2376153 0 1 0
11$DUA17 Avail 2376153 0 0 0
11$DUA18 Online 2376153 0 1 4
11$DUA19 Online 2376153 0 4 7
11$DUA20 Online 2376153 0 1 7
11$DUA21 Online 2376153 0 17 12
This example shows the output generated by the command
SHOW DEVICES/SERVED. The first column in the display shows
the names of the devices that are served by the MSCP server.
The second column shows the status of the devices. The third
column shows the size, in blocks, of the device.
The Queue Requests columns show the number of I/O requests
currently awaiting processing by that device and the maximum
number of I/O requests that have ever been concurrently
awaiting processing by that device. The last column in the
display shows the number of hosts that have the device on line.
2.$ SHOW DEVICES/SERVED/COUNT
MSCP-Served Devices on BIAK 28-MAY-2001 13:49:52.41
.
.
.
Request Count:
0-7: 951154 32-39: 2168 88-103: 1618
8-15: 197224 40-55: 2543 104-127: 189
16-23: 137707 56-71: 8343
24-31: 982 72-87: 141
Operations Count:
ABORT 0 ERASE 22772 READ 1042206
ACCESS 0 FLUSH 0 REPLACE 0
AVAILABLE 611 GET COM STS 0 SET CTL CHR 176
CMP CTL DAT 0 GET UNT STS 4026024 SET UNT CHR 3630
CMP HST DAT 0 ONLINE 427 WRITE 259953
Total 5355799
This example shows the information displayed by the SHOW
DEVICES/SERVED/COUNT command. The numbers to the left of the
colon (:), separated by a hyphen (-), are the size, in pages,
of the requests. The numbers to the right of the colon are the
number of requests of that size that have been processed by the
MSCP server.
The section of the display headed by the label Operations Count
shows the number of times the MSCP server has performed the
MSCP operations listed. In the example, this MSCP server has
performed 176 set-controller-characteristics (SET CTL CHR)
operations, and has performed 3630 set-unit-characteristics
(SET UNT CHR) operations.
3.$ SHOW DEVICES/SERVED/RESOURCE
MSCP-Served Devices on BIAK 28-MAY-2001 13:51:32.01
.
.
.
Resources: Total Free In Use
Buffer Area: 400 400 0
I/O Packets: 0 0
Current Maximum
Buffer Wait: 0 0
This example shows the information displayed by the SHOW
DEVICES/SERVED/RESOURCE command. The Total column shows the
total number of pages in the buffer area and in the number of
I/O-request packets set aside for use by the MSCP server. The
Free column shows the number of pages in the buffer and the
number of I/O-request packets that are available for use.
The In Use column shows the number of pages within the buffer
area that are in use.
The line labeled Buffer Wait shows the number of I/O requests
that are currently waiting for buffer space to become available
for their use, and the maximum number of I/O requests that have
waited concurrently to obtain a buffer.
4.$ SHOW DEVICES/SERVED/HOST
MSCP-Served Devices on BIAK 28-NOV-2001 13:54:41.99
.
.
.
Queue Requests
Host: Time of Connection Current Max Devices
IPL31 25-MAY-2001 21:44:06.44 0 1 0
DELAND 25-MAY-2001 21:44:09.98 0 1 0
HEAVEN 25-MAY-2001 22:03:15.67 0 7 10
VIVA 26-MAY-2001 09:44:11.96 0 1 0
.
.
.
This example shows the information displayed by the SHOW
DEVICES/SERVED/HOST command. The first column contains the
names of the hosts that have class drivers connected to the
MSCP server. The next column contains the times at which these
connections were made.
The columns under the heading Queue Requests show the number
of requests the MSCP server currently has outstanding for I/O
activity on the devices it serves, the maximum number of such
requests that have been outstanding at one time, and the number
of MSCP server devices that the listed hosts have on line.
5.$ SHOW DEVICES/SERVED
MSCP-Served Devices on HEN 3-DEC-2001 09:09:08.49
Queue Requests
Device: Status Total Size Current Max Hosts
254$DJB1 Avail 0 0 0 0
254$DUA2 Online 1216665 0 0 1
254$DUA4006 Avail 0 0 0 0
TMSCP-Served Devices on HEN 3-DEC-2001 09:09:08.74
Queue Requests
Device: Status Position Current Max Hosts
90$MUA7 Avail 0 0 0 0
90$MUA8 Avail 0 0 0 0
90$MUA50 Online 3804 0 0 0
This example displays the output of the SHOW DEVICES/SERVED
command from a node that has both MSCP server and TMSCP server
devices. In the display, the third column for MSCP server disk
devices shows the size of the disk device. The same column
for TMSCP server device shows the location where each tape is
currently positioned.
| 9 - DISPLAY |
Indicates the node where output from a DECwindows application
will be displayed.
Format
SHOW DISPLAY [display-device]
9.1 - Parameter
display-device
Refers to the display-device parameter specified with the SET
DISPLAY command. If you are directing application output to
multiple workstations in the same session, you can use logical
names to point to each workstation. Using the SHOW DISPLAY
command, you can specify this logical name as the display-device
parameter to see where application output will be displayed.
If you do not specify a display-device string, the logical name
DECW$DISPLAY is used.
9.2 - Example
$ SHOW DISPLAY
Device: WSA1:
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
$ SET DISPLAY/CREATE/NODE=ZEPHYR
$ SHOW DISPLAY
Device: WSA2:
Node: ZEPHYR
Transport: DECNET
Server: 0
Screen: 0
$ SPAWN/NOWAIT/INPUT=NL: RUN SYS$SYSTEM:DECW$CLOCK
In this example, you are logged in to your workstation, here
referred to as node 0. (0 is the standard shorthand notation
for representing your node.) You want to run the DECwindows
Clock on your workstation and display it on another node,
ZEPHYR.
Assuming you are authorized to display applications on ZEPHYR,
you redirect the application's output to ZEPHYR with the SET
DISPLAY command and enter the SHOW DISPLAY command to verify
the location of the redirected display. You then run Clock.
Note that a new workstation display device, WSA2, is created
when you enter the SET DISPLAY/CREATE command.
| 10 - ENTRY |
Displays information about a user's batch and print jobs or about
specific job entries.
Requires read (R) access to the queue.
Format
SHOW ENTRY [entry-number[,...]],[job-name[,...]]
10.1 - Parameters
entry-number[,...]
Specifies the entry number of the job you want displayed. If
no entry number or job name is specified, all your own jobs (or
those owned by the user specified with the /USER_NAME qualifier)
are displayed.
job-name[,...]
Specifies the name of the jobs you want displayed. The asterisk
(*) and the percent sign (%) wildcard characters are allowed. If
no job name or entry number is specified, all your own jobs (or
those owned by the user specified with the /USER_NAME qualifier)
are displayed.
10.2 - Qualifiers
10. 2.1 - /BATCH
Selects batch jobs for display.
10. 2.2 - /BRIEF
/BRIEF (default)
Displays the following information for each job: entry number,
job name, user name, job size in blocks (for print jobs), job
status, queue name, queue status, and queue type. The /FULL and
/FILES qualifiers override the /BRIEF qualifier.
Specify the /FULL qualifier to obtain more job information.
10. 2.3 - /BY_JOB_STATUS
/BY_JOB_STATUS[=(keyword,...)]
Selects for display only those jobs with the specified status.
Specify the status with one or more of the following keywords:
EXECUTING Requests the display of jobs in any of the
following states:
ABORTING STALLED
EXECUTING STARTING
PRINTING SUSPENDED
PROCESSING
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. 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.
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.
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 remains in the queue.
TIMED_ Requests the display of jobs on hold until a
RELEASE specified time. Timed-release status indicates that
the job is being held in the queue for execution at
a specified time.
If no keyword is specified, the /BY_JOB_STATUS qualifier displays
the status of all jobs.
10. 2.4 - /DEVICE
/DEVICE[=(keyword,...)]
Selects for display only those print jobs in the queue types
specified. Specify the queue type with one or more of the
following keywords:
PRINTER Requests the display of jobs in print queues.
SERVER Requests the display of jobs in server queues.
TERMINAL Requests the display of jobs in terminal queues.
If no keyword is specified, the /DEVICE qualifier displays all
jobs in printer, terminal, or server queues.
10. 2.5 - /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.
10. 2.6 - /FILES
Adds to the default display the list of full file specifications
for each file in each job. The /FILES qualifier overrides the
default /BRIEF qualifier.
10. 2.7 - /FULL
Displays the following information for each job: entry number,
job name, user name, job status, full file specification
associated with each job, date and time of submission, settings
specified for the job, queue name, queue status, and queue type.
The /FULL qualifier overrides the default /BRIEF qualifier.
10. 2.8 - /GENERIC
Selects for display only those jobs contained in generic queues.
A generic queue holds jobs of a particular type (for example,
batch or line printer jobs) and directs them to execution queues
for processing.
10. 2.9 - /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.
10. 2.10 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW ENTRY command is sent.
By default, the output 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.
10. 2.11 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of 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.
10. 2.12 - /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.
10. 2.13 - /USER_NAME
/USER_NAME=username
Selects for display those jobs owned by the specified user. If
the /USER_NAME qualifier is not specified, information about
your own jobs is displayed. The name must be 1 to 12 alphanumeric
characters.
10. 2.14 - /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.
10.3 - Examples
1.$ SHOW ENTRY/BY_JOB_STATUS=RETAINED
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
422 FORECAST JONES Retained on completion
On stopped generic batch queue CLUSTER_BATCH
Completed 21-DEC-2001 16:18 on queue NODE_BATCH
In this example, the SHOW ENTRY command displays a job entry
that was retained on completion.
2.$ SHOW ENTRY/FULL S*
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
625 STAFF ESTES 112 Pending (queue stopped)
On stopped printer queue LN01$PRINT
Submitted 19-DEC-2001 12:14 /FORM=LN01$PORTRAIT
(stock=DEFAULT) /NOTIFY /PRIORITY=100
File: _DKA1:[ESTES]STAFF.DIS;3
629 SEARCH ESTES 94 Printing
On printer queue LINE$PRINT
Submitted 19-DEC-2001 12:16 /FORM=DEFAULT /NOTIFY
/PRIORITY=100 /COPIES=2 /NOFEED /PASSALL
File: _DKA1:[ESTES.DAILY]SEARCH.TXT;2 (printing copy 2)
In this example, the SHOW ENTRY command displays the current
jobname entries beginning with the letter "S" owned by ESTES
on all queues. The /FULL qualifier lists the submission
information, the full file specification, and the current
settings for the job.
Note that entry 629 specified the /COPIES, /NOFEED, and
/PASSALL qualifiers to the PRINT command. The /NOFEED qualifier
suppresses automatic form feeds. The /PASSALL qualifier
suppresses formatting (including form feeds and carriage return
characters) performed by the print symbiont.
3.$ SUBMIT ASSIGNMENTS.COM
Job ASSIGNMENTS.COM (queue SYS$BATCH, entry 199) pending
.
.
.
$ SHOW ENTRY 199/FULL
Entry Jobname Username Status
----- ------- -------- ------
199 ASSIGNMENTS JONES Executing
Submitted 19-DEC-2001 08:36 /KEEP /NOLOG/ NOPRINT
/PRIORITY=100
File: DUA2:[JONES]ASSIGNMENTS.COM;34
In this example, JONES submits ASSIGNMENTS.COM for batch
processing. Because JONES does not specify a specific queue,
the job is entered into the generic SYS$BATCH queue to await
processing. After performing other tasks, JONES checks the job
status and sees that the file is now executing. Note that the
job entry migrated from a generic to an execution batch queue
and that JONES was able to check the job status without knowing
the specific batch queue name. If the user did not specify an
entry number, all jobs would have been displayed.
| 11 - ERROR |
Displays the error count for all devices with error counts
greater than zero.
Format
SHOW ERROR
11.1 - Qualifiers
11. 1.1 - /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.
11. 1.2 - /FULL
Displays the error count for all devices, including those with no
errors. (The error count is either zero or a number greater than
zero.)
11. 1.3 - /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.
11. 1.4 - /OUTPUT
/OUTPUT[=filespec]
/OUTPUT=SYS$OUTPUT (default)
Specifies the file to which the display is written. By default,
the display is written to the current SYS$OUTPUT device.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS the default file type. The
asterisk (*) and the percent sign (%) wildcard characters are
not allowed in the file specification.
If you enter the /NOOUTPUT qualifier, output is suppressed.
11. 1.5 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of error 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.
11. 1.6 - /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.
11. 1.7 - /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.
11.2 - Example
$ SHOW ERROR
Device Error Count
CPU: 2
MEMORY: 1
DBB1: 9
The SHOW ERROR command displays the error count for all devices
with error counts greater than zero.
| 12 - INTRUSION |
Displays the contents of the intrusion database.
Requires SECURITY privilege.
Format
SHOW INTRUSION
12.1 - Qualifiers
12. 1.1 - /NODE
/NODE[=(node-name[,...])]
The /NODE qualifier displays each intrusion record with the
supporting node information.
If you specify individual nodes, the supporting node information
is displayed only for the nodes listed.
12. 1.2 - /OLD
On VAX, displays the contents of the old kernel mode intrusion
database. The kernel mode intrusion database was used by the
system and layered products prior to OpenVMS VAX Version 6.1. It
is still updated by the system to provide backwards compatability
to applications that have not yet converted over to using the
supported system services for access to the intrusion database.
Entries added directly to the old kernel mode intrusion database
by applications may be examined only by using the /OLD qualifier.
12. 1.3 - /OUTPUT
/OUTPUT[=filespec]
Directs the output from the SHOW INTRUSION command to the file
specified with the qualifier. By default, output from the command
is displayed to SYS$OUTPUT.
12. 1.4 - /TYPE
/TYPE=keyword
Selects the type of information from the intrusion database that
is displayed. The valid keywords are as follows:
ALL All entries. By default, all entries are displayed.
SUSPECT Entries for login failures that have occurred but have
not yet passed the threshold necessary to be identified
as intruders.
INTRUDER Entries for which the login failure rate was high
enough to warrant evasive action.
12.2 - Examples
1.$ SHOW INTRUSION/OUTPUT=INTRUDER.LIS
The SHOW INTRUSION command in this example writes all the
entries currently in the intrusion database to the file
INTRUDER.LIS.
2.$ SHOW INTRUSION/TYPE=INTRUDER
Intrusion Type Count Expiration Source
TERMINAL INTRUDER 9 10:29:39.16 AV34C2/LC-1-15:
NETWORK INTRUDER 7 10:47:53.12 NODE22::RONNING
In this example, the SHOW INTRUSION command displays all
intruder entries currently in the intrusion database.
3.$ SHOW INTRUSION/NODE
NETWORK SUSPECT 5 26-JUL-2001 08:51:25.66 POPEYE::WONG
Node: TSAVO Count: 2
Node: FROGGY Count: 2
Node: KITTY Count: 1
This command displays each intrusion record for all nodes.
4.$ SHOW INTRUSION/NODE=(FROGGY,KITTY)
NETWORK SUSPECT 5 26-JUL-2001 08:51:25.66 POPEYE::HAMMER
Node: FROGGY Count: 2
Node: KITTY Count: 2
This command displays intrusion record information for nodes
FROGGY and KITTY.
5.$ SHOW INTRUSION/NODE=EVMSA
$
This command shows that there are no intrusion records for node
EVMSA.
| 13 - KEY |
Displays the key definitions created with the DEFINE/KEY command.
Format
SHOW KEY [key-name]
13.1 - Parameter
key-name
Specifies the name of the key whose definition you want
displayed. For a list of valid key names, see the DEFINE/KEY
command.
13.2 - Qualifiers
13. 2.1 - /ALL
Displays all key definitions in the current state (or the
state specified with the /STATE qualifier). If you use the /ALL
qualifier, do not specify a key name.
13. 2.2 - /BRIEF
/BRIEF (default)
/NOBRIEF
Displays only the key definition and state. The /BRIEF and
/NOFULL qualifiers are equivalent.
13. 2.3 - /DIRECTORY
Displays the names of all states for which keys have been
defined. If you have not specified a state with a key definition,
the SHOW KEY/DIRECTORY command displays DEFAULT for the state.
You cannot use the /DIRECTORY qualifier with any of the other
SHOW KEY qualifiers.
13. 2.4 - /FULL
/FULL
/NOFULL (default)
Displays all qualifiers associated with a definition. By default,
only the state of the definition and the definition itself are
displayed. The /FULL and /NOBRIEF qualifiers are equivalent.
13. 2.5 - /STATE
/STATE=(state-name[,...])
/NOSTATE
Displays the key definitions for the specified state. If you
specify only one state name, you can omit the parentheses. State
names can be any appropriate alphanumeric string. State names are
created with the DEFINE/KEY command.
If you omit the /STATE qualifier or use the /NOSTATE qualifier,
key definitions in the current state are displayed.
13.3 - Example
$ DEFINE/KEY/TERMINATE PF1 "ATTACH BOB"
%DCL-I-DEFKEY, DEFAULT key PF1 has been defined
$ SHOW KEY PF1
DEFAULT keypad definitions:
PF1 = "ATTACH BOB"
$ SHOW KEY/FULL PF1
DEFAULT keypad definitions:
PF1 = "ATTACH BOB" (noecho,terminate,noerase,nolock)
The SHOW KEY command in this example displays both the
definition and the state for the PF1 key. This is the default
display. The SHOW KEY/FULL command displays all qualifiers
associated with the key definition.
| 14 - LICENSE |
Displays software product licenses active on the current node
and lists the names attached to a license (known as the RESERVE
list). The SHOW LICENSE command displays the license database
information currently in your system's memory. Use the License
Management utility command, LICENSE LIST, when you want to view
the license database information that is on disk.
Format
SHOW LICENSE [product-name [,...]]
14.1 - Parameter
product-name
Specifies the name or names of activated software product
licenses to display. The asterisk (*) and the percent sign (%)
wildcard characters are allowed. If you do not specify a product
name, information is displayed about all active product name
licenses. The product-name parameter is incompatible with the
/UNIT_REQUIREMENTS qualifier.
14.2 - Qualifiers
14. 2.1 - /BEFORE
Use with /TERMINATION_DATE and /RELEASE_DATE qualifiers. Selects
only those licenses whose times are before the time specified
with the other qualifiers.
The /BEFORE qualifier cannot be used with the /SINCE qualifier.
14. 2.2 - /BRIEF
/BRIEF (default)
Displays a summary of information about the specified active
product licenses. Use the /FULL qualifier to obtain a complete
product license listing.
14. 2.3 - /CHARGE_TABLE
Synonym for the /UNIT_REQUIREMENTS qualifier.
14. 2.4 - /CLUSTER
Use with the /UNIT_REQUIREMENTS qualifier to display the license
unit requirements for every node in an OpenVMS Cluster.
14. 2.5 - /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.
14. 2.6 - /FULL
Displays a summary of information about the specified active
product licenses, including Product Authorization Key (PAK)
options and the reserve list (if any).
14. 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.
14. 2.8 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW LICENSE command is sent.
By default, the output of the SHOW LICENSE 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.
14. 2.9 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of license 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.
14. 2.10 - /PRODUCER
/PRODUCER=producer-name
Displays software product licenses active on the current node
and supplied by the specified producer. The asterisk (*) and
the percent sign (%) wildcard characters are allowed for the
producer-name parameter. You cannot use the /PRODUCER qualifier
with the /UNIT_REQUIREMENTS qualifier.
14. 2.11 - /RELEASE_DATE
/RELEASE_DATE=[date_time]
Allows listing licenses using release dates as selection
criteria.
14. 2.12 - /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.
14. 2.13 - /SINCE
/SINCE(default)
Use with the /TERMINATION_DATE and /RELEASE_DATE qualifiers.
Selects only those licenses whose times are on or after the time
specified with the other qualifiers.
The /SINCE qualifier cannot be used with the /BEFORE qualifier.
14. 2.14 - /TERMINATION_DATE
/TERMINATION_DATE=date_time
Allows listing licenses using termination dates as selection
criteria.
14. 2.15 - /UNIT_REQUIREMENTS
Displays information in the License Unit Requirement Table
(LURT). The /UNIT_REQUIREMENTS qualifier is incompatible with
the product-name parameter and with the /BRIEF and /PRODUCER
qualifiers.
14. 2.16 - /USAGE
Tells you how many license units are loaded, how many are
currently allocated, and how many are currently available, as
well as the license type for each product on the system. Use with
the /FULL qualifier to display complete information-including the
PID, process name, node, or user name-for each instance of use
of the product. You need group privilege to see the list of users
in your group who have allocated license units; you need world
privilege to see the list of users in all groups.
In an OpenVMS Cluster, if you own multiple license types for a
single product, you are limited to viewing the usage information
for the license type loaded on the node from which you are
executing the SHOW LICENSE/USAGE command. To find out the usage
of the other license type loaded on another node, issue the
command on that node. You can also use the System Management
(SYSMAN) utility to do this.
In an OpenVMS Cluster, usage information is limited to the local
license type. For example, VAX and Alpha availability licenses
are considered by LMF to be different license types. If you
are running both VAX and Alpha systems in a cluster, usage
information for availability licenses is limited to the local
system type. For example, if you have DEC C installed on all
nodes in your OpenVMS Cluster, you can display DEC C license
allocation on all the VAX nodes in the cluster from any VAX node
with DEC C installed, but you cannot display the DEC C license
allocation on the Alpha nodes.
Usage information is not available for unlimited licenses (a
license with 0 units). Clusterwide usage information is not
available for personal use or NO_SHARE licenses. Refer to the
OpenVMS License Management Utility Manual for more information on
license types.
14. 2.17 - /WARNING_INTERVAL
/WARNING_INTERVAL=n
NOWARNING_INTERVAL
Displays a warning stating the number of licenses that will
terminate in n days. The default is 30 days.
14. 2.18 - /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.
14.3 - Examples
1.$ SHOW LICENSE/FULL
Active licenses on node WTPOOH:
DVNETEND
Producer: DEC
Units: 0
Version: 0.0
Date: (none)
Termination Date: (none)
Availability: E (System Integrated Products)
Activity: 0
MOD_UNITS
VAX-VMS
Producer: DEC
Units: 0
Version: 0.0
Date: (none)
Termination Date: (none)
Availability: A (VMS Capacity)
Activity: 0
MOD_UNITS
NO_SHARE
The SHOW LICENSE command in this example displays all the
active licenses on the current node, WTPOOH.
2.$ SHOW LICENSE/BRIEF
Active licenses on node WTPOOH:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
DVNETEND DEC 0 E 0 0.0 (none) (none)
VAX-VMS DEC 0 A 0 0.0 (none) (none)
The SHOW LICENSE command in this example displays a summary of
all the active licenses on the current node, WTPOOH.
3.$ SHOW LICENSE/OUTPUT=SYS$LOGIN:ACTIVE_LICENSES_OCT30.DAT
The SHOW LICENSE command in this example writes all the active
licenses to the file named SYS$LOGIN:ACTIVE_LICENSES_OCT30.DAT.
4.$ SHOW LICENSE/FULL PERSONAL
Active licenses on node PICCHU:
PERSONAL
Producer: DEC
Units: 100
Version: 0.0
Release Date: (none)
Termination Date: (none)
Availability: 0
Activity: 100
RESERVE_UNITS
Reserve: RANCE
The SHOW LICENSE command in this example displays information
about the product PERSONAL, as well as the name RANCE attached
to the product license (known as the RESERVE list).
5.$ SHOW LICENSE/TERM=10-JAN-2014 test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST01 DEC 0 A 0 0.0 (none) (none)
TEST02 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none)
TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015
TEST05 DEC 0 E 0 0.0 14-NOV-2016 14-AUG-2016
$ SHOW LICENSE/RELEASE=10-JAN-2014/SINCE test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST02 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none)
TEST05 DEC 0 E 0 0.0 14-NOV-2016 14-AUG-2016
$ SHOW LICENSE/RELEASE=10-JAN-2014/BEFORE test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST01 DEC 0 A 0 0.0 (none) (none)
TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015
In these examples, the SHOW LICENSE command uses the /TERM,
/RELEASE, /SINCE and /BEFORE qualifiers.
6.$ SHOW LICENSE/UNIT_REQUIREMENTS
VMS/LMF Charge Information for node PICCHU
This is a VAX 6000-420, hardware model type 160
Type: A, Units Required: 93 (VMS Capacity)
Type: B, * Not Permitted * (VMS Server)
Type: C, * Not Permitted * (VMS Concurrent User)
Type: D, * Not Permitted * (VMS Workstation)
Type: E, Units Required: 400 (System Integrated Products)
Type: F, Units Required: 1200 (Layered Products)
Type: G, * Not Permitted * (VMS Reserved)
Type: H, * Not Permitted * (Alpha Layered Products)
Type: I, Units Required: 1200 (Layered Products)
In this example, the /UNIT_REQUIREMENTS qualifier displays
information in the License Unit Requirement Table (LURT).
7.$ SHOW LICENSE/WARNING_INTERVAL=8000 test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST01 DEC 0 A 0 0.0 (none) (none)
TEST02 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none)
TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015
TEST05 DEC 0 E 0 0.0 14-NOV-2016 14-AUG-2016
%SHOW-I-TERMIMM, 3 licenses will terminate in 8000 days
The /WARNING_INTERVAL qualifier in this example displays three
licenses that will terminate in 8000 days.
8.$ SHOW LICENSE/USAGE/FULL DECWRITE-USER
View of loaded licenses from node SLTG24 29-DEC-2001 13:36:22.23
ACTIVITY license DECWRITE-USER usage information:
Pid Process Name Units Username Node
416000E6 MACAHAY 100 MACAHAY SLTG24
416000E7 MACAHIGH 100 MACAHIGH SLTG24
416000E8 ALICE 100 ALICE SLTG24
416000E9 MORGEN 100 MORGEN SLTG24
416000F1 ANGEL 100 ANGEL SLTG24
416000F2 ANGEL_1 100 ANGEL SLTG24
Units loaded: 2000 Units allocated: 600 Units available: 1400
The SHOW LICENSE command in this example lists the current
users of the activity license for the product DECwrite. For
each instance of use of the product, the process identification
(PID), process name, node, and user name are identified. The
units column shows the number of units allocated for each
particular invocation of the product. The last line displays
the units loaded when the LICENSE LOAD command was given, the
total number of units currently allocated, and the total of
unused (available for others to use) units.
9.$ SHOW LICENSE/USAGE/FULL TEST_PER
View of loaded licenses from node: SLTG24 30-DEC-2001 15:45:59
PERSONAL USE license DEC TEST_PER usage information:
Units Reserved for:
100 UNCLE
100 AUNT
100 NEPHEW
100 NIECE
Units loaded: 600 Units reserved: 400 Units available: 200
This example shows a personal use license. The DEC TEST_PER
product has enough units for six reservations with 100 units
for each reservation. The license database (LDB) only has
a total of four names in the reserve list attached to this
product. If the license administrator (usually the system
manager) wants to take full advantage of this license and adds
2 more names to the reserve list, he should use the following
commands to update the product information:
$ LICENSE MODIFY TEST_PER/RESERVE=(NAME, ANOTHER_NAME)/ADD
$ LICENSE UNLOAD TEST_PER
$ LICENSE LOAD TEST_PER
If this product is used in a cluster environment, you may use
the SYSMAN utility to unload and load the license.
10.$ SHOW LICENSE/USAGE/FULL TEST_CAP
View of loaded licenses from node: SLTG24 30-DEC-2001 15:45:59
Availability license DEC TEST_CAP usage information:
Units Node
10 SLTG24
10 SLTG43
600 TORN8O
600 LTNUP
Units loaded: 620 Units allocated: 1220 Units available: ***
In this example, the number of units allocated appears to be
greater than the total units loaded and the units available
value is three asterisks (***).
When you see three asterisks (***) as the number of units
available, it is generally not a cause for alarm. This
situation might arise when the license database (LDB) has
been updated on disk, but the new information has not been
propagated to the license database in memory on all nodes in
the cluster. This node, SLTG24, happens to be one of the nodes
that has not received the latest LDB information.
To update the information in the license database in memory for
the TEST_CAP product, enter the following commands:
$ LICENSE UNLOAD TEST_CAP
$ LICENSE LOAD TEST_CAP
The next time you issue the SHOW LICENSE/USAGE command the
three asterisks (***) in display should disappear. If,
however, you are using multiple LDB files in a cluster, you
should read the section on the license database in the OpenVMS
License Management Utility Manual.
11.$ SHOW LICENSE/UNIT_REQUIREMENT/CLUSTER
VMS/LMF Cluster License Unit Requirements Information 24-DEC-2001
14:05:51.65
Node A B C D E F G H I
KARBO - - - 100 50 10 - - 10
JENJON - - - 100 50 10 - - 10
HELENE 143 - - - 600 2400 - - 2400
SHAKTI - - - 100 50 10 - - 10
Total Cluster Unit Requirements
Type: A, Units Required: 143 (VMS Capacity)
Type: B, * Not Permitted * (VMS Server)
Type: C, * Not Permitted * (VMS Concurrent User)
Type: D, Units Required: 300 (VMS Workstation)
Type: E, Units Required: 750 (System Integrated Products)
Type: F, Units Required: 2430 (Layered Products)
Type: G, * Not Permitted * (VMS Reserved)
Type: H, * Not Permitted * (Alpha Layered Products)
Type: I, Units Required: 2430 (Layered Products)
In this example, the display shows how many license units are
required for each license type (A, B, etc.) on each node in the
cluster. If a row of three asterisks (***) is displayed for a
node, it means that the node is in the process of booting.
| 15 - LOGICAL |
Displays translations, the level of translation, and the logical
name table for a specified logical name. The SHOW LOGICAL command
performs iterative translations.
Requires read (R) access to the table in which a logical name is
cataloged to display information about the logical name.
Format
SHOW LOGICAL [logical-name[:][,...]]
15.1 - Parameter
logical-name[:][,...]
Specifies one or more logical names whose translations you want
to display. The asterisk (*) and the percent sign (%) wildcard
characters are allowed; however, if a wildcard character is used,
iterative translation is not done.
The logical name is translated iteratively up to a number
of times determined by the system (from 9 to 11). That is,
translations are examined to see if they are also logical names.
15.2 - Qualifiers
15. 2.1 - /ACCESS_MODE
/ACCESS_MODE=mode
Displays names defined in the specified access mode and any inner
access modes. You can specify one of the following keywords to
indicate the access mode: USER_MODE, SUPERVISOR_MODE, EXECUTIVE_
MODE, or KERNEL_MODE.
The default value for this qualifier is USER_MODE; by default any
definitions in all four access modes are displayed.
15. 2.2 - /ALL
/ALL (default)
Indicates that all logical names in the specified logical name
tables are to be displayed. If you do not enter the /PROCESS,
/JOB, /GROUP, /SYSTEM, or /TABLE qualifier, all logical names
in the tables specified by the logical name LNM$DCL_LOGICAL are
displayed.
15. 2.3 - /DESCENDANTS
/DESCENDANTS
/NODESCENDANTS (default)
Controls whether the system displays names from the specified
logical name table and any descendant tables. A descendant table
is created by the CREATE/NAME_TABLE command, with the /PARENT_
TABLE qualifier specifying its parent table. If you use the
/DESCENDANTS qualifier, you must also use the /TABLE qualifier.
15. 2.4 - /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.
15. 2.5 - /FULL
Displays more detailed information for the specified logical
name. The information includes the access mode, attributes, the
translation, and the logical name table.
15. 2.6 - /GROUP
Indicates that only the group logical name table is to
be searched. The /GROUP qualifier is synonymous with the
/TABLE=LNM$GROUP qualifier. If you specify the /GROUP qualifier
and you do not also specify a logical name, all names in the
group table are displayed.
15. 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.
15. 2.8 - /JOB
Indicates that only the job logical name table is to be searched.
The /JOB qualifier is synonymous with the /TABLE=LNM$JOB
qualifier. If you specify the /JOB qualifier and you do not also
specify a logical name, all names in the job logical name table
are displayed.
15. 2.9 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW LOGICAL command is sent.
By default, the output of the SHOW LOGICAL 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.
15. 2.10 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of 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.
15. 2.11 - /PROCESS
Indicates that only the process logical name table is to
be searched. The /PROCESS qualifier is synonymous with the
/TABLE=LNM$PROCESS qualifier. If you specify the /PROCESS
qualifier and you do not also specify a logical name, all names
in the process table are displayed.
15. 2.12 - /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.
15. 2.13 - /STRUCTURE
/STRUCTURE
/NOSTRUCTURE (default)
Controls whether the system displays the "family tree" of all
accessible logical name tables. The display includes the two
logical name directory tables (process and system) and all
logical name tables cataloged in these directory tables. Any
descendant logical name tables are shown under their parent
tables.
If you specify the /STRUCTURE qualifier, you cannot use any other
qualifiers except /ACCESS_MODE, /FULL, and /OUTPUT.
15. 2.14 - /SYSTEM
Indicates that only the system logical name table is to
be searched. The /SYSTEM qualifier is synonymous with the
/TABLE=LNM$SYSTEM qualifier. If you specify the /SYSTEM qualifier
and you do not also specify a logical name, all names in the
system table are displayed.
15. 2.15 - /TABLE
/TABLE=(name[,...])
Specifies the tables you want to search. If you specify only one
table, you can omit the parentheses. The asterisk (*) and the
percent sign (%) wildcard characters are allowed. Names with
wildcards are used to match table names. Names without wildcard
characters are treated both as table names and table search lists
(whichever is appropriate).
You can use the /TABLE qualifier to specify the following:
o A user-defined logical name table (created with the
CREATE/NAME_TABLE command)
o The process, group, or system logical name tables
o The process or system directory tables
If you specify the table name by using a logical name that
translates to more than one table, then each table is searched
in the order specified. For example, if you specify SHOW
LOGICAL/TABLE=LNM$FILE_DEV, and LNM$FILE_DEV is equated to
LNM$PROCESS, LNM$JOB, LNM$GROUP, and LNM$SYSTEM, then the
process, job, group, and system tables are searched, in that
order.
If you do not specify the /TABLE qualifier, the default is
/TABLE=LNM$DCL_LOGICAL.
15. 2.16 - /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.
15.3 - Examples
1.$ SHOW LOGICAL/PROCESS
(LNM$PROCESS_TABLE)
"SYS$COMMAND" = "_TTB4:"
"SYS$DISK" = "WORK6:"
"SYS$DISK" = "WORK6:"
"SYS$ERROR" = "_TTB4:"
"SYS$INPUT" = "_TTB4:"
"SYS$LOGIN" = "WORK6:[ODONNELL]"
"SYS$LOGIN_DEVICE" = "WORK6:"
"SYS$OUTPUT" = "_TTB4:"
"SYS$OUTPUT" = "DKA2:"
"SYS$SCRATCH" = "WORK6:[ODONNELL]"
The SHOW LOGICAL command in this example displays all
process logical names and their translations. (Note that
/TABLE=LNM$PROCESS would produce the same display as /PROCESS.)
2.$ SHOW LOGICAL INFILE
"INFILE" = "WORK6:[LOGAN]PAYROLL.EXE" (LNM$PROCESS_TABLE)
The SHOW LOGICAL command in this example displays the
translation for the logical name INFILE. The response indicates
that the logical name was found in the process logical name
table.
3.$ SHOW LOGICAL/GROUP
.
.
.
The SHOW LOGICAL command in this example displays all
group logical names and their translations. (Note that
/TABLE=LNM$GROUP would produce the same display as /GROUP.)
4.$ SHOW LOGICAL/TABLE=SYSTEM SYS$LIBRARY
"SYS$LIBRARY" = "SYS$SYSROOT:[SYSLIB]" (LNM$SYSTEM_TABLE)
The SHOW LOGICAL command in this example displays the
translation of the logical name SYS$LIBRARY in the system
table. The response indicates that SYS$LIBRARY is defined
in the system table, and that the logical name has two
translations.
5.$ SHOW LOGICAL/TABLE=LNM$GROUP/TABLE=LNM$SYSTEM SYS$DISK
"SYS$DISK" = "ZZZ3:" (LNM$SYSTEM_TABLE)
The SHOW LOGICAL command in this example is qualified by both
the /TABLE=LNM$GROUP and /TABLE=LNM$SYSTEM qualifiers. The
response indicates that the logical name SYS$DISK was found in
the system logical name table. When you enter two conflicting
qualifiers, as in this example, only the last qualifier you
specify is used.
6.$ SHOW LOGICAL/TABLE=LNM$PROCESS_DIRECTORY
The SHOW LOGICAL command in this example displays the logical
names in the process directory table. Each name is either a
table name, or a name that translates iteratively to a table.
| 16 - MEMORY |
Displays the availability and usage of those system resources
that are related to memory.
Format
SHOW MEMORY
16.1 - Qualifiers
16. 1.1 - /ALL
/ALL (default)
Displays all available information, that is, information
displayed by the /FILES, /PHYSICAL_PAGES, /POOL, and /SLOTS
qualifiers.
16. 1.2 - /BUFFER_OBJECTS
/BUFFER_OBJECTS (Alpha only)
Displays information about system resources used by buffer
objects.
16. 1.3 - /CACHE
/CACHE[=(keyword[,...])]
Displays information about the Virtual I/O Cache facility or
the Extended File Cache facility, depending on which is loaded.
The Cache facility information is displayed as part of the SHOW
MEMORY and SHOW MEMORY/CACHE/FULL commands.
If the Extended File Cache is loaded, you can specify the
following keywords and options:
VOLUME[=device] Requests display of volume-level statistics
for the specified volume(s). If no device
is specified, defaults to SYS$DISK. Device
specifications may be wildcarded; if so, the
device specification must be based on the
physical device name. Specify VOLUME=* to see
statistics for all volumes in cache.
FILE=filespec Requests display of file-level statistics for
the specified file(s) in cache. The filespec
must contain an explicit or implicit device
specification. The filespec may be wildcarded
according to RMS rules. Specify FILE=dev:*.*
to see statistics for all files in cache for a
device. Partially wild file specifications that
are satisfied by large numbers of files on disk
may incur significant processing overhead during
display. By default, both open and closed files
are displayed (use the OPEN and CLOSED keywords
to further restrict which files are displayed).
Note that this command may fail if you select a
large number of files for display. If you receive
an error message, reduce the number of selected
files and reissue the command.
TOPQIO[=n] Requests display of file-level statistics for
the n files in cache with the highest overall QIO
count (n defaults to 10).
TOPHITRATE[=n] Requests display of file-level statistics for the
n files in cache with the highest overall cache
hit rate (n defaults to 10).
OPEN Include only open files in the display
(default for TOPQIO and TOPHITRATE).
CLOSED Include only closed files in the
display.
16. 1.4 - /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.
16. 1.5 - /FILES
Displays information about the use of each paging and swapping
file currently installed.
16. 1.6 - /FULL
Displays additional information about each pool area or paging
and swapping file currently installed, when used with the /POOL
or the /FILES qualifier.
This qualifier is ignored unless the /FILES or the /POOL
qualifier is specified explicitly. (Note that for Version 7.3
EFT2, the /FULL qualifier is ignored.)
When used with the /CACHE qualifier, /FULL displays additional
information about the file data cache that is loaded (either VIOC
or XFC).
16. 1.7 - /GH_REGIONS
On Alpha, displays information about the granularity hint regions
(GHR) that have been established. For each of these regions,
information is displayed about the size of the region, the amount
of free memory, the amount of memory in use, and the amount of
memory released to OpenVMS from the region. The granularity hint
regions information is also displayed as part of SHOW MEMORY,
SHOW MEMORY/ALL, and SHOW MEMORY/FULL commands.
16. 1.8 - /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.
16. 1.9 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter the /OUTPUT qualifier
without a file specification, the output is sent to the current
process default output stream or device, identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS the default file type. If you
enter a file specification, it cannot include asterisk (*) and
the percent sign (%) wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
16. 1.10 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of memory 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.
16. 1.11 - /PHYSICAL_PAGES
Displays information about the amount of physical memory and the
number of free and modified pages.
16. 1.12 - /POOL
Displays information about the usage of each dynamic memory
(pool) area, including the amount of free space and the size
of the largest contiguous block in each area.
16. 1.13 - /RESERVED
/RESERVED (Alpha only)
Displays information about memory reservations.
16. 1.14 - /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.
16. 1.15 - /SLOTS
Displays information about the availability of partition control
block (PCB) vector slots and balance slots.
16. 1.16 - /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.
16.2 - Examples
1.$ SHOW MEMORY
System Memory Resources on 20-JAN-2001 15:22:04.11
Physical Memory Usage (pages): Total Free In Use Modified
Main Memory (2.00Gb) 262144 201249 60162 733
Extended File Cache (Time of last reset: 18-JAN-2001 17:15:14.33)
Allocated (Mbytes) 370.00 Maximum size (Mbytes) 1024.00
Free (Mbytes) 317.79 Minimum size (Mbytes) 370.00
In use (Mbytes) 52.20 Percentage Read I/Os 72%
Read hit rate 96% Write hit rate 0%
Read I/O count 119363 Write I/O count 46259
Read hit count 115283 Write hit count 0
Reads bypassing cache 45 Writes bypassing cache 0
Files cached open 372 Files cached closed 392
Vols in Full XFC mode 0 Vols in VIOC Compatible mode 3
Vols in No Caching mode 0 Vols in Perm. No Caching mode 0
Granularity Hint Regions (pages): Total Free In Use Released
Execlet code region 1024 0 586 438
Execlet data region 256 0 256 0
S0/S1 Executive data region 576 0 576 0
Resident image code region 1024 0 830 194
Slot Usage (slots): Total Free Resident Swapped
Process Entry Slots 647 614 33 0
Balance Set Slots 645 614 31 0
Dynamic Memory Usage: Total Free In Use Largest
Nonpaged Dynamic Memory (Mb) 4.28 2.38 1.89 2.25
Bus Addressable Memory (Kb) 168.00 128.00 40.00 128.00
Paged Dynamic Memory (Mb) 5.68 3.42 2.26 3.41
Lock Manager Dyn Memory (Mb) 1.13 0.00 1.12
Buffer Object Usage (pages): In Use Peak
32-bit System Space Windows (S0/S1) 3 3
64-bit System Space Windows (S2) 0 0
Physical pages locked by buffer objects 3 3
Memory Reservations (pages): Group Reserved In Use Type
VCC$MIN_CACHE_SIZE --- 47360 47360 Allocated
Total (370.00 Mbytes reserved) 47360 47360
Swap File Usage (8KB pages): Index Free Size
DISK$X6XV_BRAHMA:[SYS0.SYSEXE]SWAPFILE.SYS
1 5168 5168
Paging File Usage (8KB pages): Index Free Size
DISK$X6XV_BRAHMA:[SYS0.SYSEXE]PAGEFILE.SYS
254 215288 215288
Total committed paging file usage: 7418
Of the physical pages in use, 4951 pages are permanently allocated to
OpenVMS.
This example shows reservable pages. If the reservable pages
are a negative value, this indicates that you may want
to consider adding to the fixed amount of pagefile space
available.
2.$ SHOW MEMORY/CACHE/FULL
System Memory Resources on 3-NOV-2001 18:36:12.79
Extended File Cache (Time of last reset: 31-OCT-2001 10:18:07.39)
Allocated (Mbytes) 1370.00 Maximum size (Mbytes) 91024.00
Free (Mbytes) 2319.75 Minimum size (Mbytes) 10 370.0
In use (Mbytes) 3 50.25 Percentage Read I/Os 11 98%
Read hit rate 4 79% Write hit rate 12 0%
Read I/O count 5 18110 Write I/O count 13 310
Read hit count 6 14343 Write hit count 14 0
Reads bypassing cache 7 37 Writes bypassing cache 15 0
Files cached open 8 351 Files cached closed 16 307
Vols in Full XFC mode 17 0 Vols in VIOC Compatible mode 17 0
Vols in No Caching mode17 0 Vols in Perm No Caching mode 17 0
I/O Statistics 18 - Distributions (MAX_IO_SIZE: 127 19)
-------------------------------------------------------
Transfer Size: Reads Read Hits Writes
1 Block IO: 35053 20 34553 21 87 22
2 Block IO: 469 284 9
3 Block IO: 26516 26346 24
4 Block IO: 348 205 6
5 Block IO: 13205 13160 0
6 Block IO: 161 111 0
7 Block IO: 185 152 0
.
.
.
114 Block IO: 1 0 0
116 Block IO: 2 1 0
121 Block IO: 1 0 0
>127<256 Block IO: 12 0
>255 Block IO: 14 0
----------------------------------------------------
Totals: 84411 80535 630
NOTE
This example shows the output for the SHOW MEMORY/CACHE/FULL
command on an Alpha system with the Extended File Cache
loaded. The SHOW MEMORY/CACHE/FULL command will display
different fields on a VAX system or on an Alpha system with
the Virtual I/O Cache loaded.
Extended File Cache Usage
Shows the use of the Extended File Cache facility on an Alpha
system.
1 Allocated Total amount of system memory in megabytes
allocated to the Extended File Cache.
2 Free Number of allocated megabytes not currently
in use by the cache.
3 In use Number of allocated megabytes that contain
valid cached data.
4 Read hit rate Shows cache read hits as a percentage of
read I/Os.
5 Read I/O count Total number of read I/Os that have been
seen by the cache since the last statistics
reset.
6 Read hit count Total number of read I/Os that did not
perform a physical I/O, because the data
for these was found in the cache since the
prior statistics reset.
7 Reads bypassing Total number of reads that bypassed the
cache cache and went directly to disk since the
last statistics reset.
8 Files cached Total number of open files in cache.
open
9 Maximum size Maximum size of the cache in megabytes.
(Mbytes)
10 Minimum size Minimum size of the cache in megabytes.
(Mbytes) This displays the value of the memory
reservation, VCC$MIN_CACHE_SIZE. Refer to
the OpenVMS System Manager's Manual for
additional information.
11 Percentage Percentage of read I/Os that occur. For
Read I/Os example, a read/write I/O ratio of 100%
implies that all were read I/Os.
12 Write hit rate (Always zero for Extended File Cache,
Version 1.)
13 Write I/O Total number of write I/Os that have been
count seen by the cache since the last statistics
reset.
14 Write hit (Always zero for Extended File Cache,
count Version 1.)
15 Writes Total number of writes that bypassed the
bypassing cache cache and went directly to disk since the
last statistics reset.
16 Files cached Total number of closed files in cache.
closed
17 Volume modes Total number of volumes in each caching
state. Note that the initial release of XFC
only supports VIOC compatible mode. Future
releases will support full mode.
18 I/O Statistics Systemwide distribution of I/O sizes
(rounded up).
19 MAX_IO_SIZE Current setting of the system parameter VCC_
MAX_IO_SIZE in blocks. The extended file
cache (XFC) will only cache files up to this
size.
20 Reads Number of reads for the entire system.
21 Read Hits Number of reads satisfied from the cache.
22 Writes Number of writes for the entire system.
3.$ SHOW MEMORY/CACHE=(VOLUME=*)
System Memory Resources on 20-JAN-2001 15:35:32.51
Extended File Cache Volume Statistics:
_$7$DKA200: (DISK$X6XV_BRAHMA), Caching mode is VIOC Compatible
Open files 1 372 Closed files 9 395
Files ever opened 2 1007 Files ever deposed 10 240
Allocated pages 3 6405 Locks acquired 11 736
Total QIOs 4 166552 Read hits 12 115984
Virtual reads 5 120068 Virtual writes 13 46484
Hit rate 6 69 % Read aheads 14 11766
Read throughs 7 120021 Write throughs 15 46484
Read arounds 8 47 Write arounds 16 0
Ave Disk I/O Resp Time incl cache hits (microseconds)17 3497
Total of 1 volumes in cache
Extended File Cache Usage
Shows the use of the Extended File Cache facility on an Alpha
system.
1 Open files Number of files that are currently open and
cached by the extended file cache on this volume
at the instant the SHOW command was issued.
2 Files ever Number of times the extended file cache has been
opened requested to open a file on this volume.
3 Allocated Number of main memory data pages currently
pages being used by the extended file cache to contain
actual file data, for this volume.
4 Total QIOs Total number of QIO and PAGE I/O calls received
by the extended file cache on this volume.
5 Virtual Cumulative number of Virtual Read requests
reads received by the extended file cache on this
volume.
6 Hit rate Percentage of Total QIOs that were completed
by copying data from cache, rather than issuing
real I/O to a volume.
7 Read Number of Virtual Reads that are capable of
throughs being satisfied by the extended file cache.
8 Read Number of Virtual Reads that cannot be satisfied
arounds by the extended file cache. Reasons for this
include the presence of a non-XFC compliant node
in an OpenVMS cluster, and the receipt of an I/O
that is larger than VCC_MAX_IO_SIZE.
9 Closed Number of closed files the extended file cache
files has in memory. If a subsequent file access
occurs, data will be accessible from main memory
rather than having to issue I/O to the real
volume.
10 Files Files removed from memory. Reasons the extended
ever deposed file cache may remove a file from its memory
include requests for memory from the rest of
the system, and conflicting access modes in a
cluster.
11 Locks Current number of file access locks that are in
acquired use on this volume.
12 Read hits Cumulative number of times a read has been
satisfied from the data cache.
13 Virtual Cumulative number of virtual write I/Os received
writes on this volume by the cache.
14 Read Cumulative number of times the extended file
aheads cache issued read ahead I/Os on this volume
after detecting sequential file I/O virtual
reads.
15 Write Cumulative number of times a virtual write has
throughs been capable of modifying cached data.
16 Write Cumulative number of times a virtual write has
arounds been detected that cannot update data in cache
memory.
17 Average Average disk I/O response time, including cache
Disk I/O hits, in microseconds. Note that on a symmetric
Response multiprocessing (SMP) system, the response time
Time only includes that of I/Os starting or finishing
on the same CPU. Any physical I/Os are ignored.
4.$ SHOW MEMORY/CACHE=(VOL=DKA100,TOPQIO=3)
System Memory Resources on 3-NOV-2001 18:36:12.79
Extended File Cache Top QIO File Statistics:
_$7$DKA200: (DISK$X6Y0_RESD), Caching mode is VIOC Compatible
_$7$DKA200:[SYS0.SYSEXE]SYSDUMP.DMP;2 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 1 334 Total QIOs 6 1712
Read hits 2 1559 Virtual reads 7 1712
Virtual writes 3 0 Hit rate 8 91 %
Read aheads 4 0 Read throughs 9 0
Write throughs 5 0 Read arounds 10 0
Write arounds 11 0
_$7$DKA200:[VMS$COMMON.SYSEXE]SYS$QUEUE_MANAGER.QMAN$JOURNAL;1 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 931 Total QIOs 1057
Read hits 5 Virtual reads 1044
Virtual writes 13 Hit rate 0 %
Read aheads 2 Read throughs 1044
Write throughs 13 Read arounds 0
Write arounds 0
_$7$DKA200:[VMS$COMMON.SYSLIB]DECC$SHR.EXE;1 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 135 Total QIOs 730
Read hits 673 Virtual reads 730
Virtual writes 0 Hit rate 0 %
Read aheads 2 Read throughs 0
Write throughs 0 Read arounds 0
Write arounds 0
Total of 3 files for this volume
Extended File Cache Top QIO File Statistics Usage
Shows the use of the Extended File Cache Top QIO File
Statistics facility on an Alpha system.
1 Allocated pages Number of main memory data pages currently
being used by the extended file cache to
contain actual file data, for this volume
2 Read hits Cumulative number of times a read has been
satisfied from the data cache.
3 Virtual writes Cumulative number of virtual write I/Os
received on this volume by the cache.
4 Read aheads Cumulative number of times the extended file
cache issued read ahead I/Os on this volume
after detecting sequential file I/O virtual
reads.
5 Write throughs Cumulative number of times a virtual write
has been capable of modifying cached data.
6 Total QIOs Total number of QIO and PAGE I/O calls
received by the extended file cache on this
volume.
7 Virtual reads Cumulative number of Virtual Read requests
received by the extended file cache on this
volume.
8 Hit rate Percentage of Total QIOs that were completed
by copying data from cache, rather than
issuing real I/O to a volume.
9 Read throughs Number of Virtual Reads that are capable of
being satisfied by the extended file cache.
10 Read arounds Number of Virtual Reads that cannot be
satisfied by the extended file cache.
Reasons for this include the presence of
a non-XFC compliant node in an OpenVMS
cluster, and the receipt of an I/O that
is larger than VCC_MAX_IO_SIZE.
11 Write arounds Cumulative number of times a virtual write
has been detected that cannot update data in
cache memory.
5.$ SHOW MEMORY/CACHE=(VOL=DKA100,TOPHITRATE=3)
System Memory Resources on 3-NOV-2001 18:36:12.79
Extended File Cache Top Hitrate File Statistics:
_$7$DKA200: (DISK$X6Y0_RESD), Caching mode is VIOC Compatible
_$7$DKA200:[VMS$COMMON.SYSLIB]SMGSHR.EXE;1 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 1 16 Total QIOs 6 277
Read hits 2 267 Virtual reads 7 277
Virtual writes 3 0 Hit rate 8 96 %
Read aheads 4 0 Read throughs 9 277
Write throughs 5 0 Read arounds 10 0
Write arounds 11 0
_$7$DKA200:[VMS$COMMON.SYSLIB]UTIL$SHARE.EXE;1 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 8 Total QIOs 185
Read hits 178 Virtual reads 185
Virtual writes 0 Hit rate 96 %
Read aheads 1 Read throughs 185
Write throughs 0 Read arounds 0
Write arounds 0
_$7$DKA200:[VMS$COMMON.SYSLIB]CMA$TIS_SHR.EXE;1 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 6 Total QIOs 165
Read hits 159 Virtual reads 165
Virtual writes 0 Hit rate 96 %
Read aheads 2 Read throughs 165
Write throughs 0 Read arounds 0
Write arounds 0
Total of 3 files for this volume
Extended File Cache Top Hitrate File Statistics Usage
Shows the use of the Extended File Cache Top Hitrate File
Statistics facility on an Alpha system.
1 Allocated pages .Number of main memory data pages currently
being used by the extended file cache to
contain actual file data, for this volume
2 Read hits Cumulative number of times a read has been
satisfied from the data cache.
3 Virtual writes Cumulative number of virtual write I/Os
received on this volume by the cache.
4 Read aheads Cumulative number of times the extended file
cache issued read ahead I/Os on this volume
after detecting sequential file I/O virtual
reads.
5 Write throughs Cumulative number of times a virtual write
has been capable of modifying cached data.
6 Total QIOs Total number of QIO and PAGE I/O calls
received by the extended file cache on this
volume.
7 Virtual reads Cumulative number of Virtual Read requests
received by the extended file cache on this
volume.
8 Hit rate Percentage of Total QIOs that were completed
by copying data from cache, rather than
issuing real I/O to a volume.
9 Read throughs Number of Virtual Reads that are capable of
being satisfied by the extended file cache.
10 Read arounds Number of Virtual Reads that cannot be
satisfied by the extended file cache.
Reasons for this include the presence of
a non-XFC compliant node in an OpenVMS
cluster, and the receipt of an I/O that
is larger than VCC_MAX_IO_SIZE.
11 Write arounds Cumulative number of times a virtual write
has been detected that cannot update data in
cache memory.
6.$ SHOW MEMORY/CACHE=(FILE=SYS$LOGIN:*.*,OPEN,CLOSED)
System Memory Resources on 3-NOV-2001 18:36:12.79
Extended File Cache Statistics:
_$7$DKA200:[SYS0.SYSMGR]ACCOUNTNG.DAT;1 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 1 1 Total QIOs 6 17
Read hits 2 0 Virtual reads 7 1
Virtual writes 3 16 Hit rate 8 0 %
Read aheads 4 0 Read throughs 9 0
Write throughs 5 16 Read arounds 10 0
Write arounds 11 0
_$7$DKA200:[SYS0.SYSMGR]ACME$SERVER.LOG;129 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 1 Total QIOs 2
Read hits 0 Virtual reads 1
Virtual writes 1 Hit rate 0 %
Read aheads 0 Read throughs 1
Write throughs 1 Read arounds 0
Write arounds 0
_$7$DKA200:[SYS0.SYSMGR]CLUE$STARTUP_BRAHMA.LOG;935 (closed)
Caching is enabled, active caching mode is Write Through
Allocated pages 2 Total QIOs 32
Read hits 0 Virtual reads 0
Virtual writes 32 Hit rate 0 %
Read aheads 0 Read throughs 0
Write throughs 32 Read arounds 0
Write arounds 0
.
.
.
_$7$DKA200:[VMS$COMMON.SYSMGR]VMS$AUDIT_SERVER.DAT;1 (open)
Caching is enabled, active caching mode is Write Through
Allocated pages 1 Total QIOs 8
Read hits 3 Virtual reads 8
Virtual writes 0 Hit rate 37 %
Read aheads 1 Read throughs 8
Write throughs 0 Read arounds 0
Write arounds 0
Total of 50 files for this volume
Extended File Cache Statistics Usage
Shows the use of the Extended File Cache Statistics facility on
an Alpha system.
1 Allocated pages .Number of main memory data pages currently
being used by the extended file cache to
contain actual file data, for this volume
2 Read hits Cumulative number of times a read has been
satisfied from the data cache.
3 Virtual writes Cumulative number of virtual write I/Os
received on this volume by the cache.
4 Read aheads Cumulative number of times the extended file
cache issued read ahead I/Os on this volume
after detecting sequential file I/O virtual
reads.
5 Write throughs Cumulative number of times a virtual write
has been capable of modifying cached data.
6 Total QIOs Total number of QIO and PAGE I/O calls
received by the extended file cache on this
volume.
7 Virtual reads Cumulative number of Virtual Read requests
received by the extended file cache on this
volume.
8 Hit rate Percentage of Total QIOs that were completed
by copying data from cache, rather than
issuing real I/O to a volume.
9 Read throughs Number of Virtual Reads that are capable of
being satisfied by the extended file cache.
10 Read arounds Number of Virtual Reads that cannot be
satisfied by the extended file cache.
Reasons for this include the presence of
a non-XFC compliant node in an OpenVMS
cluster, and the receipt of an I/O that
is larger than VCC_MAX_IO_SIZE.
11 Write arounds Cumulative number of times a virtual write
has been detected that cannot update data in
cache memory.
7.$ SHOW MEMORY/PHYSICAL_PAGES
System Memory Resources on 3-NOV-2001 16:11:30.76
Physical Memory Usage (pages): Total 1 Free 2 In Use 3 Modified 4
Main Memory (32.00Mb) 65536 44233 20955 308
Of the physical pages in use, 10970 pages are permanently allocated
to VMS.
Physical Memory Usage
Shows the use of physical memory.
1 Total Number of physical memory pages available for
general system use. Multiport memory pages
(existing on some VAX) used for shared memory
global sections, mailboxes, and common event
blocks are not included in this number.
2 Free Number of pages on the free page list.
3 In Use Number of pages currently being used. This number
is calculated by adding the number of pages on the
free, modified, and bad lists and then subtracting
that sum from the total number of available pages.
4 Modified Number of pages on the modified page list.
Bad Page List
Shows the contents of the bad page list.
NOTE
This display is written only when there are pages on the bad
page list.
Total Number of pages on the bad page list.
Dynamic Number of memory errors detected after the system
was booted.
I/O Errors Number of errors detected during page fault
handling.
Static Number of memory errors detected during boot-time
scan.
By default, either single-bit or double-bit errors cause the
pages to be removed during the boot-time scan.
Pages Allocated to OpenVMS
Any SHOW MEMORY display that includes the physical memory
display concludes with the number of pages permanently
allocated to the OpenVMS system. These pages include nonpaged
executive code and data, the PFN database, nonpaged dynamic
memory, the interrupt stack, and the system page table.
8. $ SHOW MEMORY/SLOTS
System Memory Resources on 3-NOV-2001 16:11:35.31
Slot Usage (slots): Total 1 Free 2 Resident 3 Swapped 4
Process Entry Slots 75 28 46 1
Balance Set Slots 70 26 44 0
Slot Usage (slots)
Displays the use of process entry slots and balance set slots.
1 Total Number of process entry slots (the value of the
system parameter MAXPROCESSCNT) and balance
set slots (the value of the system parameter
BALSETCNT) permanently allocated when the system
was bootstrapped.
2 Free Number of slots currently available.
3 Resident Number of slots currently used by memory-resident
processes. The number of balance set slots in use
can never be any larger than the number of process
entry slots in use because the SWAPPER and NULL
processes have process entry slots but do not
require balance set slots.
4 Swapped Number of slots used by outswapped processes.
For process entry slots, this number includes all
processes that have been partially outswapped. For
balance set slots, this number includes those
processes that have had their process bodies
outswapped but have process headers that are still
resident.
9. $ SHOW MEMORY/POOL
System Memory Resources on 5-DEC-2001 03:59:35.29
Dynamic Memory Usage (bytes): Total 1 Free 2 In Use 3 Largest 4
Nonpaged Dynamic Memory 24993792 23511872 1481920 23363776
Bus Addressable Memory 131072 114688 16384 114688
Paged Dynamic Memory 5799936 3530784 2269152 3530176
Lock Manager Dynamic Memory 1048576 254976 793600
Dynamic Memory Usage (in bytes)
Shows the use of the nonpaged and paged pool areas that
allocate variably sized blocks.
1 Total Total number of bytes set aside for each area.
2 Free Total amount of free space in each dynamic memory
area.
3 In Use Amount of space currently allocated from each
area. This number is the total size minus the
number of free bytes.
4 Largest Size of the largest contiguous block in each area.
For the paged pool, this number represents the
largest block that can be allocated. For the
nonpaged pool, an allocation request larger
than this number will cause the nonpaged pool
to grow (if other constraints allow growth). This
attribute does not apply to the lock manager, as
all items for the lock manager are the same size.
10. $ SHOW MEMORY/POOL/FULL
System Memory Resources on 5-DEC-2001 03:59:35.29
Nonpaged Dynamic Memory (Lists + Variable)
Current Size (bytes) 1 24993792 Current Size (pagelets) 1 48816
Initial Size (NPAGEDYN) 2 24993792 Initial Size (pagelets) 2 48816
Maximum Size (NPAGEVIR) 3499998720 Maximum Size (pagelets) 3 976560
Free Space (bytes) 4 22230144 Space in Use (bytes) 52763648
Largest Variable Block 6 19676672 Smallest Variable Block 7 2176
Number of Free Blocks 8 38334 Free Blocks LEQU 64 Bytes9 0
Free Blocks on Lookasides16 38330 Lookaside Space (bytes) 2537472
Bus Addressable Memory (Lists + Variable)
Current Size (bytes) 1 131072 Current Size (pagelets) 1 256
Initial Size (NPAGEDYN) 2 131072 Initial Size (pagelets) 2 256
Free Space (bytes) 4 114688 Space in Use (bytes) 5 16384
Largest Variable Block 6 114688 Smallest Variable Block 7 114688
Number of Free Blocks 8 1 Free Blocks LEQU 64 Bytes9 0
Free Blocks on Lookasides16 0 Lookaside Space (bytes) 0
Paged Dynamic Memory
Current Size (PAGEDYN) 1 5799936 Current Size (pagelets) 1 11328
Free Space (bytes) 4 3518288 Space in Use (bytes) 52281648
Largest Variable Block 6 3517584 Smallest Variable Block 7 16
Number of Free Blocks 8 25 Free Blocks LEQU 64 Bytes9 23
Lock Manager Dynamic Memory
Current Size (Mbytes) 1 13.85 Current Size (pages) 1 1774
Free Space (Mbytes) 4 10.06 Hits 12 54050
Space In Use 5 3.79 Misses 13 1664
Number of Empty Pages 10 26 Expansions 14 1792
Number of Free Packets 11 41244 Packet Size 15 256
Dynamic Memory
Shows the use of dynamic memory areas consisting of variably
sized blocks.
1 Current Size Current size (in 512-byte pagelets on
Alpha and in bytes and pages on VAX) of
each dynamic memory area. For the lock
manager display, the unit of measurement
is megabytes.
2 Initial Size Initial size of nonpaged dynamic memory and
the name of the system parameter (NPAGEDYN)
that controls this size.
3 Maximum Size Maximum size to which nonpaged dynamic
memory can grow and the name of the system
parameter (NPAGEVIR) that controls this
size.
4 Free Space Amount of free space in each dynamic memory
area.
5 Space in Use Amount of space currently allocated from
each area.
6 Largest Block Size of the largest contiguous area in each
pool area.
7 Smallest Block Size of the smallest hole (free block) in
each pool area.
8 Free Blocks Total number of free blocks in each pool
area. The size of this number is a measure
of pool fragmentation.
9 Blocks LEQU 64 Number of free blocks that are 64 bytes
long or shorter. 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.
10 Empty Pages Number of pages that do not have any packets
allocated.
11 Free Packets Total number of packets not in use. This
number is the sum of free packets from
partially used pages and the packets of
all Empty Pages.
12 Hits Total number of packet allocations.
13 Misses Total number of packet allocation requests
that could not be satisfied because the
number of packets requested were not
available. A miss causes dynamic memory
to expand by one page to satisfy the packet
allocation request.
14 Expansions Total number of times that dynamic memory
increased by a page to satisfy packet
allocation requests.
15 Packet Size Packet size of 256 bytes, which is used by
the lock manager to hold either a lock block
data structure or a resource block data
structure.
16 Lookasides Total number of memory packets that the
Free Blocks system has preallocated and placed on
"lookaside lists". If a packet of the
correct size is on a lookaside list, it can
be allocated very quickly and efficiently,
however, it can not then be used as part of
any other size packet. An excess of packets
on the lookaside list can be a cause for the
inability to allocate other sizes.
11. $ SHOW MEMORY/FILES
System Memory Resources on 22-MAY-2001 19:04:19.67
Swap File Usage (8KB pages): Index 1 Free Size
DISK$ALPHASYS:[SYS48.SYSEXE]SWAPFILE.SYS 1 904 904
DISK$SWAP:[SYS48.SYSEXE]SWAPFILE.SYS;1 2 1048 1048
Total size of all swap files: 1952
Paging File Usage (8KB pages): Index 2 Free Size
DISK$PAGE:[SYS48.SYSEXE]PAGEFILE.SYS;1 253 16888 16888
DISK$ALPHASYS:[SYS48.SYSEXE]PAGEFILE.SYS 254 16888 16888
Total size of all paging files: 33776
Total committed paging file usage: 3 1964
Paging File Usage (in blocks)
Shows the usage of paging and swapping files.
1 Swap File Usage Number of swap files. Begins with an index
value of 1 and increases in count.
2 Paging File Number of page files. Begins with an index
Usage value of 254 and decreases in count.
3 Total Paging Total committed page file usage. As in
File Usage previous releases, more pages can reside
in page-file sections systemwide than would
fit into installed page files.
| 17 - NETWORK |
Displays information about network services registered on a node.
Format
SHOW NETWORK [network-service]
17.1 - Parameter
network-service
Specifies a network service for which you want to display
information.
If you do not specify a service, the SHOW NETWORK command
displays information about all services that are currently
registered on the local node.
17.2 - Description
The SHOW NETWORK command displays information about network
services available on an OpenVMS system.
17.3 - Qualifiers
17. 3.1 - /FULL
Displays all the information for the specified network service.
17. 3.2 - /OLD
If you are running DECnet Phase IV, retains the behavior of
the SHOW NETWORK command prior to OpenVMS Version 7.0. If the
local node is a routing node, the /OLD qualifier provides routing
information.
17. 3.3 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default,
the output of the SHOW NETWORK command is sent to the current
SYS$OUTPUT device (usually your terminal).
The asterisk (*) and the percent sign (%) wildcard characters
are not allowed in the file specification.
If you enter the /NOOUTPUT qualifier, output is suppressed.
17.4 - Examples
1.$ SHOW NETWORK
Product: DECnet Node: GALENA Address(es): 19.64
Product: TCP/IP Node: GALENA.zka.cpq.com Address(es): 16.32.0.138
The SHOW NETWORK command in this example displays all the
network services currently registered on the local node, and
the name and address of that node.
2.$ SHOW NETWORK "TCP/IP"
Product: TCP/IP Node: GALENA.zka.cpq.com Address(es): 16.32.0.138
The SHOW NETWORK command in this example displays the TCP/IP
network service registered on the local node.
3.$ SHOW NETWORK/FULL
The following network service is available at this time:
Product: DECNET Manufacturer: Compaq Computer Corporation
Node: NEMYA Address(es): 4.26
Network Type: DNA V Interface(s): net 0
Node 0
at 2001-02-26-10:35:28.737-05:00I526.997
Identifiers
Name = DEC:.LKR.NEMYA
Address =
{
(
[ DNA_CMIP-MICE ] ,
[ DNA_SessionControlV3 , number = 19 ] ,
[ DNA_OSItransportV1 , 'DEC0'H ] ,
[ DNA_OSInetwork , 49::00-04:AA-00-04-00-1A-10:21 (DEC:.LKR.NEMYA) ]
,)
(
[ DNA_CMIP-MICE ] ,
[ DNA_SessionControlV2 , number = 19 ] ,
[ DNA_OSItransportV1 , 'DEC0'H ] ,
[ DNA_IP , 0.0.0.0 ]
,)
(
[ DNA_CMIP-MICE ] ,
[ DNA_SessionControlV3 , number = 19 ] ,
[ DNA_NSP ] ,
[ DNA_OSInetwork , 49::00-04:AA-00-04-00-1A-10:20 (DEC:.LKR.NEMYA) ]
)
}
Status
UID = 06E08000-DF79-11D4-8001-AA0004001A10
State = On
Functions Enabled =
{
Address Watcher ,
CMIP Listener
}
ID = 08-00-2B-E5-A8-AB
Characteristics
Version = T5.0.3
Implementation =
{
[
Name = OpenVMS AXP ,
Version = "X901-SSB"
] ,
[
Name = Compaq DECnet-Plus for OpenVMS ,
Version = "V7.3 30-DEC-2000 01:14:34.32"
]
}
Script Location = <Default value>
Maximum Listeners = 0
Listener Template = <Default value>
Secondary Names =
{
LOCAL:.NEMYA
}
Counters
Creation Time = 2001-02-05-11:53:38.135-05:00Iinf
Renames = 1
Changes of ID = 9
IDROM Check Failures = 0
Changes of Address = 0
Node 0 Session Control Port SCL$PORT$12010029
at 2001-02-26-10:35:30.230-05:00I526.997
Identifiers
Name = SCL$PORT$12010029
Status
Client = Session Control Application 42
Local End User Address = UIC = [0,0]SYSTEM
Transport Port = OSI Transport Port OSI$PORT_0_002A
Direction = Outgoing
Remote End User Address = number = 42
Node Name Sent = DEC:.LKR.NEMYA
Version Sent = V3
Outgoing Network Priority = 0
Incoming Network Priority = 0
Process Identifier = "00000127"
Counters
Creation Time = 2001-02-26-10:33:14.104-05:00I526.966
Node 0 Session Control Port SCL$PORT$1201002A
at 2001-02-26-10:35:30.230-05:00I526.997
Identifiers
Name = SCL$PORT$1201002A
Status
Client = Session Control Application 42
Local End User Address = number = 42
Transport Port = OSI Transport Port OSI$PORT_0_002B
Direction = Incoming
Remote End User Address = UIC = [0,0]SYSTEM
Node Name Sent = DEC:.LKR.NEMYA
Version Sent = V3
Outgoing Network Priority = 0
Incoming Network Priority = 0
Process Identifier = "00000115"
Counters
Creation Time = 2001-02-26-10:33:14.112-05:00I526.966
Node 0 Session Control Port SCL$PORT$1201002D
at 2001-02-26-10:35:30.230-05:00I526.997
Identifiers
Name = SCL$PORT$1201002D
Status
Client = Session Control Application 42
Local End User Address = UIC = [0,0]SYSTEM
Transport Port = OSI Transport Port OSI$PORT_0_002E
Direction = Outgoing
Remote End User Address = number = 42
Node Name Sent = DEC:.LKR.NEMYA
Version Sent = V3
Outgoing Network Priority = 0
Incoming Network Priority = 0
Process Identifier = "0000012C"
Counters
Creation Time = 2001-02-26-10:35:19.522-05:00I526.996
Node 0 Session Control Port SCL$PORT$1201002E
at 2001-02-26-10:35:30.231-05:00I526.997
Identifiers
Name = SCL$PORT$1201002E
Status
Client = Session Control Application 42
Local End User Address = number = 42
Transport Port = OSI Transport Port OSI$PORT_0_002F
Direction = Incoming
Remote End User Address = UIC = [0,0]SYSTEM
Node Name Sent = DEC:.LKR.NEMYA
Version Sent = V3
Outgoing Network Priority = 0
Incoming Network Priority = 0
Process Identifier = "00000115"
Counters
Creation Time = 2001-02-26-10:35:19.529-05:00I526.996
Node 0 Session Control
at 2001-02-26-10:35:32.081-05:00I526.997
Counters
Creation Time = 2001-02-06-23:56:24.297-05:00Iinf
Access Control Violations = 0
Backtranslation Deletions = 0
Deleted Maintained Objects = 0
Dangling Links = 0
Verification Failures = 0
$
The SHOW NETWORK/FULL command in this example displays all the
information available about all the network services registered
on the local node.
| 18 - PRINTER |
Displays the current settings for a printer.
Format
SHOW PRINTER device-name[:]
18.1 - Parameter
device-name[:]
Specifies the name of the printer for which settings are to be
displayed.
18.2 - Qualifier
18. 2.1 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default,
the output of the SHOW PRINTER 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.
18. 2.2 - /IDSTRING
Returns the USB printer ID string as a text string and displays
it on your screen. This information appears at the end of the
typical SHOW PRINTER command display.
18. 2.3 - /SERIALNUM
Returns the USB printer serial number as a text string and
displays to the screen. The USB printer returns the serial number
in Unicode format, and this is converted to ASCII text before
being displayed.
18.3 - Examples
1.$ SHOW PRINTER LPA0:
Printer LPA0:, device type LP11, is online, allocated, spooled
Error count 0 Operations completed 880
Owner process "SYMBIONT_0001" Owner UIC [0,0]
Owner process ID 21C0008D Dev Prot S:RWLP,O:RWLP,G:RWLP,W:RWLP
Reference count 2 Default buffer size 132
Page width 132 Page Length 66
No Carriage_return Formfeed Lowercase
No Passall No Wrap Printall
No Fallback No Tab Truncate
No Sixels No Bitmapped No Polled
Unidirectional
Intermediate device: STAR$DUA1:
Associated queue: LN01$PRINT
The SHOW PRINTER command in this example displays the settings
for the printer LPA0.
2.$ SHOW PRINTER LPA0/IDSTRING
Printer LPA0:, device type PC printer, is online, record-oriented device,
carriage control.
Error count 0 Operations completed 0
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W
Reference count 0 Default buffer size 132
Page width 132 Page Length 66
No Carriage_return Formfeed Uppercase
No Passall No Wrap No Printall
No Fallback No Tab Truncate
No Sixels No Bitmapped Polled
Unidirectional
IDString:
MFG: HEWLETT-PACKARD;
MDL: DESKJET 895C;
CMD: MLC,PCL,PML;
CLASS: PRINTER;
DESCRIPTION: Hewlett-Packard DeskJet 895C;
SERN: MX88P2V0VWGO;
VSTATUS: $HB0$FC0,ff,DN,IDLE,CUT;
The SHOW PRINTER/IDSTRING command in this example displays the
ID string for the printer LPA0.
3.$ SHOW PRINT LPA0/IDSTRING
Printer LRA0:, device type LP11, is online, record-oriented device,
carriage control.
Error count 0 Operations completed 0
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W
Reference count 0 Default buffer size 132
Page width 132 Page Length 66
No Carriage_return Formfeed Uppercase
No Passall No Wrap No Printall
No Fallback No Tab Truncate
No Sixels No Bitmapped No Polled
Unidirectional
%SYSTEM-F-DEVOFFLINE, device is not in configuration or not available
If the device has been disconnected and marked offline, the
SHOW PRINTER/IDSTRING command displays this information.
If the attempt to read the ID string should fail (for an
unknown reason other than device disconnection), the reference
to the ID string appears as:
%SHOW-W-NOIDSTRING, ID String could not be retrieved
4.$ SHOW PRINT LPA0/SERIALNUM
Printer LPA0:, device type PC printer, is online, record-oriented device,
carriage control.
Error count 0 Operations completed 0
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W
Reference count 0 Default buffer size 132
Page width 132 Page Length 66
No Carriage_return Formfeed Uppercase
No Passall No Wrap No Printall
No Fallback No Tab Truncate
No Sixels No Bitmapped Polled
Unidirectional
Serial Number: MX88P2V0VWGO
The SHOW PRINTER/SERIALNUM command in this example displays the
serial number for the printer LPA0.
If the device has been disconnected and marked offline, the
SHOW PRINTER/SERIALNUM command replaces the reference to the
serial number with the following message:
%SYSTEM-F-DEVOFFLINE, device is not in configuration or not available
If the ID string is not supported by the USB printer in
question, the reference to the ID string will appear as:
%SHOW-W-NOSERIALNUM, Serial number could not be retrieved
| 19 - 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. You must use the /IDENTIFICATION qualifier to look at
processes outside of your group.
Format
SHOW PROCESS [[node-name::]process-name]
19.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.
19.2 - Qualifiers
19. 2.1 - /ACCOUNTING
Shows the resources used by the process.
19. 2.2 - /ALL
Displays the basic subset of information as well as information
about:
Accounting
Dynamic memory use
Privileges
Quotas
Shelving
Subprocesses
19. 2.3 - /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.
19. 2.4 - /DUMP
Displays the image dump setting which is set or cleared by the
SET PROCESS/DUMP command.
19. 2.5 - /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.
19. 2.6 - /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.
19. 2.7 - /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.
19. 2.8 - /INTERVAL
/INTERVAL=n
Use with the /CONTINUOUS qualifier to update the information at
the specified number of seconds.
19. 2.9 - /MEMORY
Displays the process's use of dynamic memory areas. The /MEMORY
qualifier is allowed only for the current process.
19. 2.10 - /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.
19. 2.11 - /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.
19. 2.12 - /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
19. 2.13 - /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.
19. 2.14 - /RAD
Displays home resource affinity domain (RAD).
Note that OpenVMS application support for resource affinity
domains (RADs) is supported only on AlphaServer GS160 systems.
19. 2.15 - /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.
19. 2.16 - /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.
19. 2.17 - /SHELVING
Displays whether the process automatically unshelves files.
19. 2.18 - /SUBPROCESSES
Displays the current subprocesses in hierarchical order.
19. 2.19 - /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.
19.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 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 Displays the number of free blocks that are
(VAX) Blocks LEQU 32 bytes or shorter on VAX or 64 bytes or
64 (Alpha) 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.
| 20 - 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
20.1 - 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.
| 21 - QUEUE |
Displays information about queues and the jobs that are currently
in queues.
Requires read (R) access to the job.
o Displays characteristic names and numbers that are available
on queues (see /CHARACTERISTICS).
o Displays form names and numbers that are available on queues
(see /FORM).
o Provides information about the queue manager(s) on the system
or OpenVMS Cluster (see /MANAGERS).
Format
SHOW QUEUE [queue-name]
21.1 - 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.
21.2 - Qualifiers
21. 2.1 - /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.
21. 2.2 - /BATCH
Displays only batch queues and jobs in those queues.
21. 2.3 - /BRIEF
/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.
21. 2.4 - /BY_JOB_STATUS
/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 STALLED
EXECUTING STARTING
PRINTING SUSPENDED
PROCESSING
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_ Requests the display of jobs on hold until a
RELEASE 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.
21. 2.5 - /DEVICE
/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.
21. 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.
21. 2.7 - /FILES
Adds to the display the list of files associated with each job.
The /FILES qualifier overrides the /BRIEF qualifier.
21. 2.8 - /FULL
Displays complete information about queues, jobs contained
in queues, and the files associated with the jobs. The /FULL
qualifier overrides the /BRIEF qualifier.
21. 2.9 - /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.
21. 2.10 - /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.
21. 2.11 - /OUTPUT
/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.
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.
21. 2.12 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of 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.
21. 2.13 - /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.
21. 2.14 - /SUMMARY
Displays the total number of executing jobs, pending jobs,
holding jobs, retained jobs, and timed release jobs for each
queue. For output queues, the total block count for pending jobs
is also shown.
21. 2.15 - /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.
21.3 - Examples
1.$ SHOW QUEUE/ALL/BY_JOB_STATUS=pending
Printer queue KLEE$LCA0, stopped, mounted form DEFAULT
/BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=ELITE (stock=DEFAULT))
/OWNER=[SYSTEM] /PROTECTION=(S:M,O:D,G:R,W:S)
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
2045 APPLICA MARTIN 102 Pending
Batch queue SYS_TEX, available, on NODE22::
/BASE_PRIORITY=3 /JOB_LIMIT=25 /OWNER=[SYSTEM]
/PROTECTION=(S:M,O:D,G:R,W:S)
Entry Jobname Username Status
----- ------- -------- ------
1388 CHAPTER1.JOB MARTIN Pending
Generic batch queue CLUSTER_BATCH
/GENERIC=(HMSCMS_BATCH,NODE22_BATCH) /OWNER=[SYSTEM]
/PROTECTION=(S:M,O:D,G:R,W:S)
Entry Jobname Username Status
----- ------- -------- ------
936 no privilege Pending
.
.
.
The SHOW QUEUE command in this example displays only the
queues in which jobs are currently pending. The /ALL qualifier
requests the display of all pending jobs. Notice that you
cannot see job information for entry 936. You must have GROUP
privilege to show all jobs in your group or OPER privilege to
show all jobs in all groups.
2.$ SHOW QUEUE/FULL ARMADA*
Batch queue ARMADA_BATCH, idle, on ARMADA::
/AUTO_START_ON=(ARMADA::) /BASE_PRIORITY=3 /JOB_LIMIT=3
/OWNER=[SYSTEM] /PROTECTION=(S:M,O:D,G:R,W:S)
Printer queue ARMADA$PRINT, stopped, on ARMADA::LPA0,
mounted form DEFAULT
/BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=ELITE (stock=DEFAULT))
/OWNER=[SYSTEM] /PROTECTION=(S:E,O:D,G:R,W:W)
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
605 SET DUDSON 140 Pending (queue stopped)
Submitted 21-DEC-2001 16:14 /FORM=ELITE (stock=DEFAULT)
/PRIORITY=200
File: _$5$DUA1:[DUDSON]SET.CLD;5
606 CLOSE DUDSON 140 Pending (queue stopped)
Submitted 21-DEC-2001 16:16 /FORM=DEFAULT /PRIORITY=200
File: _$5$DUA1:[DUDSON]CLOSE.TXT;2
Printer queue ARMADA$PRINTER_1, idle, on ARMADA::TTA3,
mounted form DEFAULT
<Printer queue on node ARMADA for a LN03R printer>
/BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=DEFAULT) /LIBRARY=SMU$DEVCTL
Lowercase /OWNER=[SYSTEM] /PROCESSOR=CPS$SMB
/PROTECTION=(S:M,O:D,G:R,W:S) /SEPARATE=(FLAG)
The SHOW QUEUE command in this example lists information on
all of your current job entries. Complete information about
the queues, the jobs contained in those queues, and the files
associated with the jobs is displayed.
3.$ SHOW QUEUE/SUMMARY
Batch queue HMSCMS_BATCH, available, on HMSCMS::
Job summary: 1 executing, 5 holding
Server queue NM$QUE01, available, on NODE22::, mounted form DEFAULT
Job summary: 2 executing
Generic server queue NM$QUEUE
Job summary: 1 timed release
Batch queue PIZZA_BATCH, idle, on PIZZA::
Job summary: queue is empty
Batch queue NODE22_BATCH, available, on NODE22::
Job summary: 1 executing, 1 timed release
Printer queue ARMADA$PRINT, stopped, on ARMADA::LPA0, mounted
form DEFAULT
Job summary: 8 pending (565 blocks)
Terminal queue ALLBQ, stopped, on KATYA::TTA2, mounted form DEFAULT
Job summary: 2 pending (445 blocks)
.
.
.
The SHOW QUEUE command in this example lists all queues and
displays the total number of jobs on the queues.
4.$ SHOW QUEUE DOC$LN03
Server queue DOC$LN03, stopped, on NEWTON::, mounted form DEFAULT
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
436 DOCPLAN HERSHEY 8 Retained until 11-JAN-2001 16:56
%JBC-F-JOBABORT, job aborted during execution
Completed 11-JAN-2001 15:56 on queue DOC$LN03
This SHOW QUEUE display includes the date and time at which a
retained job completed and the queue on which it executed. You
can specify the /RETAIN qualifier with the PRINT, SUBMIT, or
SET ENTRY command to specify the circumstances under which you
want your job to be retained in a queue. In this example, the
user set job retention to be one hour after job completion.
Depending on the queue's job retention policy, the job might be
deleted from the queue at 16:56. (See the PRINT, SUBMIT, or SET
ENTRY command descriptions for more information on the /RETAIN
qualifier.)
21.4 - /CHARACTERISTICS
Displays information about queue characteristics defined for the
system. A characteristic is a user-defined attribute of a batch
or output queue, such as ink color.
Format
SHOW QUEUE/CHARACTERISTICS
[characteristic-name]
21. 4.1 - Parameter
characteristic-name
Specifies the name of a characteristic. The asterisk (*) and the
percent sign (%) wildcard characters are allowed. The default
value for the characteristic-name parameter is the asterisk
wildcard (*). Thus, information about all characteristics is
displayed when you do not specify a characteristic name.
You create a characteristic name with the DEFINE/CHARACTERISTIC
command. You can then assign it to a queue by using the
INITIALIZE/QUEUE, the SET QUEUE, or the START/QUEUE command
with the /CHARACTERISTICS qualifier. You can also specify
characteristics for a job by using the /CHARACTERISTICS qualifier
with the PRINT, the SUBMIT, or the SET ENTRY command.
21. 4.2 - Qualifier
21. 4. 2.1 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default the
output of the SHOW QUEUE/CHARACTERISTICS 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 any 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.
21. 4.3 - Examples
1.$ SHOW QUEUE/CHARACTERISTICS
Characteristic name Number
------------------- ------
BLUEINK 6
BROWNINK 25
COLOR_CHART 1
REDINK 0
TEXMAC_JOB 2
The SHOW QUEUE/CHARACTERISTICS command in this example displays
all the characteristics that have been defined for this system.
2.$ SHOW QUEUE/CHARACTERISTICS *INK
Characteristic name Number
------------------- ------
BLUEINK 6
BROWNINK 25
REDINK 0
The SHOW QUEUE/CHARACTERISTICS command in this example displays
the name and number of all characteristics that end with INK.
21.5 - /FORM
Displays information about forms defined for the system. Forms
define the size and type paper and the layout of text that are
used for print jobs.
Format
SHOW QUEUE/FORM [form-name]
21. 5.1 - Parameter
form-name
Specifies the name of the form. The asterisk (*) and the percent
sign (%) wildcard characters are allowed. The default value for
the form-name parameter is an asterisk (*), which means that the
names of all forms on the system are displayed.
21. 5.2 - Qualifiers
21. 5. 2.1 - /BRIEF
/BRIEF (default)
Displays a brief description (form names, numbers, and
descriptions) about the forms on the system.
21. 5. 2.2 - /FULL
Displays a full description (including paper size and margin
settings) about the forms on the system.
21. 5. 2.3 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default
the output of the SHOW QUEUE/FORM 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 cannot 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.
21. 5.3 - Examples
1.$ SHOW QUEUE/FORM DEFAULT
Form name Number Description
--------- ------ -----------
DEFAULT 0 System-defined default
The SHOW QUEUE/FORM command in this example displays only the
default form.
2.$ SHOW QUEUE/FORM LN01*
Form name Number Description
--------- ------ -----------
LN01_LANDSCAPE (stock=DEFAULT) 105 132 by 66 (landscape)
LN01_LANDSCAPE_INDENTED (stock=DEFAULT)
107 132 by 65 (landscape)
LN01_PORTRAIT (stock=DEFAULT) 106 80 by 60 (portrait)
The SHOW QUEUE/FORM command in this example displays the names
of all forms, including the stock, that begin with LN01. The
display includes the names, stock for each form, numbers, and
brief descriptions of those forms.
3.$ SHOW QUEUE/FORM/FULL
Form name Number Description
--------- ------ -----------
132_51_STD (stock=DEFAULT) 102 132 by 51 (standard short)
/LENGTH=51 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /TRUNCATE
/WIDTH=132
40_66_STD (stock=DEFAULT) 103 40 by 66 (standard labels)
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /WIDTH=40
BLUE_PAPER_STOCK (stock=DIGITAL_8X11_STOCK1412TEA)
22222 blue paper, DEC order# 22222
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DIGITAL_8X11_STOCK1412TEA
/TRUNCATE /WIDTH=80
DEFAULT 0 System-defined default
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /TRUNCATE
/WIDTH=132
LN01_LANDSCAPE (stock=DEFAULT) 105 132 by 66 (landscape)
/LENGTH=66 /STOCK=DEFAULT /WIDTH=132
LN01_LANDSCAPE_INDENTED (stock=DEFAULT)
107 132 by 65 (landscape)
/LENGTH=65 /SETUP=(LN01_TOP_MARGIN_150) /STOCK=DEFAULT
/WIDTH=132
LN01_PORTRAIT (stock=DEFAULT) 106 80 by 60 (portrait)
/LENGTH=60 /SETUP=(LN01_PORTRAIT) /STOCK=DEFAULT /WIDTH=80
MEMO (stock=DEFAULT) 110 LN03 indented memo format
/LENGTH=64 /MARGIN=(TOP=2,LEFT=5) /STOCK=DEFAULT /TRUNCATE
/WIDTH=80
This SHOW QUEUE/FORM command also displays the names of all
form types and stock for the system. By using the /FULL
qualifier, you can see what image size has been set for each
form type.
21.6 - /MANAGERS
Provides information about the queue manager(s) on the system or
OpenVMS Cluster.
Format
SHOW QUEUE/MANAGERS [queue-manager-name]
21. 6.1 - Parameter
queue-manager-name
Specifies the name of the queue manager for which you want
information displayed. The asterisk (*) and the percent sign (%)
wildcard characters are allowed. The default value for the queue-
manager-name parameter is the asterisk (*) wildcard character.
If no queue manager name is specified, information on all queue
managers is displayed.
21. 6.2 - Qualifiers
21. 6. 2.1 - /BRIEF
Displays a one-line description of queue manager(s) on the system
or cluster. The information displayed includes the name and
status of the queue manager and the node on which its process
is running. The /BRIEF qualifier is present by default.
21. 6. 2.2 - /FULL
Displays complete information about queue manager(s) on the
system or cluster. The /FULL qualifier overrides the /BRIEF
qualifier.
21. 6.3 - Examples
1.$ SHOW QUEUE/MANAGERS/FULL
Master file: SYS$COMMON:[SYSEXE]QMAN$MASTER.DAT;
Queue manager BATCHQ_MANAGER, running, on BBBBBB::
/ON=(BBBBBB, AAAAAA, CCCCCC, EEEEEE, *)
Database location: DISK1:[QUEUES]
Queue manager PRINTQ_MANAGER, starting, on AAAAAA::
/ON=(AAAAAA, BBBBBB, CCCCCC, EEEEEE, *)
Database location: DISK2:[QUEUES]
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF::
/ON=(FFFFFF, EEEEEE, CCCCCC, BBBBBB, AAAAAA, *)
Database location: DISK1:[QUEUES]
Queue manager TRANSFER_MANAGER, stopped
/ON=(AAAAAA, BBBBBB, EEEEEE)
Database location: DISK1:[TRANSFER]
The SHOW QUEUE/MANAGERS/FULL command displays complete
information about a queue manager on a system or cluster.
2.$ SHOW QUEUE/MANAGERS
Queue manager BATCHQ_MANAGER, running, on BBBBBB::
Queue manager PRINTQ_MANAGER, starting, on AAAAAA::
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF::
Queue manager TRANSFER_MANAGER, stopped
The SHOW QUEUE/MANAGERS command in this example shows
information about the queue manager in brief format. The /BRIEF
qualifier is the default and does not need to be specified.
3.$ SHOW QUEUE/MANAGERS/FULL SYS$QUEUE_MANAGER
Master file: SYS$COMMON:[SYSEXE]QMAN$MASTER.DAT;
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF::
/ON=(FFFFFF, EEEEEE, CCCCCC, BBBBBB, AAAAAA, *)
Database location: DISK1:[QUEUES]
The command, SHOW QUEUE/MANAGERS/FULL SYS$QUEUE_MANAGER, in
this example shows a request for a specific queue manager by
name.
| 22 - QUOTA |
Displays the current disk quota that is authorized for a specific
user on a specific disk. This display includes a calculation of
the amount of space available and the amount of overdraft that is
permitted.
Requires read (R) access to the quota file in order to display
the quotas of other users.
Format
SHOW QUOTA
22.1 - Qualifiers
22. 1.1 - /DISK
/DISK[=device-name[:]]
Specifies the disk whose quotas are to be examined. By default,
the current default disk (defined by the logical name SYS$DISK)
is examined.
22. 1.2 - /USER
/USER=uic or identifier
Specifies which user's quotas are to be displayed. By default,
the current user's quotas are displayed.
22.2 - Examples
1.$ SHOW QUOTA
User [360,010] has 2780 blocks used, 7220 available,
of 10000 authorized and permitted overdraft of 500 blocks on DISK$
The SHOW QUOTA command in this example displays the amount of
disk space authorized, used, and still available on the current
default disk for the present user. The permitted overdraft in
this example is 500 blocks.
2.$ SHOW QUOTA /USER=[360,007]/DISK=XXX1:
%SYSTEM-F-NODISKQUOTA, no disk quota entry for this UIC
The SHOW QUOTA command in this example displays the fact that
the user with user identification code (UIC) [360,007] has no
disk quota allocation on device XXX1.
3.$ SHOW QUOTA /USER=[360,111]
User [360,111] has 27305 blocks used, 2305 OVERDRAWN,
of 25000 authorized and permitted overdraft of 4000 blocks on DISK$
The SHOW QUOTA command in this example illustrates a user with
an overdrawn quota.
| 23 - RMS_DEFAULT |
Displays the current default values for the multiblock count, the
multibuffer count, the network transfer size, the prolog level,
the extend quantity, and the query lock option.
Format
SHOW RMS_DEFAULT
23.1 - Qualifier
23. 1.1 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Specifies the file to which the display is written (default is
SYS$OUTPUT). The asterisk (*) and the percent sign (%) wildcard
characters are not allowed in the file specification. If you
enter the /OUTPUT qualifier with a partial file specification
(for example, specifying only a directory), SHOW is the default
output file name and .LIS the default output file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
23.2 - Example
$ SHOW RMS_DEFAULT
MULTI- | MULTIBUFFER COUNTS | NETWORK
BLOCK | Indexed Relative Sequential | BLOCK
COUNT | Disk Magtape Unit Record | COUNT
Process 0 | 0 0 0 0 0 | 0
System 16 | 0 0 0 0 0 | 8
Prolog Extend Quantity VCC_DFW QUERY_LOCK
Process 0 0 0 System
System 0 0 0 Enabled
CONTENTION_POLICY
Process System
System Never
The SHOW RMS_DEFAULT command in this example shows a system
multiblock count of 16 and a network block count of 8. These
are typical values. Note that the placeholder, VCC_DFW, is
currently reserved to Compaq.
| 24 - SECURITY |
Displays the name, class, and profile of a protected object.
Format
SHOW SECURITY object-name
24.1 - Parameter
object-name
Specifies the name of an object whose security profile is to
be displayed. If the object class is SECURITY_CLASS, you can
specify an asterisk (*) as object-name to see a display of
all security class objects. An object name of the FILE class
(explicitly or implicitly specified) can include the asterisk
(*) and the percent sign (%) wildcard characters; however,
wildcard characters are not allowed in any class other than FILE
or SECURITY_CLASS.
24.2 - Qualifiers
24. 2.1 - /BACKUP
Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /BACKUP qualifier selects files according to the
dates of their most recent backups (rather than by the creation,
expiration, or modification date). By default, SHOW SECURITY
selects files according to their creation date.
24. 2.2 - /BEFORE
/BEFORE[=time]
Selects only those files dated prior to the specified time.
You can specify time as absolute time, as a combination of
absolute and delta times, or as one of the following keywords:
BOOT, LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify
the /CREATED or the /MODIFIED qualifier to indicate the time
attribute to be used as the basis for selection. The /CREATED
qualifier is the default.
For complete information on specifying time values, refer to the
OpenVMS User's Manual or the online help topic DCL_Tips (subtopic
Date_Time).
24. 2.3 - /BY_OWNER
/BY_OWNER[=uic]
Selects files whose owner's UIC matches the UIC specified with
uic. The default UIC is that of the current process.
Specify the UIC by using the standard format described in the
OpenVMS Guide to System Security.
24. 2.4 - /CLASS
/CLASS=class
Specifies the class of the object whose profile is to be
displayed. By default, the command assumes the object class is
FILE. Object class keywords are as follows:
CAPABILITY LOGICAL_NAME_TABLE
COMMON_EVENT_CLUSTER QUEUE
DEVICE RESOURCE_DOMAIN
FILE SECURITY_CLASS
GROUP_GLOBAL_SECTION SYSTEM_GLOBAL_SECTION
ICC_ASSOCIATION VOLUME
24. 2.5 - /CREATED
Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /CREATED qualifier selects files according to the
date they were created (rather than by the backup, expiration,
or modification date). By default, SHOW SECURITY selects files
according to their creation date.
24. 2.6 - /EXCLUDE
/EXCLUDE=(filespec[,...])
Excludes the specified files from the SHOW SECURITY operation.
You can include a directory, but not a device, in the file
specification. You cannot use relative version numbers to exclude
a specific version.
24. 2.7 - /EXPIRED
Modifies the time specified with the /BEFORE or the /SINCE
qualifier. The /EXPIRED qualifier selects files according to
their expiration dates rather than by the backup, creation,
or modification date. (The expiration date is set with the SET
FILE/EXPIRATION_DATE command.) By default, files are selected
according to their creation date.
24. 2.8 - /MODIFIED
Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /MODIFIED qualifier selects files according to
the dates on which they were last modified, rather than by the
backup, creation, or expiration date. By default, files are
selected according to their creation date.
24. 2.9 - /SINCE
/SINCE[=time]
Selects only those files dated on or after the specified time.
You can specify time as absolute time, as a combination of
absolute and delta times, or as one of the following keywords:
BOOT, LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify
the /CREATED or the /MODIFIED qualifier to indicate the time
attribute to be used as the basis for selection. The /CREATED
qualifier is the default.
For complete information on specifying time values, see the
OpenVMS User's Manual or the online help topic DCL_Tips (subtopic
Date_Time).
24.3 - 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 RES17SEP that is mounted on it.
The subsequent SHOW DEVICE command confirms that 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.
| 25 - SERVER |
Displays information about the Registry servers.
Requires the SYSPRV privilege.
Format
SHOW SERVER server-name
25.1 - Parameter
server-name
Valid value is: REGISTRY_SERVER.
25.2 - Qualifiers
25. 2.1 - /CLUSTER
Displays information about each registry server in the cluster.
Cannot be used with the /MASTER or /NODE qualifiers.
25. 2.2 - /MASTER
Displays information from the registry master server only.
Requires the SYSLCK privilege.
Cannot be used with the /CLUSTER or /NODE qualifiers.
25. 2.3 - /NODE
/NODE=(node-name[,...])
Displays information on the registry servers on the specified
nodes in the order they are entered. The node names must be
within the current cluster.
Cannot be used with the /CLUSTER or /MASTER qualifiers.
25. 2.4 - /OUTPUT
/OUTPUT=filespec
Sends the output information to a specified file.
25.3 - Examples
1.$ SHOW SERVER REGISTRY_SERVER
This command displays information about the node you are on:
Registry Information on node OPNEAR 29-AUG-2001 16:37:26.52 Uptime 20 04:10:55
2.$ SHOW SERVER REGISTRY_SERVER/MASTER
This command displays information about the registry master
server:
Registry Master Server is running on OPNEAR, Pid: 20A0021A
| 26 - STATUS |
Displays the current status of your process.
Format
SHOW STATUS
26.1 - Example
$ SHOW STATUS
Status on 14-DEC-2001 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.
| 27 - SYMBOL |
Displays the value of the specified symbol.
Format
SHOW SYMBOL [symbol-name]
27.1 - 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.
27.2 - Qualifiers
27. 2.1 - /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.
27. 2.2 - /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.
27. 2.3 - /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.
27. 2.4 - /LOG
/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.
27.3 - 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.
| 28 - SYSTEM |
Displays status information about current processes.
Format
SHOW SYSTEM
28.1 - Qualifiers
28. 1.1 - /BATCH
/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.
28. 1.2 - /CLUSTER
Displays the specified processes on all nodes in an OpenVMS
Cluster.
28. 1.3 - /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.
28. 1.4 - /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.
28. 1.5 - /HEADING
/HEADING
/NOHEADING
Displays a heading line above the system output. When you use
the /NOHEADING qualifier, the heading line is excluded from the
display.
28. 1.6 - /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.
28. 1.7 - /IDENT
/IDENT=pid
Displays all processes on the system that have the specified
process identification (PID) code number.
28. 1.8 - /INTERACTIVE
/INTERACTIVE
/NOINTERACTIVE
Displays all interactive processes on the system. When you use
the /NOINTERACTIVE qualifier, all interactive processes are
excluded from the display.
28. 1.9 - /MULTITHREAD
Displays all multithreaded processes for the local system.
When used with the /FULL qualifier, the /MULTITHREAD qualifier
displays information about each kernel thread in a multithreaded
process.
For more information on kernel threads, refer to the OpenVMS
Programming Concepts Manual.
28. 1.10 - /NETWORK
/NETWORK
/NONETWORK
Displays all network processes on the system. When you use the
/NONETWORK qualifier, all network processes are excluded from the
display.
28. 1.11 - /NODE
/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.
28. 1.12 - /OUTPUT
/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.
28. 1.13 - /OWNER_UIC
/OWNER_UIC=uic
Displays all processes on the system that have the specified user
identification code (UIC) number.
28. 1.14 - /PAGE
/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 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.
28. 1.15 - /PROCESS
/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.
28. 1.16 - /SCHEDULING_CLASS
/SCHEDULING_CLASS[=class_name]
/NOSCHEDULING_CLASS
Displays processes that belong to a specific scheduling class
(class_name). If the class name is not specified, all class
scheduled processes are displayed along with the name of their
scheduling class.
28. 1.17 - /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.
28. 1.18 - /STATE
/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 COLPG COM COMO
CUR FPG HIB HIBO
LEF LEFO MUTEX PFW
PSXFR RWAST RWBRK RWCAP
RWCLU RWCSV RWIMG RWLCK
RWMBX RWMPB RWMPE RWNPG
RWPAG RWPFF RWQUO RWSCS
RWSWP SUSP SUSPO
28. 1.19 - /SUBPROCESS
/SUBPROCESS
/NOSUBPROCESS
Displays all subprocesses on the system. When you use the
/NOSUBPROCESS qualifier, all subprocesses are excluded from the
output.
28. 1.20 - /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.
28.2 - Examples
1.$ SHOW SYSTEM
OpenVMS 7.3 on node KRYPTN 14-DEC-2001 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 KING CUR 6 4 14045 0 00:02:03.24 20032 397
274016D5 DAVIS LEF 6 427 0 00:00:09.28 5275 1384
27401ED6 deGroot 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 DOERING LEF 4 2132 0 00:00:23.85 5318 452
274022EB KERR CUR 6 4 492 0 00:00:12.15 5181 459
274018EF DUFRESNE 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 EAGAN HIB 5 25104 0 00:06:07.76 37407 1923
274020F5 TAN LEF 7 14726 0 00:02:10.74 34262 1669
27400CF6 KELLEY 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:
o Process identification (PID) code-A 32-bit binary value that
uniquely identifies a process.
o Process name-A 1- to 15-character string used to identify a
process.
o 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 shows the CPU ID of the
processor on which any current process is executing.
Note that the SHOW SYSTEM command examines the processes on
the system without stopping activity on the system. In this
example, process information changed during the time that
the SHOW SYSTEM command collected the data to be displayed.
As a result, this display includes two processes, named
GAWAIN and S. Whiplash, with the state CUR on the same CPU,
CPU ID 6 in the example.
o Current priority -The priority level assigned to the process
(the higher the number, the higher the priority).
o 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.
o Charged CPU time-The amount of CPU time that a process has
used thus far.
o Number of page faults-The number of exceptions generated by
references to pages that are not in the process's working
set.
o Pages-The number of CPU-specific pages in physical memory
that the process is currently occupying.
o Process indicator-Letter B indicates a batch job; letter
S indicates a subprocess; letter N indicates a network
process.
o User identification code (UIC)-An 8-digit octal number
assigned to a process. This number is displayed only if
the /FULL qualifier is specified.
2.$ SHOW SYSTEM /CLUSTER
OpenVMS V7.3 on node ALPES 14-DEC-2001 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 V7.3 on node EON 14-DEC-2001 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 V7.3 on node AAAAAA 12-MAY-2001 10:29 AM Uptime 3 16:37:39
AlphaServer 8400 5/440
OpenVMS V7.2 on node BBBBBB 12-MAY-2001 10:29 AM Uptime 3 12:42:56
VAX 6000-540
OpenVMS V7.2 on node CCCCCC 12-MAY-2001 10:29 AM Uptime 3 16:26:52
VAX 7000-760
OpenVMS V7.1 on node DDDDDD 12-MAY-2001 10:29 AM Uptime 3 16:41:35
DEC 4000 Model 610
OpenVMS V7.2 on node EEEEEE 12-MAY-2001 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 V7.3 on node AAAAAA 12-MAY-2001 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 STEFANELLI 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 V7.3 on node AAAAAA 12-MAY-2001 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=TIMMER
OpenVMS V7.3 on node AAAAAA 12-MAY-2001 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 TIMMER 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
BESTON.
9.$ SHOW SYSTEM/STATE=L*
OpenVMS V7.3 on node AAAAAA 12-MAY-2001 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 STADLER 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.
10$ SHOW SYSTEM/MULTITHREAD
OpenVMS V7.3 on node ZIMBER 30-OCT-2001 11:34:11.51 Uptim 8 20:21:31
Pid Process Name State Pri I/O CPU Page flts Pages
0000008C SECURITY_SERVER HIB 11 131 0 00:55:25.25 4370 194 M
$ SHOW SYSTEM/MULTITHREAD/FULL
OpenVMS V7.3 on node ZIMBER 30-OCT-2001 11:34:13.98 Uptime 8 20:21:34
AlphaStation 400 4/233
Pid Process Name State Pri I/O CPU Page flts Pages
0000008C SECURITY_SERVER HIB 11 131 0 00:55:25.26 4370 194 M
0000010C HIB 11
[SYSTEM] 1552Kb
These examples show the results of the /MULTITHREAD qualifier
and the combination results of the /MULTITHREAD and /FULL
qualifiers.
| 29 - TERMINAL |
Displays the current characteristics of a specific terminal.
Each characteristic corresponds to an option of the SET TERMINAL
command.
Format
SHOW TERMINAL [device-name[:]]
29.1 - Parameter
device-name[:]
Specifies the name of the terminal for which you want the
characteristics displayed. The default is your terminal
(SYS$COMMAND).
29.2 - Qualifiers
29. 2.1 - /BRIEF
Displays a subset of more commonly used terminal characteristics.
29. 2.2 - /FULL
/FULL (default)
Displays all terminal characteristics.
29. 2.3 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter the /OUTPUT qualifier
without a file specification, the output is sent to the current
process default output stream or device, identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS the default file type. If you
enter a file specification, it cannot include the asterisk (*)
and the percent sign (%) wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
29. 2.4 - /PERMANENT
Requires LOG_IO (logical I/O) or PHY_IO (physical I/O) privilege.
Displays the permanent characteristics of the terminal.
29.3 - Examples
1.$ SHOW TERMINAL/BRIEF
Terminal: _RTA1: Device_Type: VT300_Series Owner: _RTA1:
Username: REHOR
Terminal Characteristics:
Speed: 9600 Page: 62 Width: 80
No Remote Hostsync TTsync
No Modem Broadcast Wrap
No Hangup No Disconnect Overstrike editing
No Dialup Application keypad Line Editing
In this example, the SHOW TERMINAL command displays a subset of
the more commonly used terminal characteristics.
2.$ SHOW TERMINAL/FULL
Terminal: _TTE4: Device_Type: VT102 Owner: FRANKLIN
Physical Terminal: _LTA49
Input: 9600 LFfill: 0 Width: 80 Parity: None
Output: 9600 CRfill: 0 Page: 24
Terminal Characteristics:
Interactive Echo Type_ahead No Escape
No Hostsync TTsync Lowercase Tab
Wrap Scope No Remote Eightbit
Broadcast No Readsync No Form Fulldup
No Modem No Local_echo No Autobaud Hangup
No Brdcstmbx No DMA No Altypeahd Set_speed
Line Editing Overstrike editing No Fallback No Dialup
No Secure server No Disconnect No Pasthru No Syspassword
No SIXEL Graphics Soft Characters Printer port Numeric Keypad
ANSI_CRT No Regis No Block_mode Advanced_video
Edit_mode DEC_CRT DEC_CRT2 No DEC_CRT3
In this example, the SHOW TERMINAL command displays the
characteristics of this specific terminal. If you are
displaying statistics about a terminal allocated to another
user, the input, output, LFfill, CRfill, width, page, and
parity statistics are not shown (see the next example).
3.$ SHOW TERMINAL/FULL
Terminal: _RTA1: Device_Type: VT300_Series Owner: _RTA1:
Username: VILLA
Remote Port Info: NODE12::VILLA
Input: 9600 LFfill: 0 Width: 80 Parity: None
Output: 9600 CRfill: 0 Page: 62
Terminal Characteristics:
Interactive Echo Type_ahead No Escape
Hostsync TTsync Lowercase Tab
Wrap Scope No Remote Eightbit
Broadcast No Readsync No Form Fulldup
No Modem No Local_echo No Autobaud No Hangup
No Brdcstmbx No DMA No Altypeahd Set_speed
No Commsync Line Editing Overstrike editing No Fallback
No Dialup No Secure server No Disconnect No Pasthru
No Syspassword SIXEL Graphics No Soft Characters Printer port
Application keypad ANSI_CRT Regis No Block_mode
Advanced_video Edit_mode DEC_CRT DEC_CRT2
DEC_CRT3 No DEC_CRT4 No DEC_CRT5 Ansi_Color
VMS Style Input
In this example, the SHOW TERMINAL command displays the full
terminal characteristics.
| 30 - TIME |
Displays the current date and time.
Format
SHOW [DAY]TIME
30.1 - Example
$ SHOW TIME
3-NOV-2001 00:02:00
The SHOW TIME command in this example displays the current date
and time.
| 31 - TRANSLATION |
Displays the first translation found for the specified logical
name. You can specify the tables that are searched.
Requires read (R) access to a logical name table to display
information about any logical name cataloged in that table.
Format
SHOW TRANSLATION logical-name
31.1 - Parameter
logical-name
Specifies the logical name whose translation you want to display.
31.2 - Qualifier
31. 2.1 - /TABLE
/TABLE=name
Searches the specified table. The default value for the name
parameter is LNM$DCL_LOGICAL.
If you specify the table name by using a logical name that
translates to more than one table, then each table is searched
in the order specified until a match is found.
31.3 - Examples
1.$ SHOW TRANSLATION PAYROLL
PAYROLL = DISK1:[ACCOUNTS.WORKING]FACTOR1.DAT;37 (LNM$PROCESS_TABLE)
The SHOW TRANSLATION command in this example displays the
translation for the logical name PAYROLL and also displays
the name of the table where the logical name was found. In this
example, PAYROLL was found in LNM$PROCESS_TABLE, the process
logical name table.
2.$ DEFINE DISK DKA1:
$ DEFINE/GROUP DISK DKA2:
$ SHOW TRANSLATION DISK
DISK = DKA1:(LNM$PROCESS_TABLE)
The DEFINE commands in this example place entries for the
logical name DISK in both the process and group logical
name tables. Then, the SHOW TRANSLATION command shows the
translation associated with the logical name DISK. By default,
the process, job, group, and system tables are searched (in
that order). The first match found is displayed. The logical
name DISK from the process table (LNM$PROCESS_TABLE) is
displayed because it is found before the name DISK in the group
table.
3.$ RUN ORION
<Ctrl/Y>
$ SHOW TRANSLATION TERMINAL
TERMINAL = _TTT3: (LNM$PROCESS_TABLE)
$ CONTINUE
The RUN command in this example executes the image ORION.EXE.
After the Ctrl/Y function interrupts the image, the SHOW
TRANSLATION command displays a logical name assignment. The
CONTINUE command resumes the execution of the image.
4.$ SHOW TRANSLATION/TABLE=LNM$SYSTEM USER
USER = "DKA2:" (LNM$SYSTEM_TABLE)
The SHOW TRANSLATION command in this example displays the
translation for the logical name USER. Because a table name
is specified, the SHOW TRANSLATION command does not use the
default search order. Only the specified table, LNM$SYSTEM, is
searched. LNM$SYSTEM is the system logical name table.
5.$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY MYPROC -
_$ TEST_TABLE, LNM$PROCESS
$ SHOW TRANSLATION/TABLE=MYPROC FILER
FILER = "[SMITH.FILER]" (TEST_TABLE)
In this example, MYPROC defines a list of logical name
tables that you want searched. It asks the system to first
search TEST_TABLE (a user-defined table) and then to search
LNM$PROCESS (the process logical name table). MYPROC is stored
in LNM$PROCESS_DIRECTORY, the process directory table. When you
enter the SHOW TRANSLATION command to find FILER in the MYPROC
table, the tables TEST_TABLE and LNM$PROCESS are searched, in
that order. The first match found is displayed.
| 32 - USERS |
Displays the user name and node name (in an OpenVMS Cluster
environment) of interactive, subprocess, and batch users on the
system.
Format
SHOW USERS [username]
32.1 - Parameter
username
Specifies the user about whom you want information. The asterisk
(*) and the percent sign (%) wildcard characters are allowed.
If you specify a string, all users whose user names begin with
the string are displayed. For example, if you specify the string
MAR, all user names that begin with MAR are displayed. If no user
exists whose name matches the specified string, an informational
message tells you that no processes were found.
If you omit the username parameter, a list of all interactive,
subprocess, and batch users is displayed.
32.2 - Qualifiers
32. 2.1 - /BATCH
/BATCH
/NOBATCH
Displays all batch users in the OpenVMS Cluster environment. To
restrict the display to users on specific nodes, use the /BATCH
qualifier with the /NODE qualifier. When you use the /NOBATCH
qualifier, all batch users are excluded from the display.
32. 2.2 - /CLUSTER
Displays the specified user names on all nodes in an OpenVMS
Cluster environment.
32. 2.3 - /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.
32. 2.4 - /FULL
Displays the user name, the node name, the process name,
the process identification (PID) code, terminal names (both
virtual and physical), and port information of all interactive,
subprocess, and batch users on the system.
32. 2.5 - /HEADING
/HEADING (default)
/NOHEADING
Displays a heading line above the system output. When you use
the /NOHEADING qualifier, the heading line is excluded from the
display.
32. 2.6 - /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.
32. 2.7 - /INTERACTIVE
/INTERACTIVE
/NOINTERACTIVE
Displays all interactive processes held by users in the OpenVMS
Cluster environment. To restrict the display to users on specific
nodes, use the /INTERACTIVE qualifier with the /NODE qualifier.
When you use the /NOINTERACTIVE qualifier, all interactive
processes held by users in the OpenVMS Cluster environment are
excluded from the display.
32. 2.8 - /NETWORK
/NETWORK
/NONETWORK
Displays all network users in the OpenVMS Cluster environment. To
restrict the display to users on specific nodes, use the /NETWORK
qualifier with the /NODE qualifier. When you use the /NONETWORK
qualifier, all network users in the OpenVMS Cluster environment
are excluded from the display.
32. 2.9 - /NODE
/NODE[=(name,...)]
Displays all interactive, subprocess, and batch users on the
specified node or nodes. If you enter the /NODE qualifier without
a value, the qualifier displays all the interactive, subprocess,
and batch users on the local node.
32. 2.10 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default,
the output of the SHOW USERS 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.
32. 2.11 - /PAGE
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of user 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.
32. 2.12 - /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.
32. 2.13 - /SUBPROCESS
/SUBPROCESS
/NOSUBPROCESS
Displays all subprocess users in the OpenVMS Cluster environment.
To restrict the display to users on specific nodes, use the
/SUBPROCESS qualifier with the /NODE qualifier. When you use
the /NOSUBPROCESS qualifier, all subprocess users in the OpenVMS
Cluster environment are excluded from the output.
32. 2.14 - /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.
32.3 - Examples
1.$ SHOW USERS
OpenVMS User Processes at 12-MAY-2001 10:37 AM
Total number of users = 4, number of processes = 14
Username Node Interactive Subprocess Batch
S_SKONETSKI BBBBBB 1
WISNIEWSKI XXXXXX 4 2
HIBBITS AAAAAA 1 4
VAXMAN AAAAAA 2
The SHOW USERS command in this example displays the user names
and node names of all current interactive, subprocess, and
batch users on the system.
2.$ SHOW USERS/NOHEADING/OUTPUT=SYSUSERS.DAT
$ TYPE SYSUSERS.DAT
S_SKONETSKI BBBBBB 1
WISNIEWSKI XXXXXX 4 2
HIBBITS AAAAAA 1 4
VAXMAN AAAAAA 2
The SHOW USERS command in this example displays the user names
and node names of all current interactive, subprocess, and
batch users on the system without the heading text using the
/NOHEADING qualifier. Using the /OUTPUT qualifier, you can
write the output to a file for processing or later review.
3.$ SHOW USERS *LES*
OpenVMS User Processes at 12-MAY-2001 10:41 AM
Total number of users = 3, number of processes = 10
Username Node Interactive Subprocess Batch
THALES MILETS - - 1
PRAXITELES LESBOS 5 2
PERICLES ISLAND 1
The SHOW USERS command in this example displays the user name
and node names of all users whose user names contain the string
LES.
4.$ SHOW USERS/FULL/NODE=AAAAAA
OpenVMS User Processes at 9-JUN-2001 02:23 PM
Total number of users = 3, number of processes = 3
Username Node Process Name PID Terminal
DJONES AAAAAA Aaaaaa_fta2: 2180012D FTA2:
DYSLI AAAAAA DYSLI 2180011A FTA1:
SINDBY AAAAAA SINDBY 2180011E RTA1: (JJJJJ::SINDBY)
<LOGIN> B4B4 _WSA1 3100009F
The SHOW USERS command in this example displays the user name,
the local node, the process name, the process identification
(PID) number, the terminal names (both virtual and physical),
and port information for all interactive, subprocess, and batch
users on system AAAAAA. A user name of <LOGIN> indicates that
someone is in the process of logging in.
5.$ SHOW USERS /NODE=(AAAAAA,BBBBBB,MMMMMM)
OpenVMS User Processes at 9-JUN-2001 02:23 PM
Total number of users = 5, number of processes = 7
Username Node Process Name PID Terminal
BRICKLEY BBBBBB BRICKLEY 21E0009E RTA1: (CBREEZ::BRICKLEY)
DCLDCT MMMMMM Mmmmmm_rta1: 2020015D RTA1: (MMMMMM::DJOHNSON)
PELEG AAAAAA Aaaaaa_fta2: 2180012D FTA2:
PETERSON MMMMMM Mmmmmm_fta1: 2020013E FTA1:
PRESTON MMMMMM Mmmmmm_rta3: 20200184 RTA3: (DDRSND::PRESTON)
PRUSS AAAAAA PRUSS 2180011E RTA1: (IVOK::PRUSS)
RABAHY AAAAAA RABAHY 2180011A FTA1:
The SHOW USERS command in this example displays the user name
and node name for all interactive, batch, and subprocess users
on the nodes AAAAAA, BBBBBB, and MMMMMM.
| 33 - WORKING_SET |
On Alpha, displays the working set limit, quota, and extent (in
pagelets and CPU-specific pages) assigned to the current process.
On VAX, displays the working set limit, quota, and extent (in
pages) assigned to the current process.
Format
SHOW WORKING_SET
33.1 - Qualifier
33. 1.1 - /OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter the /OUTPUT qualifier
without a file specification, the output is sent to the current
process default output stream or device, identified by the
logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and .LIS the default file type. The
asterisk (*) and the percent sign (%) wildcard characters are
not allowed in the file specification.
If you enter the /NOOUTPUT qualifier, output is suppressed.
33.2 - Examples
1.$ SHOW WORKING_SET
Working Set (pagelets) /Limit= 2000 /Quota= 4000 /Extent= 6000
Adjustment enabled Authorized Quota= 4000 Authorized Extent= 6000
Working Set (8Kb pages) /Limit= 125 /Quota= 250 /Extent= 375
Authorized Quota= 250 Authorized Extent= 375
This example shows the SHOW WORKING_SET command on Alpha. The
process has a working set limit of 2000 pagelets (125 pages)
and a quota of 4000 pagelets (250 pages), and the current quota
is equal to the authorized limit (4000 pagelets; 250 pages). It
also shows that the current process has a working set extent of
6000 pagelets (375 pages) and that the current extent is equal
to the authorized limit (6000 pagelets; 375 pages). A pagelet
is 512 bytes.
2.$ SHOW WORKING_SET
Working Set /Limit= 180 /Quota= 350 /Extent=1200
Adjustment enabled Authorized Quota= 350 Authorized Extent=1200
This example shows the SHOW WORKING_SET command on VAX. The
process has a working set limit of 180 pages, a quota of 350
pages, and the quota is equal to the authorized limit (350
pages). It also shows that the current process has a working
set extent of 1200 and that the current extent is equal to the
authorized limit (1200). Each page on a VAX is 512 bytes.
| 34 - ZONE |
Displays the current state of a VAXft system. For more
information on the SHOW ZONE command, see VAXft systems
documentation.
Applies only to a VAXft system.
Format
SHOW ZONE [zone-id]
|
|
