PK70568: ABENDAPCT AND MESSAGE DFHMQ0351 I WHEN STARTING UP CICS TS32 FOR THE FIRST TIME.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You start up CICSTS32 for the first time and start transaction
  CKQC and recieve the abend APTC. When you look in the JES2 log
  you see some of the following entries:
  DFHMQ0351I Unable to LOAD API exit CSQCAPX. Program is disabled.
  DFHAC2236 Transaction CKQC abend APCT in program DFHMQ1E term
  B004. Updates to local recoverable resources will be backed out.
  The problem does not show up until you installed the
  Refresh-Service for CICS TS 3.2. With the Refresh Service there
  comes the UK28063 and UK31091 PTF which changes the DFH$UMOD.
  You add the MQ modules to the LPA using DFH$UMOD. DFH$ULPA does
  not contain definitions for some of these moved MQ modules so
  when the CKQC transaction is issued, they get the APCT abend.
  You also notice that the following modules are not in DFH$UPLA
  but in DFH$UMOD.
  DFHMQDCO, DFHMQHC, DFHMQHE, DFHMQ1C, DFHMQ1E, DFHMQ1K, DFHMQ1U,
  DFHMQ2C, DFHMQ2E,DFHMQ2K, DFHMQHK, and DFHMQHU.
  Additional Symptoms keywords:
  KIXREVRJL
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Transaction CKQC fails with abendAPCT   *
  *                      because module DFHMQ1E cannot be found. *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The CICS-supplied USERMOD, DFH$UMOD, has been used to move
  several DFHMQ* modules from SDFHLOAD to the link pack area
  (LPA) and then DFH$ULPA has then been used to change the
  definition of these modules to use USELPACOPY(YES).  However,
  not all of the moved DFHMQ* modules have definitions in
  DFH$ULPA (for example, DFHMQ1E).  When transaction CKQC is
  run, CICS does not look for DFHMQ1E in the LPA and issues
  abend APCT when it cannot be found in SDFHLOAD.  Unfortunately,
  the LPA-eligibility definitions of some of the DFHMQ* modules
  in DFH$UMOD are wrong (including DFHMQ1E) and these modules
  should not be moved to the LPA.  The following need to be
  removed from DFH$UMOD:
  DFHMQHC  DFHMQHE  DFHMQHK  DFHMQHU  DFHMQ1C  DFHMQ1E
  DFHMQ1K  DFHMQ1U  DFHMQ2C  DFHMQ2E  DFHMQ2K  DFHMQ2U
  
  DFHMQDCO is LPA-eligible and may be moved to the LPA.  A
  definition for DFHMQDCO with USELPACOPY(YES) needs to be added
  to DFH$ULPA.
  
  Note that MSGDFHMQ0351I is reporting that the API-crossing exit
  (CSQCAPX) that is  supplied with WebSphere MQ for z/OS isn't
  enabled.  This is not related to the abend APCT.
  
  Additional keywords: DFHMQ DFH½UMOD DFH½ULPA ELPA extended
                       MSGDFHMQ0351 DFHMQ0351 MSGDFHAC2236
                       SDFJLOAD
  

Problem conclusion

• ++ MOVE statements for the following modules have been removed
  from DFH$UMOD and DFJ$UMOD:
  DFHMQHC  DFHMQHE  DFHMQHK  DFHMQHU  DFHMQ1C  DFHMQ1E
  DFHMQ1K  DFHMQ1U  DFHMQ2C  DFHMQ2E  DFHMQ2K  DFHMQ2U
  
  A definition of DFHMQDCO with USELPACOPY(YES) has been added to
  DFH$ULPA.
  
  The following entries will be added after the entry for DFHMNSVC
  in "Table 27. LPA-eligible modules" in the CICS Transaction
  Server for z/OS Installation Guide Version 3 Release 2,
  GC34-6812-01:
  
  Name     Description               Library LPA/ Pri Size Option/
                                             ELPA          Note
  
  DFHMQBAS BMS program handling the  LOAD    ELPA 3   8432 (1)
           base panel
  DFHMQBP0 CICS bridge - Request     LOAD    ELPA 3  59608 (1)
           handler
  DFHMQBP1 CICS MQ Bridge - DPL      LOAD    ELPA 3  31640 (1)
           Abend Handler
  DFHMQBR0 CICS MQ Bridge - monitor  LOAD    ELPA 3  53816 (1)
           main program
  DFHMQCOD PLT program to initiate   LOAD    ELPA 3   3968 (1)
           connection using
           INITPARM
  DFHMQCON The back-end module to    LOAD    ELPA 3  18576 (1)
           issue connection request
           to MQ subsystem
  DFHMQCTL First-Level transaction   LOAD    ELPA 3   6032 (1)
           for operations.  This
           program only handles text
           mode operation
  DFHMQDCI Data conversion exit for  LOAD    ELPA 3   4480 (1)
           inbound data to the
           MQ-CICS bridge, for use
           in CICS environment.
  DFHMQDCO Data conversion exit for  LOAD    ELPA 3   3112 (1)
           outbound data from the
           MQ-CICS bridge.
  DFHMQDIS The back-end module to    LOAD    ELPA 3  15448 (1)
           service display requests
  DFHMQDSC The back-end module to    LOAD    ELPA 3  15600 (1)
           issue disconnect request
           to MQ subsystem
  DFHMQDSL Second-level transaction  LOAD    ELPA 3   6592 (1)
           for DISPLAY
  DFHMQMON The monitor program which LOAD    ELPA 3   6384 (1)
           looks after pending
           events
  DFHMQPLT Sample Connect program in LOAD    ELPA 3    640 (1)
           phase 2 PLT execution
  DFHMQPOP BMS program handling all  LOAD    ELPA 3  10936 (1)
           pulldown maps
  DFHMQPRM Get all default adapter   LOAD    ELPA 3   1928 (1)
           parameters
  DFHMQPUL BMS program handling all  LOAD    ELPA 3  11104 (1)
           pulldown maps
  DFHMQQCN Second-level transaction  LOAD    ELPA 3   8416 (1)
           for Connect
  DFHMQRET BMS program handling      LOAD    ELPA 3  10936 (1)
           final screen including
           scrolling
  DFHMQRS  The back-end module to    LOAD    ELPA 3   7528 (1)
           service reset (change)
           requests
  DFHMQSSQ The back-end module to    LOAD    ELPA 3   9256 (1)
           service start/stop CKTI
           request
  DFHMQTRU CICS Task Related User    LOAD    ELPA 3  32384 (1)
           Exit for WebSphere MQ
  DFHMQTSK Task Initiation Support   LOAD    ELPA 3  14760 (1)
           (CKTI transaction)
  

Temporary fix

• FIX TOO LARGE FOR RETAIN, THE FIX MAY BE AVAILABLE IN DLL
  

Comments

• ž**** PE09/05/22 FIX IN ERROR. SEE APAR PK85449  FOR DESCRIPTION
  

APAR Information

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

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

  UK40950 UK40951

Modules/Macros

•    DFH$ULPA DFH$UMOD DFJ$UMOD
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R50D PSY UK40951

     UP08/10/24 P F810

• R500 PSY UK40950

     UP08/10/24 P F810

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.