PK45073: RESTRICTION OF 1 RECEIVE SESSION BE IMPOSED IN THE SESSION DEFINITION WHEN THE PROTOCOL SPECIFIED IS EXCI.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Restriction of 1 RECEIVE session be imposed in the SESSION
  definition when the PROTOCOL specified is EXCI.
  Also, a DOC change, because if the CEDA interface is changed
  then the RDO manual will need to be updated and a similar change
  will be need to be made in the CICS External Interface Guide.
  

Local fix

• Multiple CALL Interface jobs can be executed at the same time
  by having multiple Connections, each with one session.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The RECEIVECOUNT restriction of 1 on an *
  *                      EXCI connection is not enforced.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  To prevent problems described in APARs PQ38358 and PQ91341, a
  restriction is being imposed on the Session Definition used in
  EXCI Connections.
  
  Attempting to open more than a single External CICS Interface
  (EXCI) PIPE to a CICS EXCI connection causes all batch users
  with open pipes to a connection to hang. This happens with both
  GENERIC and SPECIFIC connections no matter how many sessions
  have been defined to the connection.
  
  Additional keywords
  PQ38358 PTM80126 PQ91341 MRO82304241
  

Problem conclusion

• This APAR will restrict the RECEIVECOUNT to 1 on each EXCI
  Connection so that only one EXCI job can execute at any one time
  on that Connection. If an attempt is made to use a value greater
  than 1, a message will be issued and a value of 1 will be
  enforced.
  
  
  The documentation in the following manual has been changed :-
  
  (1) CICS Transaction Server for VSE/ESA(TM) Release 1
      CICS External Interfaces Guide
      SC33-1669-04
  
  3.1 Introduction to the external CICS interface (Chapter 8)
  ===========================================================
  3.1.1 Overview
  Change paragraph 2
  "This programming interface allows a user to allocate and open
   sessions (or pipes (1)) to a CICS region, and to pass
   distributed program link (DPL) requests over them."
  
  To
  "This programming interface allows a user to allocate and open a
   session (or pipe (1)) to a CICS region, and to pass distributed
   program link (DPL) requests over it."
  
  3.1.1.2 Illustrations of the external CICS CALL interface
  Changes Figures 25, 26, 27 and 28.
  In the CICS Server Region box for each change :-
       <---- MRO EXCI CONNECTION
       <---- installed with 3 sessions
       <---- (PROTOCOL=EXCI)
             (RECEIVECOUNT=3)
  to :-
       <---- MRO EXCI CONNECTION
             installed with a session
             (PROTOCOL=EXCI)
             (RECEIVECOUNT=1)
  
  In Note 1 following Figure 25 change
  "1. In Figure 25, the target CICS region is running with IRC
      open, and one EXCI connection with three sessions
      installed....".
  To :-
  "1. In Figure 25, the target CICS region is running with IRC
      open, and one EXCI connection with one session
      installed...".
  
  
  3.4 Defining Connections to CICS (Chapter 11)
  =============================================
  3.4.2 SESSIONS resource definitions for EXCI connections
  For RECEIVECOUNT add :-
  "For External CICS Interface (EXCI) connections this value
   should always be 1."
  
  
  3.10 Response and Reason codes returned on EXCI calls (Chap 17)
  ===============================================================
  In section 3.10.3 Reason Codes for response: RETRYABLE
  change :-
  202    NO_PIPE
  Replace the following in the User Response
  "... For this reason, you are recommended to specify a larger
   RECEIVECOUNT value than is theoretically necessary when
   defining the SESSIONS resource definition to CICS. The
   application program can reissue the Open_Pipe request."
  
  With :-
  "... For this reason, DFHXCPRH has already retried the
   Open_Pipe request 20 times with a half second delay between
   each request. However the Pipe is still unavailable for use.
   The application program can reissue the Open_Pipe request when
   the other user of the Pipe has completed."
  
  
  
  (2) CICS Transaction Server for VSE/ESA(TM) Release 1
      CICS Resource Definition Guide
      SC33-1653-06
  
  4.9.6 Defining a SESSION
  ========================
  Under RECEIVECOUNT
  After :-
  "Except for external CICS interface (EXCI) connections, the
   RECEIVECOUNT in this system should equal SENDCOUNT in the other
   system.
  Add the following :-
  "For External CICS Interface (EXCI) connections this value
   should always be 1."
  
  Replace the Note starting :-
  "7 Note: CICS restricts the number of sessions ......"
  
  With :-
  "Note: CICS restricts the number of connections (each with one
   session) for an EXCI address space to 25.
   When this limit is reached, DFHIRP rejects further requests for
   a session with SYSTEM_ERROR reason code 608."
  
  
  
  (3) CICS Transaction Server for VSE/ESA(TM) Release 1
      CICS Intercommunication Guide
      SC33-1665-01
  
  3.1.4 Defining links for use by the external CICS interface
  ===========================================================
  Change Figures 28 and 29
  From :-
          "RECEIVECOUNT(5)      5 receive sessions"
  To :-
          "RECEIVECOUNT(1)      1 receive session "
  

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK31552

Modules/Macros

•    DFHCURDM DFHCURDS DFHSPTIB DFHSPTIC DFHSPTIE
  DFHTOASE DFHXCPRH
  

Fix information

• Fixed component name

  CICSTS FOR VSE

• Fixed component ID

  564805400

Applicable component levels

• RB0P PSY UK31552

     UP07/11/30 P E412

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.