Configuring IPIC in local mode

For IPIC connections in local mode, the CICS® server name (ServerName) is defined as a URL. A URL allows you to specify a protocol, host name, and port number, which is the minimum information you need to connect to CICS.

The URL has the following format:
Protocol://hostname:port
Protocol://hostname:port#CICSAPPLID
Protocol://hostname:port#CICSAPPLIDQUALIFIER.CICSAPPLID
where:
  • Protocol is either tcp or ssl.
  • hostname is the TCP address of the host.
  • port is the port number of the TCPIPSERVICE listener in CICS.
  • CICSAPPLID is the APPLID of the CICS server.
  • CICSAPPLIDQUALIFIER is the network ID of the CICS server.

CICSAPPLID and CICSAPPLIDQUALIFIER are optional parameters. If specified, these parameters are sent to CICS when the connection is established and are validated by CICS. The connection is rejected if the CICSAPPLID and CICSAPPLIDQUALIFIER do not match the CICS server. If you do not specify the CICSAPPLID and CICSAPPLIDQUALIFIER parameters, no check is made.

The default number of IPIC send sessions in local mode is 100. If you use the ECI resource adapter, you can change this value by setting the ipicSendSessions parameter. If you use a Java™ application, you can change this value by setting the LOCAL_PROP_IPIC_SENDSESSIONS property on the JavaGateway object.

By default, CICS TG will send a heartbeat request to CICS every 30 seconds when the IPIC connection is not active if the CICS server supports IPIC heartbeats. If you use the ECI resource adapter, you can change this value or disable heartbeats by setting the ipicHeartbeatInterval parameter. If you use a Java application, you can change this value or disable heartbeats by setting the LOCAL_PROP_IPIC_HEARTBEAT property on the JavaGateway object. For more information, see CICS Transaction Gateway Base API Programming Reference.

For more information on configuring IPIC in local mode using the ECI resource adapter, refer to ECI resource adapter deployment parameters.