HELPLIB.HLB  —  SHOW  CPU
    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.
Close Help