Hardware Installation and Use Control Panel: System I
Hardware Installation and Use Control Panel: System I
Hardware Installation and Use Control Panel: System I
System i
Note Before using this information and the product it supports, read the information in Notices, on page 35 and the manual IBM eServer Safety Information,, G229-9054.
| | |
This edition applies to version 5, release 4, modification 0 of IBM i5/OS (product number 5722-SS1) and to all subsequent releases and modifications until otherwise indicated in new editions. This version does not run on all reduced instruction set computer (RISC) models nor does it run on CISC models. Copyright International Business Machines Corporation 2004, 2006. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Control panel . . . . . . . . . . . . 1
Printable PDFs . . . . . . . . . . . . . Control panel concepts . . . . . . . . . . Types of control panels . . . . . . . . . Physical control panel . . . . . . . . Remote control panel . . . . . . . . Virtual control panel . . . . . . . . . Control panel functions . . . . . . . . . Control panel buttons, lights, and indicators . . Setting up your control panel . . . . . . . Accessing control panel functions . . . . . . Instructions and descriptions for control panel functions . . . . . . . . . . . . . . Normal control panel functions . . . . . . Extended control panel functions . . . . . Low-level debug panel functions 57 through 70 Using remote control panel APIs . . . . . . System power and test APIs . . . . . . . Turning on the system . . . . . . . . Performing panel lamp test . . . . . . Clearing panel lamp test . . . . . . . Powering off the system . . . . . . . IPL-related APIs . . . . . . . . . . . Setting IPL mode to Manual . . . . . . Setting IPL mode to Normal . . . . . . Setting IPL mode to Auto . . . . . . . Setting IPL mode to Secure . . . . . . Setting IPL type to A . . . . . . . . Setting IPL type to B . . . . . . . . Setting IPL type to C . . . . . . . . . 1 . 2 . 2 . 2 . 2 . 3 . 4 . 7 . 10 . 11 . 12 . 13 . 20 22 . 23 . 23 . 24 . 24 . 24 . 24 . 25 . 25 . 25 . 25 . 26 . 26 . 26 . 27 Setting IPL type to D . . . . . . . . . Starting an IPL . . . . . . . . . . . Setting IPL speed to Fast . . . . . . . . Setting IPL speed to Slow . . . . . . . Setting IPL speed to system default . . . . Other system function APIs . . . . . . . . Starting dedicated service tools on the primary or alternate console . . . . . . . Starting a main storage dump . . . . . . Disabling continuously powered main storage APIs that check the system status . . . . . . Is CPM present? . . . . . . . . . . . Is CPM enabled? . . . . . . . . . . Is the key inserted? . . . . . . . . . . Is the system turned on? . . . . . . . . Is the attention light lit? . . . . . . . . Is SPCN present? . . . . . . . . . . Getting the IPL mode . . . . . . . . . Getting the IPL type . . . . . . . . . Getting the IPL speed . . . . . . . . . Getting type and model information . . . . Getting the SPCN system reference code. . . Getting all system reference codes 1 - 9 . . . 27 27 28 28 29 29 29 30 30 31 31 31 31 32 32 32 33 33 33 33 34 34
Appendix. Notices . . . . . . . . . . 35
Programming Interface Information . Trademarks . . . . . . . . . Terms and conditions . . . . . . . . . . . . . . . . . . . 36 . 37 . 37
iii
iv
Control panel
You can process system functions using the control panel. The control panel is the initial interface to your system. From the control panel, you can process the following system functions: v Turn on or turn off the system. v Perform an initial program load (IPL). v Display and get attributes of error codes to analyze problems. v Determine processor activity. Attention: v If you have a partitioned system, only the primary partition can access the control panel. All secondary partitions use the remote control panel through the primary partition. v The information in this topic pertains only to IBM iSeries 270 and 8xx models. If you have a different model, see the IBM Systems Hardware Information Center for more information. The following topics provide information for you to set up the virtual control panel or the remote control panel, access control panel functions, and use APIs to operate your remote control panel with a user-written program. Related information IBM Systems Hardware Information Center
| |
Printable PDFs
Use this to view and print a PDF of this information. To view or download the PDF version of this document, select Control panel (about 600 KB). You can view or download these related topics: v Basic systems operations (about 600 KB) contains the following topics: Basic system operations Starting and stopping the system i5/OS concepts Analyzing and reporting system problems
Setting up your control panel on page 10 Both the remote control panel and the virtual control panel are set up through an Operations Console configuration. You need to install Operations Console and configure a remote control panel or a virtual control panel to use control panel functions. Control panel buttons, lights, and indicators on page 7 These figures illustrate the interface for each of the control panels, including the buttons, lights, and indicators. The interface for the virtual control panel and remote control panel are identical. Related tasks Accessing control panel functions on page 11 To access the control panel functions, follow these instructions, which apply to all three kinds of control panels.
How to choose between the virtual control panel and remote control panel
The following table shows which server models are recommended for the virtual control panel and which models are recommended for the remote control panel.
Control panel
Virtual control panel 270 800 810 820 825 830 840 870 890
Related concepts Control panel buttons, lights, and indicators on page 7 These figures illustrate the interface for each of the control panels, including the buttons, lights, and indicators. The interface for the virtual control panel and remote control panel are identical. Related tasks Accessing control panel functions on page 11 To access the control panel functions, follow these instructions, which apply to all three kinds of control panels. Related information iSeries Operations Console
Function code 02 03
Remote control panel code Virtual control panel function? 02 03 Yes Yes
Function description Select the IPL type, logical key mode, and IPL speed. Start an IPL to load the system. The IPL uses the selected IPL options. Lamp test all displays and indicators are switched on. System power control network (SPCN) system reference code (SRC). Display an SRC on the control panel. Allow you to perform SPCN service functions. Fast turn off. To perform a fast turn off, see Stopping the system in the Basic system operations topic collection. Reserved. System reference code (SRC) displays an SRC on the control panel. Display the machine type, model, processor feature code, processor class indicator, and IPL path description. Cause the Use Dedicated Service Tool (DST) display to appear on the system console. To exit DST, select the Resume operating system display option. Force system main storage dump. Reserved. Reserved. Use Service switches 1 and 2 to enable or disable functions 50 through 70. Use Service switches 1 and 2 to enable or disable functions 50 through 70. Reserved. Reorder SPCN addressing. Retry main storage dump (MSD) IPL. Reserved.
04 05
04 05
Yes No
07 08
Not applicable 08
09 through 10 11 through 19
20
20
Yes
21
21
Yes
22 23 24 25
26
26
Yes
27 through 32 33 34 35 through 49
Control panel
Function code 50 51
Remote control panel code Virtual control panel function? Not applicable Not applicable Not applicable Not applicable
Function description System processing unit stop. System processing unit status displays the following values: B0 register contents, Next Instruction Address (NIA), and current Task Dispatching Element (TDE) contents System processing unit start. Unconfigure an intermittently failing processor (Repeat GARD function) Reserved. Display area addresses for system data. Set the first character of the base address for the function 62 display. Set the second character of the base address for the function 62 display. Set the third character of base address for function 62 display. Set the fourth character of base address for function 62 display. Display service processor storage. System status SRC trace. Service processor diagnostic status SRC trace. Deactivate remote service. Activate remote service. Disk unit IOP reset/reload is enabled only by specific disk unit SRCs. Concurrent maintenance power domain Power Off. Concurrent maintenance power domain Power On. Dump service processor control storage.
52 53
Not applicable 53
Not applicable No
54 through 56 57 58
59
Not applicable
Not applicable
60
Not applicable
Not applicable
61
Not applicable
Not applicable
62 63 64 65 66 67
68 69 70
68 69 70
Yes Yes No
Function description
Power button in graphical Power button in graphical OFF = Delayed turn off. interface -- for powering on interface -- for powering off ON = Immediate power and off the system. the system only. on (can be timed (LAN-connected remote turn on). control panels cannot turn on the system.) See note. Graphical attention light Power indicator in graphical interface See note. Yes Power indicator in graphical interface IPL keylock - Manual, Auto, Normal, Secure. Attention state LED. Lit when power is fully operational.
Note: The remote control panel and virtual control panel recognize the presence of a keystick. If your system uses a keystick, the Mode button works with the same functions as the physical control panel, depending on whether the keystick is inserted. LAN-connected remote control panels need special authority to use the Mode button.
If you cannot find the function code in the previous table, the support for added features or devices might not have been available when this information was produced. Look for any supplemental unit function code information for the function code you displayed on the control panel. Related concepts Instructions and descriptions for control panel functions on page 12 Control panel functions can be classified into three categories: normal functions, extended functions, and low-level debug functions. The remote control panel and virtual control panel can perform most of these functions. The physical control panel can perform all of them.
Control panel
Function/Data display Increment and Decrement buttons Turn on indicator Power button System Attention light Enter button Mode button
(A)
Power On Light v A blinking light indicates power to the unit. v A constant light indicates that the unit is up and is working.
Power button Processor Activity System Attention Function/Data Display Increment and Decrement buttons Enter button
(A)
Power On Light v A blinking light indicates power to the unit. v A constant light indicates that the unit is up and is working.
(B) (C) (D) (E) (F) (G) (H) (J) (K) (L) (M) (N)
Power button Processor Activity System Attention Function/Data Display Increment and Decrement buttons Enter button Mode button Electronic Keystick Slot Secure Auto Normal Manual
Related concepts
Control panel
Physical control panel on page 2 The physical control panel is your initial interface with the system. You can use the physical control panel to perform functions such as initial program load (IPL), turn on, and turn off. Control panel functions range in complexity from functions that display status (such as IPL speed) to low-level service functions that only service representatives can access. Remote control panel on page 2 The remote control panel provides a way to use control panel functions through a PC. The graphical user interface of the remote control panel looks similar to the physical control panel. Virtual control panel on page 3 The virtual control panel is an alternative to the remote control panel for parallel cable. With the virtual control panel, you can use control panel functions through a PC. Related tasks Accessing control panel functions on page 11 To access the control panel functions, follow these instructions, which apply to all three kinds of control panels.
10
| |
Control panel
11
Related concepts Physical control panel on page 2 The physical control panel is your initial interface with the system. You can use the physical control panel to perform functions such as initial program load (IPL), turn on, and turn off. Control panel functions range in complexity from functions that display status (such as IPL speed) to low-level service functions that only service representatives can access. Remote control panel on page 2 The remote control panel provides a way to use control panel functions through a PC. The graphical user interface of the remote control panel looks similar to the physical control panel. Virtual control panel on page 3 The virtual control panel is an alternative to the remote control panel for parallel cable. With the virtual control panel, you can use control panel functions through a PC. Control panel buttons, lights, and indicators on page 7 These figures illustrate the interface for each of the control panels, including the buttons, lights, and indicators. The interface for the virtual control panel and remote control panel are identical.
12
Extended control panel functions Extended control panel functions are performed less often. Only service representatives can perform these functions. Extended functions are 50 through 70. Low-level debug panel functions These are functions 57 through 70. They are performed only by service representatives. Note: The examples in the following topics show control panels with a 4-word (32 character) display. Control panels with a 1-word (8 character) display only show the first word (8 characters) of each function. Related tasks Control panel functions on page 4 This table lists the codes and descriptions for each of the control panel functions and whether each type of the control panel supports these functions.
2. Insert the keystick. Press the Mode button to select the IPL mode. Follow function 01 and 02 procedures for systems with a keystick. Note: The function that is displayed is not activated until you press Enter on the control panel. To select a function number, press the Increment or Decrement button on the control panel. To activate the function, press Enter on the control panel while the system displays the required function number. Function 01 - Display Selected IPL Type and IPL Speed (on Systems with a Keystick) This function allows you to display the selected type and speed for the next IPL. 1. Display IPL types (A, B, C, or D). 2. Display IPL speed (F, S, SE, V=F, or V=S). When selected, function 01 displays the currently selected IPL type and IPL speed values (where each _ represents 1 character). The following table shows a function 01 example with a keystick.
Control panel
13
Function 01 - Display Selected IPL Type, Logical Key Mode, and IPL Speed (on Systems without a Keystick) This function allows you to display the selected IPL type, logical key mode, and speed for the next IPL. 1. Display IPL types (A, B, C, or D). 2. Display the valid logical key modes (M or N). 3. Display IPL speed (F, S, SE, V=F, or V=S). The following table shows a function 01 example on systems without a keystick. Function 01 on systems without a keystick
Function/data 0 1 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 1 _ _ A _ _ M _ _ V = F _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Action or description Use the Increment or Decrement buttons to scroll to function 01. Valid IPL types are A, B, C, and D. Valid logical key modes are Manual and Normal. Valid IPL speed displays are F, S, SE, V=F, or V=S. 0 1 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Use the Increment or Decrement buttons to scroll through the control panel functions.
Function 02 with a keystick - Select IPL Type and IPL Speed Override (on Systems with a Keystick) Before you can use function 02, you must have the system in Manual mode. You can change the IPL types with the system turned on or off. However, to select the IPL speed override, you must turn off the system. The following table shows the sequence used to select the IPL type on systems that are turned on. Function 02 - Select IPL type on turned-on systems with a keystick
Function/data 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ A < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ B < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Action or description Use the Increment or Decrement buttons to scroll to function 02. Press Enter to start function 02. The current IPL type is displayed with a pointer. Use the Increment or Decrement buttons to scroll through the IPL types.
14
Function/data 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 1 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Action or description Press Enter to select the IPL type and exit function 02. Use the Increment or Decrement buttons to scroll through the control panel functions.
The following table shows the sequence used to select the IPL type and IPL speed on systems that are turned off. Function 02 - Select IPL type and IPL speed on turned-off systems with a keystick
Function/Data 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ A < _ _ _ _ _ _ V _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Action or Description Use Increment or Decrement buttons to scroll to function 02. Press Enter to start function 02: v The current IPL type is displayed with a pointer. v The current IPL speed is displayed. 0 2 _ _ B < _ _ _ _ _ _ V _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ B _ _ _ _ _ _ _ V _ < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Use the Increment or Decrement buttons to scroll through the IPL types and speeds. Press Enter to select the IPL type. v The current IPL type is displayed. v The current IPL speed is displayed with a pointer. 0 2 _ _ B _ _ _ _ _ _ _ S _ < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 1 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Use the Increment or Decrement buttons to scroll through the IPL speeds. Press Enter to select the IPL speed and exit function 02. Use the Increment or Decrement buttons to scroll through the control panel functions.
Function 02 without a keystick - Select IPL type, IPL speed override, and Logical key mode (on Systems without a Keystick) You can use function 02 in either normal mode or manual mode. With the system either turned on or off, this function allows you to select the IPL type and logical key mode. Before you can select the IPL speed override, you must turn off the system. Turned-on systems For turned-on systems without a keystick, function 02 is used to select the IPL mode and logical key mode. The following table shows an example of the function 02 IPL type and logical key mode selection sequence for a turned-on system that does not have a keystick. Function 02 - Select IPL type and logical key mode on turned-on systems without a keystick
Function/data 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Action or description Use the Increment or Decrement buttons to scroll to function 02.
Control panel
15
Function/data 0 2 _ _ A < _ M _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Action or description Press Enter to start function 02. v The current IPL type is displayed with a pointer. v The current logical key mode is displayed. Use the Increment or Decrement buttons to scroll through the IPL types. Press Enter to select the IPL type. Use the Increment or Decrement buttons to scroll through the logical key modes. Press Enter to select the logical key mode and exit function 02. Use the Increment or Decrement buttons to scroll through the control panel functions.
Turned-off systems For turned-off systems without a keystick, function 02 is used to select the IPL type, logical key mode, and IPL speed indicators. The following table shows an example of the function 02 IPL type, logical key mode, and IPL speed selection sequence for a turned-off system that does not have a keystick. Function 02 - Select IPL type, logical key mode, and IPL speed on turned-off systems without a keystick
Function/data 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ A < _ M _ _ _ _ V _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Action or description Use the Increment or Decrement buttons to scroll to function 02. Press Enter to start function 02. v The current IPL type is displayed with a pointer. v The current logical key mode is displayed. v The current IPL speed is displayed. 0 2 _ _ B < _ M _ _ _ _ V _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ B _ _ M < _ _ _ V _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Use the Increment or Decrement buttons to scroll through the IPL types. Press Enter to select the IPL type. v The current IPL type is displayed. v The current logical key mode is displayed with a pointer. v The current IPL speed is displayed. 0 2 _ _ B _ _ N < _ _ _ V _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ B _ _ N _ _ _ _ V _ < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Use the Increment or Decrement buttons to scroll through the logical key modes. Press Enter to select the logical key mode. v The current IPL type is displayed. v The current logical key mode is displayed. v The current IPL speed is displayed with a pointer. 0 2 _ _ B _ _ N _ _ _ _ S _ < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Use the Increment or Decrement buttons to scroll through the IPL speeds.
16
Function/data 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 1 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Action or description Press Enter to select the IPL speed and exit function 02. Use the Increment or Decrement buttons to scroll through the control panel functions.
Function 03 - Start IPL The system enables function 03 only when the key mode is Manual and the system is turned on. This function starts an IPL of the selected IPL type when you press the Enter button. The system will load all the Licensed Internal Code. Attention: No system shutdown is performed before the initial program load (IPL). The use of this function can cause data loss. Function 04 - Lamp Test This function shows whether any control panel indicators are burned out and whether characters that are displayed on the control panel Function/Data display are valid. When you activate this test, all the control panel lights and indicators flash on and off. The lamp test continues on the system control panel until you perform another control panel function or a power procedure. The lamp test for the expansion unit control panel is active for 25 seconds and does not flash. Use this procedure to verify that the lights on the system control panel are working correctly. If you cannot complete these steps, contact your service provider. 1. Turn on the system. 2. Press the Increment or Decrement buttons on the control panel to display function 04. Press Enter on the control panel. 3. Do all of the lights and indicators on the system control panel flash on and off?
Yes No Proceed to the next step. Need to exchange the control panel or the replaceable unit that contains the control panel function (system unit backplane (MB1) or tower card (CB1)). Contact your service provider.
4. Do all the control panel lights on the expansion unit come on?
Yes No End. Exchange the control panel on the expansion unit.
The lights on the system control panel are working correctly. Function 05 - SPCN SRC Function 05 displays information about power faults and provides informational reference codes during disk-unit concurrent maintenance procedures. The format for this function is as follows: SPCN SRC formats
Control panel
17
Function 07 Function 07 is only used during service by authorized IBM service representatives. Function 08 - Fast Turn Off Function 08 is enabled only when the key mode is Manual and the system is turned on. Use this function when the system is suspended and you cannot perform a turn-off operation. The first time that you select function 08 and press Enter, the system displays an attention SRC, 11 A1xx 8008. This SRC indicates that you selected Function 08. The second time that you select function 08 and press Enter, you confirm the request to turn off. To perform a fast turn off, see Stopping the system. Attention: No system shutdown is performed before the initial program load (IPL). The use of this function can cause loss of data. Attention: If the system password was changed at the most recent IPL, performing a fast turn off might cause that new password information to be lost. Functions 09 to 10 - Reserved These functions are reserved for future control panel operations. Functions 11 to 19 - System Reference Code (SRC) Functions 11 though 19, if enabled, represent the words of the SRC. You must record SRC information for error reporting and contact your service provider. Function 20 - System type, model, feature code, hardware level, and IPL path description This function displays the machine type, model, processor feature code, hardware level, and IPL path description in the following format:
t m m m c c c c _ _ _ _ _ _ _ _ h h h h _ _ _ _ i i i i i i i i
18
9406
Values for iiiiiiii indicate the description of the system turn on or restart path:
iiiiiiii The restart path description (for example, 00 000 001 indicates that the system was turned on by using the white button on the control panel).
You should record this information with the SRC. Function 21 - Make DST Available This function makes DST available on the system console display. The Use Dedicated Service Tools (DST) display appears on the primary or alternative console. To exit DST and return to the operating system, select the Resume operating system display option on the Use Dedicated Service Tools (DST) display. Function 22 - Dump Main Storage This function dumps main storage and processor data to the disk. Note: Before to pressing function 22, determine whether function 34 is available ( 00 shows in the panel after you select function 34). If it is available, then the system is attempting to run a main storage dump IPL. Using function 34 attempts to try the IPL again, such that the original dump is not lost. If function 34 is not enabled, ( >FF shows in the panel after you select function 34), go back and start function 22. The first time that you select function 22 and press Enter, the system displays attention SRC 11 A1xx 3022. This indicates that you selected function 22. To dump main storage and system processor data to the disk, you must select function 22 again and press Enter. Use this function only when a main storage dump is necessary, for example, after a suspended (system hang) condition or after an operating system failure. Attention: No system shutdown is performed before the main storage dump. The use of this function can cause data loss. Functions 25 and 26 - Service Switches 1 and 2
Control panel
19
In function 25, the service representative switch 1 is set. Function 25 is the first step necessary to set the service function range (50 to 99). In function 26, the service representative switch 2 is set. Function 26 is the second step necessary to set the service function range (50 to 99). Function 33 - Reorder SPCN Addressing This function puts the rack addresses in the correct order to show their position in the system power control network (SPCN). Use it when you have added racks to or removed them from the system. Function 34 - Retry MSD IPL Function 34 is enabled only for main storage dump (MSD) IPLs. You can use it when the system is hung during the MSD IPL to try the IPL again without losing the original dump information. Related reference Stopping the system
20
5. As the subfunction number is displayed, press Enter. The system displays the data associated with the new subfunction number. 6. Repeat these steps to gather all the data that is associated with the subfunction. 7. Use the Increment or Decrement button to return to the function display with asterisks; for example 57**. 8. Press Enter to exit the subfunctions. Function 50 - System Processor Stop This function stops the system processor. Attention: This function might cause the system to end abnormally. Use it only when directed by your next level of support. Function 51 - System Processor Status This function displays the following values: v Next instruction address (NIA). v Current task dispatching element (TDE) address. The data can be displayed 8 digits at a time. Select and enter a subfunction number to display each word of data from 00 to 0F. The following table is an example of a subfunction data display that shows NIA and TDE information. Subfunction data display example
Function 51 51 51 Subfunction ** 00, 01 02, 03 Data Display Subfunction mode entered NIA (8 bytes) Current TDE (8 bytes)
Function 52 - System Processor Start This function starts the system processor (after it has stopped). Function 53 - Repeat GARD This function displays the following values: v Clear memory, processor, L3 Repeat GARD. v Enable memory, processor, L3 Repeat GARD. v Disable memory, processor, L3 Repeat GARD. v View enable/disable status. This function permanently unconfigures an intermittently failing processor, during the IPL following the failure. This is performed in case the IPL diagnostics cannot detect the failure and automatically unconfigure it. The failing processor must be replaced or the Repeat GARD function must be cleared before that processor can be used again. Attention: This function can cause an operating processor to be permanently unconfigured following a power failure. Use it only when directed by your next level of support.
Control panel
21
The following table is an example of a subfunction data display that shows Repeat GARD information. Subfunction data display example
Function 53 53 53 53 53 Subfunction ** 00 01 02 03 Data Display Subfunction mode entered Clear memory, processor, L3 Repeat GARD Enable memory, processor, L3 Repeat GARD Disable memory, processor, L3 Repeat GARD View enable/disable status (E=Enabled, D=Disabled)
22
disk unit IOP reset/reload. The function is enabled only when specific SRCs are displayed on the control panel and the associated IOP supports a reset/reload function. Function 68 - Turn off Disk Unit IOP/IOA Power Domain Function 68 is enabled only by specific disk-unit system reference codes (SRCs) such as disk-unit attention SRCs. Function 69 - Turn on Disk Unit IOP/IOA Power Domain Function 69 is enabled when the power domain is turned off. Function 70 - Dump Service Processor Control Storage This function saves the contents of the service processor control storage into nonvolatile storage for potential use from an error log.
Your program needs to interpret the byte stream that is sent back from the system. The returned byte stream consists of a predefined format, which is the same for all commands. The byte stream is at least 4 bytes long. Some commands return additional bytes. The first 2 bytes (0 and 1) will return the command status, typically successful or unsuccessful. The next 2 bytes (2 and 3) will be a 16-bit number N, which tells how many additional bytes will follow these first 4 bytes. If N is nonzero, then there will be additional information in bytes 4 through 4 + N. This information will be additional data related to the command, such as TRUE or FALSE. Note: If the command sent is not one of the command strings defined below, then the return code in bytes 0 and 1 of the return value will be 32 (0x20). This means Command not Supported. Your programs can perform the following control panel functions by using the following APIs.
23
24
IPL-related APIs
You can use these APIs to set initial program load (IPL) modes, types, and speed, and to start an IPL.
Control panel
25
26
Starting an IPL
To start a system initial program load (IPL), you can use the StartIPL API (use the uppercase and lowercase shown).
Control panel
27
To use this command, follow these instructions: v You must insert a key to use this command (on systems with a keystick). v The system must be in Manual mode. v You must turn on the system. This API returns the following information:
Bytes 0 and 1 16-bit return code 0 = Command successful 1 = Command unsuccessful 2 = Key not inserted 4 = Not in Manual mode 16 = System turned Off Bytes 2 and 3 16-bit additional data length N = 0 Bytes 4 through 4+N Not applicable
28
Control panel
29
30
Is CPM present?
You can use the GetCPMPresent API to find out if the continuously powered main storage (CPM) is present on the system (use the uppercase and lowercase characters as shown). There are no restrictions to the use of this command. This API returns the following information:
Bytes 0 and 1 16-bit return code 0 = Command successful 1 = Command unsuccessful Bytes 2 and 3 16-bit additional data length N N = size of ASCII return value (does not count end of string NULL) Bytes 4 through 4+N True or False
Is CPM enabled?
You can use the GetCPMEnabled API (use the uppercase and lowercase characters as shown) to find out if the system has continuously powered main storage (CPM) enabled. There are no restrictions to the use of this command. This API returns the following information:
Bytes 0 and 1 16-bit return code 0 = Command successful 1 = Command unsuccessful Bytes 2 and 3 16-bit additional data length N N = size of ASCII return value (does not count end of string NULL) Bytes 4 through 4+N True or False
Control panel
31
Is SPCN present?
You can use the GetSPCNPresent API (use the uppercase and lowercase characters as shown) to find out if the system powered control network (SPCN) is present on the system. There are no restrictions to the use of this command. This API returns the following information:
Bytes 0 and 1 16-bit return code 0 = Command successful 1 = Command unsuccessful Bytes 2 and 3 16-bit additional data length N N = size of ASCII return value (does not count end of string NULL) Bytes 4 through 4+N True or False
32
Control panel
33
34
Appendix. Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the users responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation
Copyright IBM Corp. 2004, 2006
35
Software Interoperability Coordinator, Department YBWA 3605 Highway 52 N Rochester, MN 55901 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. | The licensed program described in this information and all licensed material available for it are provided | by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, | IBM License Agreement for Machine Code, or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights reserved. If you are viewing this information softcopy, the photographs and color illustrations may not appear.
36
Trademarks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: | | | | | i5/OS IBM IBM (logo) iSeries System i Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others.
Appendix. Notices
37
38
Printed in USA