Shortage of IPIC resources on the CICS server

An error can occur if there is a shortage of IPIC resources.

Symptom

Intermittent ECI_ERR_RESOURCE_SHORTAGE errors occur when sending an ECI request to CICS® over IPIC.

Probable cause

All the defined sessions for the connection are in use. Each active session uses one CICS task, and the maximum number of sessions allowed is 999. CICS Transaction Gateway allocates 300 KB of memory for each session. If all the defined sessions are in use, any new requests receive an ECI_ERR_RESOURCE_SHORTAGE error.

Action

  • In remote mode topologies, increase the SENDSESSIONS value in the CICS Transaction Gateway configuration file (ctg.ini).
  • In local mode topologies using JEE, increase the value of the ipicSendSessions property in the connection factory configuration.
  • In local mode topologies using Java™ base classes, use the CTG_IPIC_SENDSESSIONS Java property to set the maximum number of IPIC send sessions.
  • Increase the IPCONN ReceiveCount value in CICS.
  • Increase the Java heap size.
For more information see Configuring IPIC on CICS Transaction Server for z/OS

Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//ctgunx/aipdkyc_2.html