Displays the current state of the processors in an OpenVMS
system.
Format
SHOW CPU [cpu-id[,...]]
1 – Parameter
cpu-id[,...]
Specifies a decimal value representing the identity of a
processor in a OpenVMS multiprocessing system. On an Alpha 7000
system, the CPU ID is the backplane slot number of the processor.
2 – Qualifiers
2.1 /ACTIVE_SET
Selects as the subject of the display only those processors that
are members of the system's active set.
2.2 /ALL
Selects all configured processors, active and inactive, as the
subject of the display.
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.
2.4 /CONFIGURE_SET
/CONFIGURE_SET (Alpha/Integrity servers only)
Selects as the subject of the display only those processors
that are members of the system's configure set - those that are
actively owned and controlled by the current instance.
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.
2.6 /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, see the VSI OpenVMS I/O User's Reference Manual.
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.
2.8 /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.
2.9 /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.
2.10 /POTENTIAL_SET
/POTENTIAL_SET (Alpha/Integrity servers only)
Selects as the subject of the display only those processors that
are members of the system's potential set - those CPUs in the
hard partition that meet the current instance's requirements to
join its active set.
Inclusion in this set does not imply that the CPU is (or ever
will be) owned by the current instance. The potential set
only describes those physically existing CPUs that currently
meet the instance-specific hardware and software compatibility
constraints, should they ever become available.
2.11 /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.
2.12 /STANDBY_SET
/STANDBY_SET (Alpha/Integrity servers only)
Selects as the subject of the display only those processors that
are members of the system's standby set - those CPUs in the hard
partition that are not currently owned by soft partitions.
Supported only on AlphaServer systems that support partitioning.
2.13 /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.
2.14 /SYSTEM
/SYSTEM (Alpha/Integrity servers only)
Displays platform-specific hardware information relating to the
current instance.
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.
3 – Examples
1.$ SHOW CPU
Alpha:
System: LOWFAT, COMPAQ AlphaServer DS20E 666 MHz
Integrity servers:
System: EUROS, VSI rx2600 (900MHz/1.5MB)
CPU ownership sets:
Active 0,1
Configure 0,1
CPU state sets:
Potential 0,1
Autostart 0,1
Powered Down None
Not Present None
Hard Excluded None
Failover None
The SHOW CPU command in this example produces a configuration
summary of all configured processors in the Alpha (LOWFAT) and
Integrity server (EUROS) systems. The primary processor is CPU
01, and all configured processors are active.
2.$ SHOW CPU/BRIEF
Alpha:
System: LOWFAT, COMPAQ AlphaServer DS20E 666 MHz
CPU 0 State: RUN CPUDB: 81C1A000 Handle: * None *
Process: DAVIS PID: 20400EB2
CPU 1 State: RUN CPUDB: 81D03680 Handle: * None *
Integrity servers:
System: EUROS, VSI rx2600 (900MHz/1.5MB)
CPU 0 State: RUN CPUDB: 8901C000 Handle: 00005D70
Owner: 000004C8 Current: 000004C8 Partition 0 (EUROS)
CPU 1 State: RUN CPUDB: 89163480 Handle: 00005E80
Owner: 000004C8 Current: 000004C8 Partition 0 (EUROS)
Process: DAVIS PID: 20201192
The SHOW CPU/BRIEF command in this example produces a
configuration summary of the Alpha (LOWFAT) and Integrity
server (EUROS) systems. It also indicates that its two
processors are in the RUN state. Only CPU 00 has a current
process.
3.$ SHOW CPU/FULL
System: WFGLXD, AlphaServer GS320 6/731
SMP execlet = 2 : Enabled : Full checking.
Config tree = Version 6
Primary CPU = 0
HWRPB CPUs = 32
Page Size = 8192
Revision Code =
Serial Number = BUDATEST
Default CPU Capabilities:
System: QUORUM RUN
Default Process Capabilities:
System: QUORUM RUN
CPU 0 State: RUN CPUDB: 81416000 Handle: 00003200
Owner: 000006C0 Current: 000006C0 Partition 0 (WFGLXA)
ChgCnt: 1 State: Present, Primary, Hotswap
Process: SHADOW_SERVER PID: 00000434
Capabilities:
System: PRIMARY QUORUM RUN RAD0
Slot Context: 8F5BA180
CPU - State..........: RC, PA, PP, CV, PV, PMV, PL
Type...........: EV67, Pass 2.3
Speed..........: 730 Mhz
Variation......: VAX FP, IEEE FP, Primary Eligible
Serial Number..: SM00700054
Revision.......:
Halt Request...: 0
Software Comp..: 8.4
PALCODE - Revision Code..: 1.96-01
Compatibility..: 6
Max Shared CPUs: 32
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings:
NETACP PID = 0000041A Reason: PRIMARY Capability
Fastpath: * None *
Features:
Autostart - Enabled.
Fastpath - Selection enabled as Preferred CPU.
CPU 1 State: RUN CPUDB: 81456880 Handle: 00003500
Owner: 000006C0 Current: 000006C0 Partition 0 (WFGLXA)
ChgCnt: 1 State: Present, Hotswap, Reassignable
Process: SYSTEM PID: 00000428
Capabilities:
System: QUORUM RUN RAD0
Slot Context: 8F5BA400
CPU - State..........: RC, PA, PP, CV, PV, PMV, PL
Type...........: EV67, Pass 2.3
Speed..........: 730 Mhz
Variation......: VAX FP, IEEE FP, Primary Eligible
Serial Number..: NI94370773
Revision.......:
Halt Request...: 0
Software Comp..: 8.4
PALCODE - Revision Code..: 1.96-01
Compatibility..: 6
Max Shared CPUs: 32
Memory Space..: Physical = 00000000.00000000 Length =0
Scratch Space..: Physical = 00000000.00000000 Length =0
Bindings: * None *
Fastpath: * None *
Features:
Autostart - Enabled.
Fastpath - Selection enabled as Preferred CPU.
The SHOW CPU/FULL command in this example produces a
configuration summary of the AlphaServer GS320 system, WFGLXD.
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 0 and 1 have Fastpath
ports.
4.$ SHOW CPU 2/BRIEF
System: WFGLXA, AlphaServer GS320 6/731
CPU 2 State: RUN CPUDB: 81457680 Handle: 00003800
Owner: 000006C0 Current: 000006C0 Partition 0 (WFGLXA)
Process: SHADOW_SERVER PID: 00000429
The SHOW CPU/BRIEF command in this example produces a brief
configuration summary of CPU 2. CPU 2 is currently running
under instance WFGLXA in partition 0.
5.$ SHOW CPU 11
System: WFGLXA, AlphaServer GS320 6/731
CPU 11 State: NOT_CONFIGURED CPUDB: 81470E00 Handle: 000125C0
Owner: 00000440 Current: 00000440 Hard Partition 0
This SHOW CPU command produces a configuration summary of
CPU 11 on instance WFGLXA. CPU 11 is not configured in this
instance and is currently assigned to hard partition 0.
6.$ SHOW CPU 8/FU
System: WFGLXA, AlphaServer GS320 6/731
CPU 8 State: POWERED_DOWN CPUDB: 81459280 Handle: 00011CC0
Owner: 000006C0 Current: 000006C0 Partition 0 (WFGLXA)
ChgCnt: 3 State: Present, In-Console, Powered Down,
Hotswap, Reassignable
Process: * None *
Capabilities:
System: QUORUM RAD0
Slot Context: 8F5BB580
CPU - State..........: BIP, CV, PV, PMV, PL
Bindings: * None *
Fastpath: * None *
Features:
Autostart - Enabled.
Fastpath - Selection enabled as Preferred CPU.
This SHOW CPU command produces a summary of CPU 8. CPU 8 is
currently powered down, but a CPU module is present in the
backplane slot.
7.$ SHO CPU
System: WFGLXA, AlphaServer GS320 6/731
CPU ownership sets:
Active 0-3,9,10
Configure 0-3,8-10
Standby 11
Hard Partition 11
CPU state sets:
Potential 0-7,9-15
Autostart 0-31
Powered Down 8
Not Present 16-31
Failover None
The SHOW CPU command shows the configuration characteristics of
the instance.
8.$ SHOW CPU/SYS
System: WFGLXA, AlphaServer GS320 6/731
SMP execlet = 2 : Enabled : Full checking.
Config tree = Version 6
Primary CPU = 0
HWRPB CPUs = 32
Page Size = 8192
Revision Code =
Serial Number = BUDATEST
Default CPU Capabilities:
System: QUORUM RUN
Default Process Capabilities:
System: QUORUM RUN
CPU ownership sets:
Active 0-3,9,10
Configure 0-3,8-10
Standby 11
Hard Partition 11
CPU state sets:
Potential 0-7,9-15
Autostart 0-31
Powered Down 8
Not Present 16-31
Failover None
This SHOW CPU/SYSTEM command shows the platform-specific
hardware information relating to instance WFGXLA.
9.$ SET PROCESS /AFFINITY /SET=3 SYSTEM/PERMANENT
$ SHOW CPU 3/FULL
System: WFGLXD, AlphaServer GS320 6/731
CPU 3 State: RUN CPUDB: 81416000 Handle: 00003200
Owner: 000006C0 Current: 000006C0 Partition 0 (WFGLXA)
ChgCnt: 1 State: Present, Primary, Hotswap
Process: SHADOW_SERVER PID: 00000434
Capabilities:
System: PRIMARY QUORUM RUN RAD0
Slot Context: 8F5BA180
CPU - State..........: RC, PA, PP, CV, PV, PMV, PL
Type...........: EV67, Pass 2.3
Speed..........: 730 Mhz
Variation......: VAX FP, IEEE FP, Primary Eligible
Serial Number..: SM00700054
Revision.......:
Halt Request...: 0
Software Comp..: 8.4
PALCODE - Revision Code..: 1.96-01
Compatibility..: 6
Max Shared CPUs: 32
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings:
SYSTEM PID = 00000434 Reason: Affinitized to this CPU
Fastpath:
PNA0
Features:
Autostart - Enabled.
Fastpath - Selection enabled as Preferred CPU.
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.
10$ SHOW CPU/FULL
System: LOWFAT, COMPAQ AlphaServer DS20E 666 MHz
SMP execlet = 3 : Enabled : Streamlined.
Config tree = None
Primary CPU = 0
HWRPB CPUs = 2
Page Size = 8192
Revision Code =
Serial Number = 4033DZ2Z1023
Default CPU Capabilities:
System: QUORUM RUN
Default Process Capabilities:
System: QUORUM RUN
CPU 0 State: RUN CPUDB: 81C1A000 Handle: * None *
Process: DAVIS PID: 20400EB2
Capabilities:
System: PRIMARY QUORUM RUN RAD0
User: Usr1 Usr2
Slot Context: 857F6180
CPU - State..........: RC, PA, PP, CV, PV, PMV, PL
Type...........: EV67, Pass 2.2.3 & Pass 2.2.5
Speed..........: 667 Mhz
Variation......: VAX FP, IEEE FP, Primary Eligible
Serial Number..:
Revision.......:
Halt Request...: 0
Software Comp..: 8.4
PALCODE - Revision Code..: 1.98-01
Compatibility..: 79
Max Shared CPUs: 2
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings: * None *
Fastpath:
PKC0
FGA0
PEA0
EWA0
Features:
Autostart - Enabled.
Fastpath - Selection enabled as Preferred CPU.
CPU 1 State: RUN CPUDB: 81D03680 Handle: * None *
Process: * None *
Capabilities:
System: QUORUM RUN RAD0
Slot Context: 857F6400
CPU - State..........: RC, PA, PP, CV, PV, PMV, PL
Type...........: EV67, Pass 2.2.3 & Pass 2.2.5
Speed..........: 667 Mhz
Variation......: VAX FP, IEEE FP, Primary Eligible
Serial Number..:
Revision.......:
Halt Request...: 0
Software Comp..: 8.4
PALCODE - Revision Code..: 1.98-01
Compatibility..: 79
Max Shared CPUs: 2
Memory Space..: Physical = 00000000.00000000 Length = 0
Scratch Space..: Physical = 00000000.00000000 Length = 0
Bindings: * None *
Fastpath:
PKB0
PKA0
FWA0
BG0
Features:
Autostart - Enabled.
Fastpath - Selection enabled as Preferred CPU.
$
The SHOW CPU/FULL command in this example produces a
configuration summary of the Alpha DS20E 666 MHz system LOWFAT,
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.