Rserver: Control Panel
Rserver: Control Panel
Rserver: Control Panel
iSeries
Control panel
Version 5 Release 3
ERserver
iSeries
Control panel
Version 5 Release 3
Note Before using this information and the product it supports, be sure to read the information in Notices, on page 25.
Second Edition (August 2005) This edition applies to version 5, release 3, modification 0 of IBM Operating System/400 (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 1998, 2005. 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
Print this topic . . . . . . . . . . . . . . 1 Control panel concepts . . . . . . . . . . . 2 Types of control panels . . . . . . . . . . 2 Control panel functions . . . . . . . . . . 4 Control panel buttons, lights, and indicators . . . 7 Set up your control panel . . . . . . . . . . 9 Access control panel functions . . . . . . . . 10 Instructions and descriptions for control panel functions . . . . . . . . . . . . . . . 11 Normal control panel functions . . Extended control panel functions . Low-level debug panel functions 57 Use remote control panel APIs . . . . . . . . . through . . . . . 12 . . 19 70 21 . . 22
Appendix. Notices . . . . . . . . . . 25
Trademarks . . . . . . . . . . . . . . 26 Terms and conditions for downloading and printing publications . . . . . . . . . . . . . . 27
iii
iv
Control panel
The control panel is your initial interface to your iSeries server. From the control panel, you can process system functions such as the following: v Power on or off the system v Perform an initial program load (IPL) v Display and get attributes or 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 270 and 8xx model servers. If you have a different model server, see the eServer 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. Print this topic Print this entire topic. Control panel concepts This information explains the differences between control panel options. It also provides details about functions that the control panel can perform. Set up your control panel These instructions provide detailed information that you can use to get the remote control panel and the virtual control panel up and running. Access control panel functions This information provides steps that explain how to access the control panel functions. Instructions and descriptions for control panel functions This information describes each control panel function, the uses and procedures for each function, and when you must use each function. Use remote control panel APIs Use these APIs to write a program that can access the control panel remotely. Your program can access many commands and queries using these APIs.
Analyze and report system problems Saving PDF files To save a PDF on your workstation for viewing or printing: 1. Right-click the PDF in your browser (right-click the link above). 2. Click Save Target As... if you are using Internet Explorer. Click Save Link As... if you are using Netscape Communicator. 3. Navigate to the directory in which you need to save the PDF. 4. Click Save. Downloading Adobe Acrobat Reader You need Adobe Acrobat Reader to view or print these PDFs. You can download a copy from the Adobe Web site (www.adobe.com/products/acrobat/readstep.html) .
For information about using the physical control panel see Access control panel functions. See Control panel buttons, lights, and indicators for a description of the interface for the physical control panel.
Control panel
v The service tools user profile used to authenticate the connection must have the Partition remote panel key privilege in order to use the mode function provided by the virtual control panel. To verify that your SST user ID has this privilege, see Change the functional privileges for a service tools user ID using SST. 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.
Virtual control panel 270 800 810 820 825 830 840 870 890 Remote control panel 170 250 6xx 7xx Sxx
For information such as prerequisites, setup instructions, and configuration instructions for the virtual control panel, see the iSeriesTM Access Web site.
For information on using the virtual control panel see Access control panel functions. See Control panel buttons, lights, and indicators for a description of the interface for the virtual control panel.
Function code 01
Function description 1. Displays the currently selected IPL type (and logical key mode on some system types). 2. Displays the currently selected IPL speed override for the next IPL.
02 03
02 03
Yes Yes
Selects the IPL type, logical key mode, and IPL speed. Starts an IPL to load the system. The IPL uses the selected IPL options. Lamp test all displays and indicators will be switched on. System power control network (SPCN) system reference code (SRC). Displays an SRC on the control panel. Allows you to perform SPCN service functions. Fast power off. To perform a fast power off, see Stop the system in the Basic system operations topic. Reserved. System reference code (SRC) displays an SRC on the control panel. Displays the machine type, model, processor feature code, processor class indicator, and IPL path description. Causes the Use Dedicated Service Tool (DST) display to appear on the system console. To exit DST, select the Resume operating system display option. Forces system main storage dump. Reserved. Reserved. Uses Service switches 1 and 2 to enable or disable functions 50 through 70.
04
04
Yes
05
05
No
07 08
Not applicable 08
09 through 10 11 through 19
20
20
Yes
21
21
Yes
22 23 24 25
Control panel
Function code 26
Function description Uses Service switches 1 and 2 to enable or disable functions 50 through 70. Reserved. Reorders SPCN addressing. Retries (MSD) IPL. Reserved. 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. De-configure an intermittently failing processor (Repeat GARD function) Reserved. Displays area addresses for system data. Sets the first character of the base address for the function 62 display. Sets the second character of the base address for the function 62 display. Sets the third character of base address for function 62 display. Sets the fourth character of base address for function 62 display. Displays service processor storage. System status SRC trace. Service processor diagnostic status SRC trace. Deactivates remote service. Activates remote service. Disk unit IOP reset/reload is enabled only by specific disk unit SRCs.
27 through 32 33 34 35 through 49 50 51
Not applicable Yes Yes Not applicable Not applicable Not applicable
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
Virtual control panel Remote control panel code function? 68 69 70 Yes Yes No
Function description Concurrent maintenance power domain Power Off. Concurrent maintenance power domain Power On. Dump service processor control storage. OFF = Delayed power off ON = Immediate power on (can be timed power on)
Power button in graphical Power button in graphical interface for powering interface for powering on and off the server. (LAN off the server only. connected remote control panels cannot power on the server.) 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 server uses a keystick, the mode button works with the same functions as the physical control panel, depending on whether or not 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 customer 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. For more details about the functions, see Instructions and descriptions for control panel functions.
The following figures show: v The remote control panel or virtual control panel v A control panel without a keystick v A control panel with a key stick Remote control panel and virtual control panel
Control panel
Function/Data display Increment and Decrement buttons Power 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
iSeries: Control panel
Physical control panel with a keystick A keystick gives the operator security control over the control panel functions and control over data that is accessible from the control panel. The keystick for the electronic keylock activates the 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 Mode button Electronic Keystick Slot Secure Auto Normal Manual
(B) (C) (D) (E) (F) (G) (H) (J) (K) (L) (M) (N)
Control panel
v You are required to have a special remote control panel cable to support your configuration. See Installing Operations Console cables for specific requirements. v A local console through dial-up support does not support the remote control panel functions. A remote console through dial-up support only supports the remote control panel functions if the local console it connects to has the cable installed and configured.
Set up your virtual control panel The iSeriesTM Access web site has specific set up instructions for setting up your virtual control panel. You must have a local console directly attached to the server configured in order for the virtual control panel to function. In order to set up a local console directly attached to the server configuration, you will need to follow the set up instructions in Operations Console. The use of virtual control panel functions has some limitations and restrictions so be sure to look at those in the installation instructions. See Troubleshoot Operations Console connections for information on troubleshooting the remote control panel or virtual control panel.
10
This graphic shows these items on the control panel: v Power On Indicator v Power pushbutton v System Attention light v Function/Data display v Increment and Decrement buttons v Enter pushbutton v Mode selector v Electronic keystick slot
11
Low-level debug panel functions These are functions 57 through 70 and must only be performed by support 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.
The following topics have detailed information and instructions to use the control panel functions: v Normal control panel functions v Extended control panel functions v Low-level debug panel functions
Yes No
Go to the next step. The system displays the IPL key mode (M or N only). The IPL key modes, Auto and Secure, are not supported. Follow function 01 and 02 procedures for system without a keystick.
2. Insert the keystick. Press the Mode-selection 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 (V) 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.
12
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 M and N. 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 make selection changes to IPL types with the system powered on or off. However, to select the IPL speed override, you must power off the system. The following table shows the sequence used to select the IPL type on iSeriesTM servers that are powered on. Function 02 selects IPL type on powered-on systems with a keystick
Function/data 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ A < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 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.
Control panel
13
Function/data 0 2 _ _ B < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 1 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Action or description Use the Increment or Decrement buttons to scroll through the IPL types. 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 iSeries 400 systems that are powered off. Function 02 selects IPL type and IPL speed on powered-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 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 powered 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 power off the system. Powered-on systems For powered-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 powered-on system that does not have a keystick. Function 02 selects IPL type and logical key mode on powered-on systems without a keystick
Function/data 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Action or description Use the Increment or Decrement buttons to scroll to function 02.
14
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.
Powered-off systems For powered-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 powered-off system that does not have a keystick. Function 02 selects IPL type, logical key mode, and IPL speed on powered-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 _ < _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 0 2 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Use the Increment or Decrement buttons to scroll through the IPL speeds. Press Enter to select the IPL speed and exit function 02.
Control panel
15
Function/data 0 1 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Action or description 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 in manual and the system power is 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: The system does not perform a system shutdown before the IPL. The use of this function can cause loss of data. 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. Power on the system. 2. Press the Increment (^) or Decrement (V) 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:
16
Function 07 Function 07 is only used during service by authorized IBM service representatives. Function 08-Fast Power Off Function 08 is enabled only when the key mode is in manual mode and the system power is on. Use this function when the system is suspended and you cannot perform a power down. 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 power off. To perform a fast power off, see Stop the system in the Basic system operations topic. Attention: No system shutdown is performed before the 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 power 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
Control panel
17
4 6
9404 9406
Values for iiiiiiii indicate the description of the system power on or restart path:
iiiiiiii The restart path description (for example, 00000001 indicates that the system was powered 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 loss of data. Functions 25 and 26-Service Switches 1 and 2
18
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 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.
19
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 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 v v v Clear memory, processor, L3 repeat GARD Enable memory, processor, L3 repeat GARD Disable memory, processor, L3 repeat GARD View enable/disable status
This function permanently de-configures an intermittently failing processor, during the IPL following the failure. This is performed in case the IPL diagnostics cannot detect the failure and automatically de-configure 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 a good processor to be permanently de-configured following a power failure. Use only when directed by your next level of support.
20
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)
Control panel
21
Function 67 - Disk Unit IOP Reset/Reload. Function 67 is not available for all system types. Use this function to initiate an IOP dump and a 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 - Power 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 - Power on Disk Unit IOP/IOA Power Domain. Function 69 is enabled when the power domain is powered 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 will need to interpret the byte stream sent back from the server. The returned byte stream consists of a predefined format which is the same for all commands. The byte stream will be at least 4 bytes long. Some commands will return additional bytes. The first two bytes (0 and 1) will return the command status, typically successful or unsuccessful. The next two 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. System power and test APIs: v Power on the system (PowerOn) v Perform panel lamp test (DoLampTest) v Clear panel lamp test (ClearLampTest)
22
v Power off the system (PowerOff) IPL-related APIs: v Set IPL mode to manual (SetIPLModeManual) v Set IPL mode to normal (SetIPLModeNormal) v Set IPL mode to auto (SetIPLModeAuto) v Set IPL mode to secure (SetIPLModeSecure) v Set IPL type to A (SetIPLTypeA) v v v v v v v Set IPL type to B (SetIPLTypeB) Set IPL type to C (SetIPLTypeC) Set IPL type to D (SetIPLTypeD) Start an IPL (Start IPL) Set IPL speed to fast (SetIPLSpeedFast) Set IPL speed to slow (SetIPLSpeedSlow) Set IPL speed to system default (SetIPLSpeedDefault)
Other system function APIs: v Start dedicated service tools (DST) on the primary or alternative console (StartDST) v Start a main storage dump (StartMSD) v Disable continuously powered main storage (CPM) (DisableCMP) APIs that question system status: v Is CPM present? (GetCPMPresent) v Is CPM enabled? GetCPMEnabled v Is the key inserted? (GetKeyInserted) v Is the power on? (GetPowerOn) v Is the attention light lit? (GetAttentionLight) v Is system powered control network (SPCN) present? (GetSPCNPresent) v Get the IPL mode (GetIPLMode) v Get the IPL type (GetIPLType) v Get the IPL speed (GetIPLSpeed) v Get type information and model information (GetType&Model) v Get the SPCN SRC if available (GetSPCNSRC) v Get all SRCs 1 - 9 if available (GetSRCs)
Control panel
23
24
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 give you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing IBM Corporation 500 Columbus Avenue Thornwood, NY 10594-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, 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. 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
Copyright IBM Corp. 1998, 2005
25
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. All statements regarding IBMs future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBMs suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. 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. If you are viewing this information softcopy, the photographs and color illustrations may not appear. The drawings and specifications contained herein shall not be reproduced in whole or in part without the written permission of IBM. IBM has prepared this publication for use by hardware service representatives in the maintenance or repair of the specific machines indicated. IBM makes no representations that it is suitable for any other purpose. The drawings and specifications contained herein shall not be reproduced in whole or in part without the written permission of IBM. IBM has prepared this publication for use by customer personnel for operating and planning for the specific machines indicated. IBM makes no representations that it is suitable for any other purpose.
Trademarks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: Application System/400 AS/400 e (logo) IBM iSeries Operating System/400 OS/400 400 Lotus, Freelance, and WordPro are trademarks of International Business Machines Corporation and Lotus Development Corporation in the United States, other countries, or both.
26
C-bus is a trademark of Corollary, Inc. in the United States, other countries, or both. ActionMedia, LANDesk, MMX, Pentium, and ProShare are trademarks or registered trademarks of Intel Corporation in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. SET and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product or service names may be trademarks or service marks of others.
Appendix. Notices
27
28
Printed in USA