OS 2200 TIP Configuration Dialog

The following properties can be set for an OS 2200 TIP data source project when the OS 2200 COBOL Data Source Wizard is first initiated.

Element

Description

OS 2200 Host Name

The Domain Name Server (DNS) name or public IP address on which CITA is configured to listen. By default, CITA listens on all IP addresses configured for the COMAPI process, in the CPComm/CPCommOS configuration. Alternatively, the CITA configuration may define an explicit IP address using the LIP parameter, so that CITA will only listen on the specified IP address.

Port Number

The port number used to connect to the TIP COBOL application. This number matches the port number configured in CITA.  A port number must be an integer in the range 1-65535.

OS 2200 Character Set

The character set used for the data that is transferred to and from the TIP COBOL application. Refer to Translation Considerations.

Default TIP Transaction Code

This value is optional and can be left blank.

Whenever an ePortal server message is sent to the OS 2200, the value of the metadata field tiptrancode__ is used as the TIP transaction code. However, if the field tiptrancode__ is null or empty, then the value of the default TIP transaction code is used instead. Refer to Metadata Fields for more information.

Reconnect on Send Error

  • If selected, the TIP Connector closes the current connection when a failure occurs while sending a message to the ClearPath application. It then creates a new connection and attempts to send the message again. If this second retry fails, an error is reported to the client application.

  • If cleared, the TIP Connector immediately reports an error back to the client application when a failure occurs while sending a message to the ClearPath application.

Note: By default, the checkbox is selected to maintain compatibility with the previous behavior, which is to retry sending the message on a new connection; however, this may not be appropriate always depending on how the host application is designed.

To select or clear the checkbox, consider the following:

  • For stateless applications, it is generally appropriate to reconnect and send the message again. After a send failure, if you want the system to immediately retry sending the message, select the checkbox.

  • If your application is stateful, it is recommended to clear this checkbox. A second attempt with a different host connection could either fail or it may be inappropriate within the new session context.

Validate New Connection

  • If selected, attempts to verify if the connection is usable after it is created.

  • If cleared, attempts to use the connection after it is created. The software will assume that the connection is viable.

Note: By default, the Validate New Connection checkbox is selected.