OA46953: IEA031I MESSAGE ISSUED WITH INCORRECT ALERT CODE 01 WHEN AN STP TIMING LINK WAS LOST MOMENTARILY. ALSO REFER TO INFO II14773.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• IEA031I STP ALERT RECEIVED.  STP ALERTCODE = 01 issued which
  according to the documentation means 'ETS not in use - an
  External Time Source (ETS) has not been defined for the
  Coordinated Time Network (CTN).'    The message was incorrectly
  issued in this case because the actual alert code received from
  the hardware was Alert code 04 qualifier 01 (i.e. ALERTB
  contained 03030401) indicating a 'timing-only link loss'.  The
  message needs to clearly indicate the actual error.
  EXTERNAL SYMPTOMS:
   IEA031I
  VERIFICATION STEPS:
   1.  Take a dump of Master as close to the incorrect message as
      possible:
       DUMP COMM=(STP PROBLEM)
       R xx,ASID=1,SDATA=(ALLNUC,PSA,CSA,SQA,LPA,SUM,TRT),END
   2.  In IPCS issue:
       IP L 10?+58?+8C?+1DC len(4)
       IP L 10?+58?+8C?+1E8 len(4)
       If the contents of either list command contain xxxx0401
       then an alert code 04  qualifier 01 was received.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Server Time Protocol (STP) users running     *
  *                 at z/OS HBB7790 and above.                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: MSGIEA031I was issued with an STP       *
  *                      alert code 01 due to an STP timing      *
  *                      link that was momentarily lost.  The    *
  *                      alert code was correct, but the         *
  *                      documentation notes a different reason  *
  *                      for STP alert code 01.  STP alert code  *
  *                      01 has multiple meanings, which needs   *
  *                      to be addressed.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The STP alert codes specified in IEA031I are no longer unique.
  They are really STP alert reason codes (or STP alert code
  qualifiers) associated to specific STP alert code conditions.
  
  Additional search keywords:  STP/K
  

Problem conclusion

• Replace IEA031I with new message MSGIEA037I that will display
  both the STP alert code condition and its STP alert reason
  code (or STP alert code qualifier).  The STP alert reason
  code is similar to the alert code that was issued in IEA031I.
  
  IEA031I will still be issued, but only to hardcopy.
  
  IBM recommends to use IEA037I to monitor STP alerts instead of
  IEA031I.
  
  DOCUMENTATION HOLD FOR APAR OA46953
    +-------------------------------------------------------+
  
    o   ORDER NO-  SA38-0673-xx
    o   Book Title- z/OS         MVS System Messages,
                                 Vol 6 (GOS-IEA)
  
  
    MVS System Messages, Vol 6 (GOS-IEA)
  
    +--- LOCATION IN PUBLICATION ---------------------------+
    |                                                       |
    |  IEA Messages                                         |
    |    IEA031I                                            |
    +-------------------------------------------------------+
  
    Add the following to the beginning of the Explanation:
  
  | This message will be supplanted by IEA037I, but will be
  | issued to hardcopy.
  
    Change Routing code to:
  | Note 13
  
  
    +--- LOCATION IN PUBLICATION ---------------------------+
    |                                                       |
    |  IEA Messages                                         |
    |    IEA037I (new, single line message)                 |
    +-------------------------------------------------------+
  
  | IEA037I STP ALERT RECEIVED.  STP ALERT CODE = nn,
  |         REASON = rr
  |
  | Explanation:  This message was received because a change
  |               occurred with respect to the external time
  |               source for the Coordinated Timing Network
  |               (CTN).
  |
  | In the message text:
  |
  | nn - STP Alert code hex value
  |    rr - STP Alert reason code hex value
  |
  | Hex  Meaning
  | 01 - Alert associated with the external time source
  |
     <<For the reason codes (rr) associated with alert code nn=01
  
       Please copy from message IEA031I, hex codes 01-0B,
                                                   10-18,
                                                   20-28>>
  |
  | 02 - Alert associated with the state of the PPS ports
  |
     <<For the reason codes (rr) associated with alert code nn=02
  
       Please copy from message IEA031I, hex codes 81-84>>
  |
  | 04 - A hardware alert has been recognized
  |    Hex  Meaning
  |    01 - A timing only link has gone offline.  These links
  |         are not used for coupling.
  |
  | System action:  The system continues processing.
  |
  | Operator response:  Notify the System Programmer.  The same
  |                     event might occur on all images in the
  |                     Coordinated Timing Network (CTN).
  |
  | System Programmer response:
  |
  | Based upon the alert code/reason code from the message,
  | determine what condition change caused the message.  If
  | appropriate to your installation, correct the condition.
  | For more details on the alert code conditions, see
  | Server Time Protocol Implementation Guide, SG24-7281.
  |
  | Source:  Timer Supervisor
  |
  | Module:  IEATEEIH
  |
  | Routing code:  10
  |
  | Descriptor code:  4
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UA76916 UA76917

Modules/Macros

•    IEATEEIH IEATIMEN IEATIMJP IEATMSGR
  

Fix information

• Fixed component name

  TIMER SUPERVISO

• Fixed component ID

  5752SC1CV

Applicable component levels

• R79J PSY UA76917

     UP15/05/06 P F505

• R790 PSY UA76916

     UP15/05/06 P F505

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.