IBM Support

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

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PK45073

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-05-11

  • Closed date

    2007-11-23

  • Last modified date

    2008-05-19

  • 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
    

Publications Referenced
SC33166904SC33165306SC33166501  

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.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
19 May 2008