PI59333: CBAC COMPATIBILITY FOR CICS/TS 5.3

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR will provide changes to CICS Batch Application
  Control ( CBAC ) to run with CICS/TS Version 5.3.
  Additional Symptoms and Keywords: KIXREVWJB GENSETFILE YES
  EXCLUSIVE CI CONFLICT RPL RPLFDBK 0814 CBKCNTL
  .
  While attempting to update the status of files while the CICS
  region is down, the CBAC generic set file batch job received
  the following errors and failed to update the status:
  .
  CBKBC1401I <cbkid> CICS control file table construction
  starting.
  CBKBC1409I <cbkid> CICS control file table successfully built
  from CBKPARMS member. Number of entries: nn.
  .
  CBKCQ8004I <identifier> CICS region control file dynamically
  allocated: CICS(<applid>) DSN(data-set-name).
  .
  CBKBR9001E Internal error: code1(00000028) code2(00000814) data
  (0000000000000000).
  .
  CBKBA5022I The following commands were serviced directly by the
  CICS BAC batch request utility because CICS region <applid> is
  not active or the CICS BAC request server is not active in
  that region:
  SET FILE(GEN*),OPENSTAT (CLOSE)
  .
  CBKSC5007E Error processing request: EIBRESP=00000000,
  EIBRESP2=00000000, VSAM Code=00000000, Type=GROUP, Object=GEN*,
  Text=No matching file names
  .
  CBKBW5012I Keyword values in effect for the SET command:
  CBKBW5013I FILE(GEN*)
  CBKBW5013I OPENSTATUS(CLOSED)
  CBKBW5013I CICS(<applid>)
  .
  While running CBKFMAIN in batch job the following intermittent
  error occurs:
  .
  CBKBC1401I <cbkid> CICS control file table construction
  starting.
  CBKBC1409I <cbkid> CICS control file table successfully built
  from CBKPARMS member. Number of entries: nn.
  CBKDO9001E Internal error: code1(00000028) code2(00000814) data
  (0000000000000000).
  Additional Symptom(s) Search Keyword(s): kixdcfcic700
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS BAC V1.1.1                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Add support for CICS Batch Application  *
  *                      Control to run with CICS TS V5.3        *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF.                               *
  ****************************************************************
  This fix adds support to CICS Batch Application Control
  to run with CICS TS V5.3
  
  The following documentation change will be made to the
  CICS BAC User's Guide as described below:
  
  Documentation changes to the CICS TS 5.3 Knowledge Center
  ---------------------------------------------------------
  In the CICS TS 5.3 Knowledge Center;
  CICS Batch Application Control for z/OS V1.1.1;
  User Guide ->
  Implementation and customization ->
  Setting up and starting the CICS component ->
  Preparing CICS regions for CICS BAC ->
  CICS BAC program and mapset definitions;
  in the notes below Figure 4 "CEDA commands to define the CBK
  programs and mapset in your CSD":
  
  Additional text is added to note 1.
  At the end of the second sentence, add the following text:
  
  "or 70 if you are installing CICS BAC in a CICS TS 5.3 region."
  
  The note should now read:
  
  1. In the CEDA commands shown in Figure 4, replace cbkgroup with
  any character string allowed by the CEDA transaction that meets
  your installation standards. Replace the nn in the program names
  CBKFSXnn and CBKSPXnn with 53 if you are installing CICS BAC in
  a CICS TS 1.3 region; 62 if you are installing CICS BAC in a
  CICS TS 2.2 region; 63 if you are installing CICS BAC in a CICS
  TS 2.3 region; 64 if you are installing CICS BAC in a CICS TS
  3.1 region; 65 if you are installing CICS BAC in a CICS TS 3.2
  region; 66 if you are installing CICS BAC in a CICS TS 4.1
  region; 67 if you are installing CICS BAC in a CICS TS 4.2
  region; 68 if you are installing CICS BAC in a CICS TS 5.1
  region; 69 if you are installing CICS BAC in a CICS TS 5.2
  region; or 70 if you are installing CICS BAC in a CICS TS 5.3
  region.  You can also define the programs for all these CICS
  releases if you want to.
  
  
  1. This PTF adds 2 new load modules to the SCBKLOAD library.
     Before applying the PTF you should ensure that the SCBKLOAD
     library has at least 18 directory blocks.
  
  2. There are two new programs CBKFSX70 and CBKSPX70 for which
     program definitions are required in the CICS region where
     CICS BAC runs.
     The resource definitions for these programs are in member
     CBKPROGS in the SCBKSAMP library.  They are marked with the
     APAR number PI59333.
     Please ensure that you add these additional resource
     definitions to your CICS system.
     Although these new programs and definitions are only
     required in a CICS TS 5.3 environment, you are advised to
     add the definitions to CICS regions running other releases
     of CICS TS so that they will be available if and when you
     migrate the regions to CICS TS 5.3.
  

Problem conclusion

• CICS Batch Application Control base code has been enhancedto run
  with CICS TS V5.3.
  
  1. This PTF adds 2 new load modules to the SCBKLOAD library.
     Before applying the PTF you should ensure that the SCBKLOAD
     library has at least 18 directory blocks.
  
  2. There are two new programs CBKFSX70 and CBKSPX70 for which
     program definitions are required in the CICS region where
     CICS BAC runs.
     The resource definitions for these programs are in member
     CBKPROGS in the SCBKSAMP library.  They are marked with the
     APAR number PI59333.
     Please ensure that you add these additional resource
     definitions to your CICS system.
     Although these new programs and definitions are only
     required in a CICS TS 5.3 environment, you are advised to
     add the definitions to CICS regions running other releases
     of CICS TS so that they will be available if and when you
     migrate the regions to CICS TS 5.3.
  
  111Y
  CBKAPARS
  CBKCMNDS
  CBKFSX70
  CBKGSE70
  CBKMVCFT
  CBKPROGS
  CBKSPX70
  HCBK111J
  

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:

  UI39249

Modules/Macros

• CBKAPARS CBKCMNDS CBKFSX70 CBKGSE70 CBKMVCFT CBKPROGS CBKSPX70
  HCBK111J
  

Fix information

• Fixed component name

  CICS BATCH CONT

• Fixed component ID

  5697I9400

Applicable component levels

• R111 PSY UI39249

     UP16/07/16 P F607

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.