Installing Upgrading Designing Configuring Deploying Monitoring Administering Troubleshooting Reference JBI Components
Close Print View
Configuring: Sun CICS Listener
 

Classic Java CAPS

Configuring JMS Clients

Configuring Java CAPS for SSL Support

Configuring Java CAPS Business Processes

Configuring Environment Components for the Sun Business Process Manager

Configuring Sun Master Indexes (Repository)

Configuring Java CAPS Project Components for Application Adapters

Configuring Java CAPS Project Components for Communication Adapters

Configuring Java CAPS Project Components for Database Adapters

Configuring Java CAPS Project Components for Web Server Adapters

Configuring Java CAPS Environment Components for Application Adapters

Configuring Java CAPS Environment Components for Communications Adapters

Using the Environment Properties Editor

To Configure the Environment Properties

Configuring Batch Adapter Batch Inbound Environment Properties

MDB Settings (BatchInbound Environment)

Configuring TCP/IP Adapter Environment Properties

TCPIP Server (Inbound) Adapter - General Inbound Settings

TCPIP Server (Inbound) Adapter - TCPIP Inbound Settings

TCPIP Server (Inbound) Adapter - MDB Pool Settings

TCPIP Client (Outbound) Adapter - General Outbound Settings

TCPIP Client (Outbound) Adapter - TCPIP Outbound Settings

TCPIP Client (Outbound) Adapter - Connection Pool Settings

Configuring TCP/IP HL7 Adapter Environment Explorer Properties

HL7 Inbound Adapter - TCPIP Inbound Settings

HL7 Inbound Adapter - MDB Pool Settings

HL7 Inbound Adapter - Sequence Number Protocol

HL7 Outbound Adapter - TCPIP Outbound Settings

HL7 Outbound Adapter - Connection Pool Settings

HL7 Outbound Adapter - Sequence Number Protocol

Configuring EMail Adapter Environment Properties

Inbound Email Adapter => Connection Settings

Inbound Email Adapter => SSL

Inbound Email Adapter => SSL => CACerts

Inbound Email Adapter => MDB Settings

Outbound Email Adapter => Connection Settings => Send SMTP

Outbound Email Adapter => Connection Settings => Receive POP3

Outbound Email Adapter => SSL

Outbound Email Adapter => SSL => CACerts

Configuring File Adapter Environment Properties

Inbound File Adapter - Parameter Settings

Inbound File Adapter - MDB Settings

Outbound File Adapter - Parameter Settings

Configuring MSMQ Adapter Environment Properties

Inbound MSMQ Adapter -- MSMQ Environment

Inbound MSMQ Adapter -- MDB Settings

Inbound MSMQ Adapter -- Connection Retry Settings

Outbound MSMQ Adapter -- MSMQ Environment

Outbound MSMQ Adapter -- Connection Retry Settings

Configuring Batch Adapter BatchFTP Environment Properties

SOCKS (BatchFTP Environment)

FTP (BatchFTP Environment)

General Settings (BatchFTP Environment)

SSH Tunneling (BatchFTP Environment)

Connection Pool Settings (BatchFTP Environment)

Connection Retry Settings (BatchFTP Environment)

Configuring Batch Adapter BatchFTPOverSSL Environment Properties

FTP and SSL Settings (BatchFTPOverSSL Environment)

Firewall Settings (BatchFTPOverSSL Environment)

General Settings (BatchFTPOverSSL Environment)

Connection Pool Settings (BatchFTPOverSSL Environment)

Connection Retry Settings (BatchFTPOverSSL Environment)

Configuring Batch Adapter BatchSCP Environment Properties

SSH Settings (BatchSCP Environment)

Firewall Settings (BatchSCP Environment)

General Settings (BatchSCP Environment)

Connection Pool Settings (BatchSCP Environment)

Connection Retry Settings (BatchSCP Environment)

Configuring Batch Adapter BatchSFTP Environment Properties

SFTP Settings (BatchSFTP Environment)

Firewall Settings (BatchSFTP Environment)

General Settings (BatchSFTP Environment)

Connection Pool Settings (BatchSFTP Environment)

Connection Retry Settings (BatchSFTP Environment)

Configuring Batch Adapter BatchLocalFile Environment Properties

General Settings (BatchLocalFile Environment)

Connection Pool Settings (BatchLocalFile Environment)

Configuring Batch Adapter BatchRecord Environment Properties

Connection Pool Settings (BatchRecord Environment)

Configuring CICS Adapter Environment Properties

Sun CICS Listener

CICS Gateway

CICS Client

Tracing

Connection Retry Settings

Connection Pool Settings

Configuring COM/DCOM Adapter Environment Properties

Configuring HTTPS Adapter Environment Properties

Property Categories Configured in the Application Server Environment

HTTP Settings

Proxy Configuration

Security

Additional SSL Section Notes

Connection Pool Settings

Configuring IMS Adapter Environment Properties

TCP/IP Configuration

IRM Header

Serial Mode Settings

Connection Retry Settings

Connection Pool Settings

Configuring LDAP Adapter Properties

Configuring Connection Section Properties

Configuring the Security/SSL Section Properties

Configuring the Connection Retry Settings

Configuring the Connection Pool Settings

Configuring the SNA Adapter Environment Properties

Property Categories Configured in the Application Server Environment

Configuring Java CAPS Environment Components for Database Adapters

Configuring Java CAPS Environment Components for Web Server Adapters

Configuring JDBC/ODBC Drivers

Configuring SAP R/3 for the SAP BAPI Adapter

Configuring Secure Network Communications for SAP

Configuring Siebel EAI Workflows

Importing an SNA Custom Handshake Class

Configuring WebLogic for Asynchronous Communication

Configuring Master Index (Repository) Connectivity and Environments

Related Topics for Sun Adapter for Batch/FTP

Java EE Based Components

Broadcasting Master Index Updates to External Systems

Configuring Sun Master Indexes

Sun CICS Listener

The Sun CICS Listener section of the CICS Environment properties contains the top-level parameters displayed in the following table.

Environment Properties - Sun CICS Listener Section

Name
Description
Required Value
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.

Related Topics