Host

Specifies the name of the mainframe host you are connecting. 

Enter CICS. 

The value always defaults to CICS for CICS connections.

Port

Specifies the TCP/IP port where the Sun CICS Listener (and the CICS Listener) is listening. This is the port to which the CICS Adapter will connect. 

The TCP/IP port to which Sun CICS Listener is listening. 

Sun CICS Listener TransId

Specifies the Sun CICS Listener TransId on the mainframe host. This is the CICS Transaction that the Sun CICS Listener is installed under. 

The valid TransId of the Sun CICS Listener. 

The default is STCL.

Start Type

Specifies the startup type. This can be either IC for CICS interval control, or TD for CICS transient data. This is the CICS Startup type for the program being executed. 

Select IC or TD .

The default value is IC.

Start Delay

Specifies the hours, minutes and seconds (interval of time) to delay starting the transaction program (TP) on the CICS server for the IC Start Type. This field is optional, but must specify all 6 digits if used. 

A 6 digit integer. All 6 digits must be given if this is specified (for example, 123456). 

The default value is 000000.

Listener Timeout

Specifies the amount of time (in milliseconds) for the Sun CICS Listener to wait for the next incoming transaction program request from the CICS Adapter. 

A number indicating the Listener timeout in milliseconds (for example, 120000 milliseconds equals 2 minutes). 

TP Timeout

Specifies the amount of time the CICS Adapter will wait for the Sun CICS Listener to return results for a current transaction program request. 

A number indicating the TP Timeout in milliseconds (for example, 120000 milliseconds equals 2 minutes). 

Polling Rate

Specifies the polling rate. This is the number of times the Sun CICS Listener queries the current TCP connection for incoming traffic before issuing an EXEC CICS DELAY for one second. 

An integer indicating the Sun CICS Listener polling rate. 

Transport Timeout

Specifies the timeout used by both the local and host side for send or receive. 

A number indicating the Transport Timeout in milliseconds (for example, 5000 milliseconds equals 5 seconds). 

COMMAREA Padding Character

Specifies the EBCDIC code for the character used by the SBYND listener to pad the COMMAREA at the CICS server when the actual length of the payload in the COMMAREA is shorter than the length given by CommAreaLength. The default value is hexadecimal 40 - EBCDIC space. 

A character value coded in Hexadecimal. For example: 40 for Blanks, 00 for Low Values, FF for High Values, and so forth. 

The default value is 40.

SendBufSize

Specifies the Send Buffer Size (in bytes) for the underlying socket. 

A number indicating the Buffer Size in bytes (for example, 2048 bytes equals 2 KB). 

ReceiveBufSize

Specifies the Receive Buffer Size (in bytes) for the underlying socket (provided as a hint). 

A number indicating the Receive Buffer Size in bytes (for example, 10240 bytes equals 10 kilobytes). 

NoDelay

Specifies whether the system can delay connections or requests. Generally, True (no delay) is required for high-volume or critical transactions. In cases of low-volume and noncritical transactions, you can use False. (Specifies whether to disable Nagle’s Algorithm.) 

Enter Trueor False.

True is the default.

KeepAlive

Specifies whether to enable the socket’s SO_KEEPALIVE option when it creates a socket connection to the CICS listener. SO_KEEPALIVE maintains active connections by enabling periodic transmission of messages (if this is supported by the protocol). If the connected socket fails to respond to these messages, the connection is broken and the processes writing to that socket are notified with an ENETRESET errno. This option takes an int value in the optval argument. This is a BOOL option. 

The socket’s SO_KEEPALIVE option is used to enable pinging of the connection to the peer during connection to keep the connection “alive”. This is used to prevent connections from going idle and timing out. 

SO_KEEPALIVE periodically sends a message to the connection socket of the peer to ensure that the connection is still “alive” (active). One of three responses is expected: 

1. The peer responds with the expected ACK. The application is not notified (since everything is OK). TCP will send another probe following another 2 hours of inactivity.

2. The peer responds with an RST, which tells the local TCP that the peer host has crashed and rebooted. The socket is closed.

3. The peer fails to return a response. The socket is closed. The purpose of this option is to detect whether the peer host has crashed.

Enter True to enable SO_KEEPALIVE, or False to disable the option.

True is the configured default.