HP OpenVMS DCL Dictionary


Previous Contents Index


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 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_SET

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.

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

/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, see the HP 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.

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

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

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

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

/SYSTEM (Alpha/Integrity servers only)

Displays platform-specific hardware information relating to the current instance.

/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
 
Alpha: 
System: LOWFAT, COMPAQ AlphaServer DS20E 666 MHz 
Integrity servers: 
System: EUROS, HP 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, HP 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.


Previous Next Contents Index