 |
OpenVMS DCL Dictionary
SHOW 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
SHOW CPU
Displays the current state of the processors in an OpenVMS system.
Format
SHOW CPU [cpu-id[,...]]
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.
Description
The SHOW CPU command displays information about the status,
characteristics, and capabilities of the processors active in and
available to an OpenVMS multiprocessing or single-CPU system.
You identify the processors to be displayed by using either the /ACTIVE
qualifier, the /ALL qualifier, a CPU ID, or list of CPU IDs. If you
specify none of these, the SHOW CPU command uses the /ALL qualifier by
default.
You identify the type of information to be displayed by using the
/BRIEF, /FULL, and /SUMMARY qualifiers. If you specify none of these
qualifiers, the SHOW CPU command assumes the /BRIEF qualifier by
default; however, if you likewise do not identify a processor or
processors as the object of a command, the SHOW CPU command assumes a
default of SHOW/ALL/SUMMARY.
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.
Qualifiers
/ACTIVE
Selects as the subject of the display only those processors that are
members of the system's active set.
/ALL
Selects all configured processors, active and inactive, as the subject
of the display.
/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.
/EXACT
Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search
string that must match the search string exactly and must be enclosed
with quotation marks (" ").
If you specify the /EXACT qualifier without the /SEARCH qualifier,
exact search mode is enabled when you set the search string with the
Find (E1) key.
/FULL
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.
/HIGHLIGHT[=keyword]
Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of
highlighting you want when a search string is found. When a string is
found, the entire line is highlighted. You can use the following
keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default
highlighting.
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. 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.
/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), Return, Enter, Space
|
Get the next page of information.
|
|
F10, Ctrl/Z
|
Exit. (Some utilities define these differently.)
|
|
Help (F15)
|
Display utility help text.
|
|
Do (F16)
|
Toggle the display to oldest/newest page.
|
|
Ctrl/W
|
Refresh the display.
|
The /PAGE qualifier is not compatible with the /OUTPUT qualifier.
/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.
/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.
/WRAP
/NOWRAP (default)
Use with the /PAGE=SAVE qualifier to limit the number of columns to the
width of the screen and to wrap lines that extend beyond the width of
the screen to the next line.
The /NOWRAP qualifier extends lines beyond the width of the screen and
can be seen when you use the scrolling (left and right) features
provided by the /PAGE=SAVE qualifier.
Examples
| #1 |
$ SHOW 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:
- 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.
- The CPU is stopped.
SHOW DEFAULT
Displays the current default device and directory.
Format
SHOW DEFAULT
Description
The SHOW DEFAULT command displays the current device and directory
names, along with any equivalence strings.
The default disk and directory are established in the user
authorization file (UAF). You can change these defaults during a
terminal session or in a batch job by using the SET DEFAULT command, or
by reassigning the logical name SYS$DISK.
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]
= WRK:[SCHENKENBERGER.TEMP1]
= WRK:[SCHENKENBERGER.TEMP2]
|
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.
SHOW DEVICES
Displays the status of a device on the system.
See the qualifier descriptions for restrictions.
Format
SHOW DEVICES [device-name[:]]
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:
- 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.
- If you omit a controller designation, the SHOW DEVICES command
lists all devices on all controllers with the specified unit number.
- 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.
Description
When you enter the SHOW DEVICES command without specifying a device or
using any qualifier, information about all devices on the system is
displayed. If you specify a device name, the SHOW DEVICES command
displays information about that device. If you use certain qualifiers
with the SHOW DEVICES command, information is displayed about those
devices that currently have volumes mounted or that have been allocated
to processes, or both.
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).
If you enter the SHOW DEVICES command and do not specify a device name
parameter or a qualifier, the command provides a brief listing of
characteristics of all devices on the system, with the exception of
pseudodevices with the mailbox characteristic, such as MBA3:, NLA0:,
NET9:, and so on. To display such a device, you must specify all or
part of the device name.
Qualifiers
/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.
/BRIEF (default)
Displays brief information about the specified devices.
/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.
/EXACT
Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search
string that must match the search string exactly and must be enclosed
with quotation marks (" ").
If you specify the /EXACT qualifier without the /SEARCH qualifier,
exact search mode is enabled when you set the search string with the
Find (E1) key.
/FILES
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.
/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.
/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.
/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.
/MULTIPATH
Displays all devices that are currently multipath sets.
|
