PI48709: CBAC-MULITPLE FIXES:ABEND 102/AKEB FOLLOWED BY CBKFM7312E RC=12,COIE AND EXCI TASKS DEADLOCK, CBKCP403I TO LIST DORLSQUIESCE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Multiple issues will be addressed via this APAR.
  1.) Incomplete CBAC initialization can cause CICS to abend with
      DFHSR0606 Abend (code 102/AKEB) has been detected.
      Following are the sequence of events:
  a.) Shutdown CBAC interface in CICS via KBKM SHUT.  Messages:
      CBKCM4011I CICS Batch Application Control for z/OS SHUTDOWN
      requested
      CBKCT4702I CICS request handler shutting down.  Batch
      utility requests no longer accepted.
      CBKCH4019I CICS Batch Application Control for z/OS SHUTDOWN
      complete
  b.) Restart the CBAC interface in CICS via KBKM START.  However
      the task abends.  The abend is simulated by CEDF
      and PF12 after file access to CBKCNTL.
  c.) Run a CBAC batch job to list the file in CBKCNTL file.
      CICS will abend with an abends102/AKEB.
      DFHSR0606 Abend (code 102/AKEB) has been detected.
      Batch job fails with RC=12 and the following message
      CBKFM7312E CICS is not active for this request.
  2.) COIE and EXCI transactions are deadlocked.  COIE is
      used to change file settings.  If MONITORFILES(NO) is
      specified, the problem can be circumvented.
      CBKFSX67 issued an enqueue on the name
      "CBK CICS Command processor".  A WAIT EXTERNAL was done
      from CBKFSX67 + x'10E4E'.  The ECB is waiting to be posted.
  3.) JESMSGLG message CBKCP4031I is not displayed for the
      DORLSQUIESCE parameter.
  4.) CICS JESMSGLG indicates CBAC issuing QUIESCE commands on
      EMERGENCY restart even thougth DORLSQUIESCE(NO) is
      specified on the INITPARM resulting in files not being
      opened with VSAM return code X'0008' in R15 and reason
      X'00B1'.
  5.) CBKPARMS value "CICSMIRRORTRANS(<BAC)" gets message:
      CBKPA2807E Invalid character in parameter value at offset
      0010.
      CBKPA8030E Error detected in input parameter from CBKPARMS
      member CBKMAINT. Processing terminating.
  Additional Symptom(s) Search Keyword(s): KIXREVRJL
  DORLSQUIESCE parameter not being checked correctly during CICS
  startup.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS BAC V1.1.1                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Multiple issues will be addressed via   *
  *                      this APAR.                              *
  *                                                              *
  *                      1. Incomplete CBAC initialization can   *
  *                         cause CICS to abend with DFHSR0606   *
  *                         Abend (code 102/AKEB) has been       *
  *                         detected. Following are the sequence *
  *                         of events:                           *
  *                       a. Shutdown CBAC interface in CICS via *
  *                          KBKM SHUT.  Messages: CBKCM4011I    *
  *                          CICS Batch Application Control for  *
  *                          z/OS SHUTDOWN requested CBKCT4702I  *
  *                          CICS request handler shutting down. *
  *                          Batch utility requests no longer    *
  *                          accepted. CBKCH4019I CICS Batch     *
  *                          Application Control for z/OS        *
  *                          SHUTDOWN complete.                  *
  *                       b. Restart the CBAC interface in CICS  *
  *                          via KBKM START.  However the task   *
  *                          abends.  The abend is simulated by  *
  *                          CEDF and PF12 after file access to  *
  *                          CBKCNTL.                            *
  *                       c. Run a CBAC batch job to list the    *
  *                          file in CBKCNTL file. CICS will     *
  *                          abend with an abends102/AKEB.       *
  *                          DFHSR0606 Abend (code 102/AKEB)     *
  *                          has been detected. Batch job fails  *
  *                          with RC=12 and the following        *
  *                          message CBKFM7312E CICS is not      *
  *                          active for this request.            *
  *                      2. COIE and EXCI transactions are       *
  *                         deadlocked.  COIE is used to change  *
  *                         file settings.  If MONITORFILES(NO)  *
  *                         is specified, the problem can be     *
  *                         circumvented. CBKFSX67 issued an     *
  *                         enqueue on the name "CBK CICS        *
  *                         Command processor".  A WAIT EXTERNAL *
  *                         was done from CBKFSX67 + x'10E4E'.   *
  *                         The ECB is waiting to be posted.     *
  *                      3. JESMSGLG message CBKCP4031I is       *
  *                         not displayed for the DORLSQUIESCE   *
  *                         parameter.                           *
  *                      4. CICS JESMSGLG indicates CBAC issuing *
  *                         QUIESCE commands on EMERGENCY        *
  *                         restart even thougth                 *
  *                         DORLSQUIESCE(NO) is specified on     *
  *                         the INITPARM resulting in files not  *
  *                         being opened with VSAM return code   *
  *                         X'0008' in R15 and reason X'00B1'.   *
  *                      5. CBKPARMS value                       *
  *                         "CICSMIRRORTRANS(<BAC)" gets         *
  *                         message: CBKPA2807E Invalid          *
  *                         character in parameter value at      *
  *                         offset 0010. CBKPA8030E Error        *
  *                         detected in input parameter from     *
  *                         CBKPARMS member CBKMAINT.            *
  *                         Processing terminating.              *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF.                               *
  ****************************************************************
  

Problem conclusion

• 1. Resolved by performing additional cleanup when
     a CBAC startup failed.
  
  2. Resolved by fixing a bug that caused a CBAC
     enqueue mechanism to fail.  Also, this problem
     can only occur when processing a generic set file
     command.
  
  3-5 Made code changes to correct the issues.
  
  11EY
  11KY
  111Y
  CBKAPARS
  CBKCMNDS
  CBKCSETF
  CBKCSHUT
  CBKCSPRM
  CBKCSRVR
  CBKCSTRT
  CBKCWCRS
  CBKDLOBJ
  CBKFMAIN
  CBKMSG
  CBKMTBAS
  CBKMTENU
  CBKMTJPN
  CBKPARSE
  CBKSPX66
  CBKSPX67
  CBKSPX68
  CBKSPX69
  

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:

  UI31935 UI31936 UI31937

Modules/Macros

• CBKAPARS CBKCMNDS CBKCSETF CBKCSHUT CBKCSPRM
  CBKCSRVR CBKCSTRT CBKCWCRS CBKDLOBJ CBKFMAIN CBKMSG   CBKMTBAS
  CBKMTENU CBKMTJPN CBKPARSE CBKSPX66 CBKSPX67 CBKSPX68 CBKSPX69
  

Fix information

• Fixed component name

  CICS BATCH CONT

• Fixed component ID

  5697I9400

Applicable component levels

• R11E PSY UI31936

     UP15/10/20 P F510

• R11K PSY UI31937

     UP15/10/20 P F510

• R111 PSY UI31935

     UP15/10/20 P F510

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.