A fix is available
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
SC33166904 | SC33165306 | SC33166501 |
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
19 May 2008