Service functions

Service functions provides enough detail for the service provider to gather information about hardware problems while under the direction of the next level of support.

This information provides basic information about some of the service functions that are commonly used by authorized service providers.

Before using this information, you should know how to service this particular hardware model. You must also know how to safely work with electrical components.

Attention: Misuse of service tools or using them with inappropriate security safeguards might result in loss of data, programs, or other objects on the system.

Hardware SRC formats

SRC format examples.

Notes:
  1. Other formats exist; if necessary contact your next level of support.
Table 46. SRC format examples
SRC Word Number Panel function, digits x to y (from left to right) IOP SRC format 13 IOP SRC format 17 Device SRC format 27 IOP detected a failure format 29 LIC SRC Format 60 LIC SRC format 61 LIC SRC format 62 LIC SRC format 63
1 11, 1-8 TTTT RRRR TTTT RRRR tttt rrrr B0XX RRRR A6xx RRRR B6xx RRRR B6xx RRrr or B7xx Rrrr A600 RRRR
2 12, 1-8 MIGV EP13 MIGV EP17 MIGV EP27 MIGV EP29 MIGV EP60 MIGV EP61 MIGV EP62 MIGV EP63
3 12, 9-16 BBBB Ccbb BBBB Ccbb BBBB Ccbb BBBB Ccbb PPPP 0000 cccc cccc cccc cccc AAAA BBBB
4 12, 17-24 aaaa aaaa aaaa aaaa aaaa aaaa SAPP UUFF BBBB Ccbb pppp pppp pppp pppp CCCC DDDD
5 12, 25-32 TTTT LMMM TTTT LMMM tttt lmmm TTTT FMMV aaaa aaaa qqqq qqqq qqqq qqqq EEEE FFFF
6 13, 1-8 uuuu uuuu tttt lmmm TTTT LMMM tttt lmmm tttt mmmm qqqq qqqq qqqq qqqq GGGG HHHH
7 13, 9-16 uuuu uuuu ZZZZ rrrr ZZZZ RRRR zzzz rrrr ssss ssss 0000 0000 BBBB Ccbb JJJJ KKKK
8 13, 17-24 uuuu uuuu ssss ssss ssss ssss 0sss ssss NNNN 0000 0000 0000 TTTT MMMM TTTT 0MMM
9 13, 25-32 uuuu uuuu uuuu uuuu uuuu uuuu uuuu uuuu 0000 0000 0000 0000 0000 0000 SSSS SSSS
Table 47. SRC format examples (continued)
SRC format Description
AAAA Type of I/O Bus (see Logical address format -- field 'A').
aaaa Unit address.
BBBB System Bus Number (see Logical address format -- field 'B').
BBBBCcbb Bus, bus, bus, bus, card, card, and board, board address (Direct Select Address or DSA).
  • For PCI system buses 0001-0003 and 0018-FFFF the Cc field is a one digit multi-adapter bridge number and a one digit multi-adapter bridge function number.
  • For SPD system buses 0004-0017 the Cc field is a two digit card number.
CCCC System Board Number (see Logical address format -- field 'C').
cccc cccc Component reference code. Format 62 varies by component.
DDDD System Card Number (see Logical address format -- field 'D').
EEEE (see Logical address format -- Unit Address type -- field 'E').
FFFF (see Logical address format -- Unit Address type -- field 'F').
GGGG (see Logical address format -- Unit Address type -- field 'G').
HHHH (see Logical address format -- Unit Address type -- field 'H').
JJJJ (see Logical address format -- Unit Address type -- field 'J').
KKKK (see Logical address format -- Unit Address type -- field 'K').
LMMM Level indicator plus 3" digit model number (for example, 0001).
lmmm Level indicator plus 3" digit model number of failing device.
0MMM Model number of failing device (i.e. MMM='001').
MIGV EP General system status.
NNNN Number of disk device facilities that are missing.
PPPP Cause code.
pppp pppp Programming reference code.
qqqq qqqq Programming reference code qualifier.
RRRR Unit reference code (URC).
rrrr Outboard failing unit reference code (URC).
SAPP UUFF Unit address.
SSSSSSSS System Reference Code -- this SRC is used to determine why the primary console failed to respond.
ssss Serial number of failing unit.
TTTT Type number or card identification number (hex).
tttt Outboard failing unit type number (i.e. 6607).
uuuu Unit-specific data.
ww SRC type.
ZZZZ Reserved.

Hexadecimal Product Activity Log data

Use the Display Hexadecimal Report Function or follow the steps below to display hexadecimal error log dump data.

