PH45584: MQ CHINIT SUFFERS 0E0-2B, 102, 0C4 ABENDS WHEN QMGR STARTUP FAILS DUE TO AMS BEING UNAVAILABLE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Due to misconfigured zprms, qmgrs failed to start as the
  product usage had not been set, preventing AMS from starting.
  In this scenario, the MSTR shuts down as SPLCAP is enabled but
  AMS is not allowed to start.
  
  The CHINIT has already begun its start up process from a
  CSQINP2 command.
  
  The CHINIT throws various abends because the MSTR is shutting
  down whilst it is still starting up.
  
  MSTR log:
  
   CSQY024I cpf AMS not started, product usage is not set
   CSQY032E cpf CSQ0ERST QUEUE MANAGER STARTUP
   TERMINATED, UNABLE TO START AMS
   CSQY030E cpf CSQ0DEAD QUEUE MANAGER TERMINATING, AMS NOT
   AVAILABLE
  *CSQV086E cpf    QUEUE MANAGER ABNORMAL TERMINATION
   REASON=00F00003
  ...
   IEF450I XXXXMSTR XXXXMSTR - ABEND=S6C6 U0000 REASON=00F00003
  
  Abends in CHIN:
  
  CSQX001I cpf CSQXJST Channel initiator starting
  
  ...
  
  IEA995I SYMPTOM DUMP OUTPUT
  SYSTEM COMPLETION CODE=0E0  REASON CODE=0000002B
  ...
  PSW AT TIME OF ERROR  077C7000   AC11C8EE  ILC 4  INTC 2B
  
  ACTIVE MODULE           ADDRESS=00000000_2C100000
  OFFSET=0001C8EE
  NAME=CSQXJST
  
  DATA AT PSW  2C11C8E8 - 5820B130  18529101  500CA714
  
  AR/GR 0: 00000000/91000000   1: 00000000/2C11C9FC
  
        2: 00000000/7EAB2000   3: 00000000/01231318
  
        4: 00000000/00000000   5: 010200E5/7EAB2000
  
        6: 00000000/2C140EF0   7: 00000000/010200E5
  
        8: 00000000/7F678840   9: 00000000/7F678840
  
        A: 00000000/00000000   B: 00000000/7F678728
  
        C: 00000000/AC11C4E8   D: 00000000/7F678728
  
        E: 00000000/AC11C8A2   F: 00000000/00000000
  
        END OF SYMPTOM DUMP
  
  XJST ESTAE
  
  IEA995I SYMPTOM DUMP OUTPUT
  
  SYSTEM COMPLETION CODE=0C4  REASON CODE=00000004
  
  ...
  PSW AT TIME OF ERROR  078D3000   AC1037D4  ILC 4  INTC 04
  
  ACTIVE MODULE           ADDRESS=00000000_2C100000
  OFFSET=000037D4
  NAME=CSQXJST
  
  DATA AT PSW  2C1037CE - 00029604  81795870  A18458E0
  
  AR/GR 0: 00000000/00C59585   1: 00000000/00000002
  
        2: 00000000/00000000   3: 00000000/01231318
  
        4: 00000000/00000000   5: 010200E5/7EAB2000
  
        6: 00000000/00000000   7: 00000000/00000000
  
        8: 00000000/00000000   9: 00000000/2C106D30
  
        A: 00000000/2C130788   B: 00000000/2C131787
  
        C: 00000000/00000000   D: 00000000/2C130788
  
        E: 00000000/2C1035E4   F: 00000000/00000000
  
        END OF SYMPTOM DUMP
  IEF450I XXXXCHIN XXXXCHIN - ABEND=S0C4 U0000 REASON=00000004
  
  or
  
  IEA995I SYMPTOM DUMP OUTPUT
  SYSTEM COMPLETION CODE=102  REASON CODE=00000000
  ...
  PSW AT TIME OF ERROR  078C1000   813D292A  ILC 4  INTC 04
  NO ACTIVE MODULE FOUND
  NAME=UNKNOWN
  DATA AT PSW  013D2924 - 2000BA39  6000B20A  00009200
  AR/GR 0: 00000000/00C59584   1: 00000000/00001958
        2: 00000000/00000080   3: 00000000/00000000
        4: 00000000/008F9058   5: 010200E5/008F9790
        6: 00000000/000001A8   7: 00000000/00F65880
        8: 00000000/013D43A8   9: 00000000/40C59584
        A: 00000000/7F6EB228   B: 00000000/7FFFAC40
        C: 00000000/00001960   D: 00000000/2C130788
        E: 00000000/00FE7A00   F: 00000000/00000000
        END OF SYMPTOM DUMP
  
  IEF450I XXXXCHIN XXXXCHIN - ABEND=S102 U0000 REASON=00000000
  
  
  There was an attempt to use an ALET to access some storage in
  the queue manager address space to check whether the queue
  manager has completed processing CSQINP2, however this code
  provides no recovery so in the event that the queue manager
  abruptly terminates rather than starting successfully, the
  chinit uses a now-invalid ALET and an S0E0-2B abend occurs as a
  result of the invalid access.
  Ad'dl search keywords : ABEND0E0 ABEND102
  ABEND0C4
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 2 Modification 0 and                 *
  *                 Release 3 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: The MSTR address space shuts down       *
  *                      before the Channel Initiator has        *
  *                      completed its startup. The Channel      *
  *                      Initiator subsequently abends during    *
  *                      startup with S0E0-0000002B followed by  *
  *                      further S0C4 abends.                    *
  ****************************************************************
  During Channel Initiator startup if the MSTR address space shuts
  down and the Channel Initiator has already obtained an ALET to
  the MSTR address space, attempts are made to use this now
  invalid ALET resulting in unexpected abends. Typically the
  abend seen is S0E0-0000002B which is followed by further S0C4
  abends depending how the invalid ALET is used.
  

Problem conclusion

• Recovery code has been corrected to ensure that in the error
  scenario the S0E0-0000002B abend is correctly handled by the
  appropriate recovery code, the CSQX005E message is output and
  the chinit shuts down cleanly.
  

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:

  UI90879 UI90880

Modules/Macros

• CSQXJST
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R200 PSY UI90880

     UP23/04/07 P F304

• R300 PSY UI90879

     UP23/04/07 P F304

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.