Collecting System Hardware Information for Troubleshooting System Plan Creation Issues

Resolving The Problem

There can be issues with creating a system plan if the hardware information that the system plan creation process uses is stale or incorrect. When this is suspected, IBM Support may require hardware reports from the affected partition to help debug. This document gives directions for collecting the following hardware reports:

o Hardware Inventory.xls
o Hardware.xml
o Rack Configuration


Hardware Inventory.xls File

From the iSeries command line, run a fresh inventory collection by doing the following:

1.	Issue the GO SERVICE command.
2.	Select Option 2 and accept the defaults.
3.	After 10 minutes or so, check GO SERVICE, Option 5, *LOCAL, and ensure that the Last Send Date for HARDWARE is today's date.
4.	In iSeries Navigator, you should do the following: a. Go to Management Central: b. Select Endpoints c. Right click your mouse d. Select Inventory e. Select Collect f. Select Hardware g. Under Management Central: h. Select Endpoints i. Right click your mouse j. Select Inventory k. Select Export l. Select Hardware m. Name the resulting file HardwareInventory.xls. Place it in a PC drive path that you can locate so you can send the file in.

Hardware.xml File

The command to generate this file involves entering the system name as it is recorded in the endpoint list. It can either show up as the system short name (for example, S1011111), long name (for example, S1011111.mycompany.com), or IP address (for example, 192.168.xxx.xxx). The correct format must be used to make this command work.

To determine the right value to use for 'system name', check the object that stores the inventory data:

CHGJOB CCSID(37)
STRSQL
SELECT SYSTEM FROM QMGTC/QAYIVDTA GROUP BY SYSTEM

Next, look through all systems in the result until the target system is found. The format used here is the correct format to use in the command. If the value is a short name or long name, you should pay attention to the character case. The next CALL command is case-sensitive.

CALL PGM(QSYS/QYPSCONFIG) PARM('QYIV_DUMP_XML' 'system name' 'Hardware') <=== case-sensitive

Note: If an incorrect value is used for 'system name', an error similar to the following will be displayed:
Application error.  CPF3CF2 unmonitored by QYPSMISC at statement 0000000013, instruction X'0000.

The resulting file, called Hardware.xml, can be found in the following IFS path:

/QIBM/UserData/OS400/MGTC/service/

You can use iSeries Navigator to easily drag and drop this file onto your PC desktop in order to send it to a Support representative:

1.	Select File Systems
2.	Select Integrated File System
3.	Select root
4.	Select QIBM
5.	Select UserData
6.	Select OS400
7.	Select MGTC
8.	Select Service
9.	Copy and paste the Hardware.xml file to your PC.

Rack Configuration Reports

To generate a Rack Configuration report, you should do the following:

1.	Issue the STRSST command.
2.	Select Option 1. Start a service tool.
3.	Select Option 7. Hardware service manager.
4.	Press F6 Print configuration o Print three times, each time selecting a different option for Information Printed so that a copy of all three results is received.
5.	Press F3 twice to return to the Main menu of System Service Tools (SST).
6.	Select Option 1. Start a service tool.
7.	Select Option 4. Display/Alter/Dump.
8.	Select Option 2. Dump to printer.
9.	Select Option 2. Licensed Internal Code (LIC) data.
10.	Page down.
11.	Select Option 14. Advanced analysis.
12.	Under Option, insert 1 and for command type IOHRIDEBUG, and press Enter. For Options, type -snapshot , and press Enter. Specify a Dump title, or leave it blank, and press Enter.
13.	Under Option, insert 1 and for command type HRIFR , and press Enter. For Options, type -all, and press Enter. Specify a Dump title, or leave it blank, and press Enter.
14.	Press F12 four times to return to the Display/Alter/Dump Output Device menu.
15.	Select Option 7. Display dump status. [Dump requests not complete must be 0 (zero) or F5 until 0 (zero)]
16.	View the report(s) that were generated by issuing the WRKJOB command from the command line and selecting Option 4. Use iSeries Navigator to find the report(s) (My Connections -> your system -> Basic Operations -> Printer Output). Then, drag and drop them to the PC, and send them to your Support representative.