Perform the following:

  1. Find an entry in the Product Activity Log for the symptom (SRC) you are using to locate the problem.
    1. Select System Service Tools (SST).

      If you cannot get to SST, select DST.

      Note:
      Do not IPL the system to get to DST.
    2. On the Service Tools display, select the Start a service tool option.
    3. Select the Product activity log option on the Start a Service Tool display.
    4. Select the Analyze log option on the Product Activity Log display.
    5. On the Select Subsystem Data display, select the option to view All Logs.
      Note:
      If the SRC you are using occurred more than 24 hours ago, change the "From:" and "To:" Dates and Times from the 24-hour default.
    6. Use the defaults on the Select Analysis Report Options display by pressing the Enter key.
    7. Find the entry in the Product Activity Log that matches that SRC.
  2. Select the Display Detail Report for Resource display. (See the example of this display below.)
    Figure 46. Example Hexadecimal Detail Report for Resource
    Display Detail Report for Resource
     
                                            Serial                  Resource
    Name              Type      Model       Number                  Name
    STORAGE           6512      001         10-4294009              SI05
     
    Log ID  . . . . . . . . . :   06020132   Sequence . . . . . . . :         2248
    Date  . . . . . . . . . . :   05/20/95   Time . . . . . . . . . :   08:37:55
    Reference code  . . . . . :   3400       Secondary code . . . . :   00000000
    Table ID  . . . . . . . . :   65120001   IPL source/state . . . :   B/7
     
    Class . . . . . . . . . . :   Permanent
    System Ref Code . . . . . :   65123400
    I/O processor card detected device error
     
     
     
     
     
    Press Enter to continue.
     
    F3=Exit                                                  F6=Hexadecimal report
    F9=Address Information             F10=Previous detail report       F12=Cancel
  3. Press F6 to display the hexadecimal report.

    The direct select address (DSA) is in the format BBBB-Cc-bb:

    Figure 47. Example Hexadecimal Report for Resource
    Display Hexadecimal Report for Resource
     
                                            Serial                  Resource
    Name              Type      Model       Number                  Name
    STORAGE           6512      001         10-4294009              SI05
     
    Offset          0 1 2 3  4 5 6 7  8 9 A B  C D E F    EBCDIC
    000000          C5D3F0F4 00000160 00E00180 77B7695E   EL04...-.......;
    000010          E8A70000 000008C8 20E00602 01320000   Y......H........
    000020          34000000 11000000 00000000 009C0000   ................
    000030          F6F5F1F2 F0F0F140 F1F060F4 F2F9F4F0   6512001 10-42940
    000040          F0F9F6F5 F1F20000 00000001 00060000   096512..........
    000050          00020000 FFFFFFFF FFFFFFFF FFFF0000   ................
    000060          00000000 00000000 00000000 F4404040   ............4
    000070          40000000 00000000 00000000 00000000    ...............
    000080          00000000 00000000 00000000 00000000   ................
    000090          00000000 00000000 00000000 00000000   ................
    0000A0          00000000 00000000 00000000 00000000   ................
    0000B0          00000000 00000000 40404040 40404040   ........
    More...
    Press Enter to continue.
     
    F3=Exit        F12=Cancel
     
  4. Is offset 170 - 173 = 00000000?
  5. Page forward until you locate the offset location X'000180'.

    For systems with Licensed Internal Code V5R4M0 or earlier, the unit address is hexadecimal offset 18C through 18F.

    For systems with Licensed Internal Code V5R4M5 or later, the unit address is hexadecimal offset 192 through 195.

    Record this address information. Return to the procedure that sent you here, if one.

    Figure 48. Hexadecimal Report for Resource Offset Location Example (for systems with Licensed Internal Code V5R4M0 or earlier)
    Display Hexadecimal Report for Resource
     
                                            Serial                  Resource
    Name              Type      Model       Number                  Name
    STORAGE           6512      001         10-4294009              SI05
     
    Offset          0 1 2 3  4 5 6 7  8 9 A B  C D E F    EBCDIC
    000180          D0007800 65120001 34000620 1100FFFF   }...............
    000190          FFFFFFFF 31090000 00001100 03C00000   .............{..
    0001A0          00000000 00000000 00000000 00000000   ................
    0001B0          00000000 00000000 00000000 00000000   ................
    0001C0          00000000 00000000 00000000 E0000008   ................
    0001D0          00000000 00000000 00000000 00000000   ................
    0001E0          00000018 00000002 E00401F0 10002000   ...........0....
    0001F0          00000000 40000000 00000000 000002CC   .... ...........
    000200          CCCC0000 00000000 00800000 00000000   ................
    000210          08100000 00000000 F0200040 00800000   ........0.. ....
    000220          00000000 04000000 08000040 E000E221   ........... ..S.
    000230          800084F3 00000002 0000001B 110003C0   ...3...........{
    More...
    Press Enter to continue.
     
    F3=Exit        F12=Cancel

    Figure 49. Hexadecimal Report for Resource Offset Location Example (for systems with Licensed Internal Code V5R4M5 or later)
    Display Hexadecimal Report for Resource
    
    Serial                  Resource
    Name              Type      Model       Number                  Name
    STORAGE           571A      001         10-4294009              DC01
     
    Offset          0 1 2 3  4 5 6 7  8 9 A B  C D E F    EBCDIC
    000180          F8407200 F5F7F1C1 F0F0F0F1 3400031D   8 ..571A0001....
    000190          00233104 00FFFFF4 F0F0F0F0 F0F0F0F0   .......400000000
    0001A0          1104E255 F0F0F0F0 F0F0F0F0 40404040   ..S.00000000
    0001B0          40404000 00FF0000 04440000 A1D0038D      ..........}..
    0001C0          0713000C 00000000 00000000 70000200   ................
    More...
    
    Press Enter to continue.
     
    F3=Exit        F12=Cancel
  6. Using hexadecimal arithmetic, add the value in offsets 170 - 173 to the value in offsets 174 - 177. For example, 000001C8 + 00000410 = 000005D8

    For systems with Licensed Internal Code V5R4M0 or earlier: Using hexadecimal arithmetic, add 0000000C to this value, and this will be the location of the unit address in the form abcdefgh. For example, 00005D8 + 0000000C = 000005E4

    For systems with Licensed Internal Code V5R4M5 or later: Using hexadecimal arithmetic, add 00000012 to this value, and this will be the location of the unit address in the form abcdefgh. For example, 00005D8 + 00000012 = 000005EA

    Record this address information. If you were sent here by another procedure, return to the procedure that sent you here.

    This ends the procedure.

LIC-Detected Problem Reference Code Formats

Reference code formats.

Formats 60-63 in Table 46 represent the formats for Licensed Internal Code (LIC) SRCs.

RRRR
LIC unit reference code (URC).
cccc
LIC Component Reference Code (CRC). Identifies the LIC component and subcomponent that generated the SRC.
pppp
LIC Program Reference Code (PRC). Identifies the LIC class or component that generated the SRC and the specific error detected.
qqqq
LIC Program Reference Code Qualifier. SRC words found at functions 15-3 through 19-3 or 15-3 and 16-3, depending on the format, provide additional error isolation information that is specific to the Program Reference Code. One or more of these words may be '0000 0000'. Format 61 has up to 5 words of PRC Qualifier, in words 5-9. The PRC determines the number of PRC qualifer words. The content of words 5-9 is dependent on the value in word 4. Format 62 has the PRC qualifier ONLY in words 5-6; there is physical address and type information in words 7-9.
BBBB Ccbb
Bus/Card/Board identifiers of failing component (direct select address)
@@@@
Unit address
ssss
Serial number of failing unit
TTTT
Type number or card identification number of failing component (hex 2xxx through 9FFF). May be 0000, if system data is not available at the time the SRC is signaled.
ZZZZ
Reserved
mmmm
Model number of failing component (hex 2xxx through 9FFF). May be 0000, if system data is not available at the time the SRC is signaled.
CCCC
Cause code
NNNN
Number of disk device facilities missing
MIGV EP
General system status (see System Reference Code (SRC) Information for more information.)
x
Any hexadecimal number
Notes:
  1. For information about Function 11 and 12, refer to System Reference Code (SRC) Information.
  2. Format 60 may contain data in a format other than that shown. Format 60 is an old VLIC format, which some new LIC components use. It does not have the component reference code and program reference code that format 61 and 62 have (61 and 62 were specifically defined for the new LIC). Format 60 is mostly component-specific with no key information to indicate format (the developer has to interpret it). Refer to Licensed internal code (LIC) isolation procedures and perform the problem isolation procedure used by the reference code to further define any significant data.

Logical address format

Use the logical address to identify the resource entry.

Use the logical address to identify the resource entry. To sort by logical address, select the Analyze log option on the Product Activity Log display. Then select the F9 key (Sort by...) and sort by logical address. For more information on the address, use the address information function.

The logical address format, A/B/C/D-E/F/G/H/J/K, has the following definitions:

A
Type of I/O bus (transport)
B
System bus number
C
System board number (for busses that connect card enclosures)
D
System card (bus unit) number
-
Separates the bus address from the unit address
E
Unit address type
FGHJK
Unit address data

The values of F, G, H, J, and K vary, depending on the unit address type (E). Use the following information to determine the Unit address data (FGHJK) representation.

Table 48. Unit address (E) definitions
Unit Address Value Unit Address Definition Unit Address Data
E F G H J K
0 Reserved - - - - -
1 Communications I/O bus Adapter Port Channel -
2 Storage I/O adapter I/O bus Controller Device -
3 Workstation I/O bus Adapter Port Device Session
4 Auxiliary Processor I/O bus Auxiliary Processor Adapter Port -
5 Library I/O adapter I/O bus Library Controller Device
6 Cryptography I/O bus Adapter Device - -

The Logical address field contains the bus address and the unit address. The bus address describes the hardware bus, board, and card information. The unit address describes the subsystem and identifying data (see Table 48).

Note:
To locate a device or card that is within the system unit, use the physical address information.