VMS Help SHOW, CPU *Conan The Librarian (sorry for the slow response - running on an old VAX) |
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 a VAX 6000 system or an Alpha 7000 system, the CPU ID is the backplane slot number of the processor.
2 - Qualifiers |
2.1 - /ACTIVE
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 - /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.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.
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.
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.
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.
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.
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.
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.
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.
|