Previous Topic: Trace a Communications ProblemNext Topic: SSL Tab


TCP/IP Tab

The TCP/IP tab lets you set TCP/IP parameters for CAICCI on Windows.

Server ID Options

Primary or Alternate

Lets you specify the primary CAICCI server and an alternate server. When both servers are specified, CAICCI-PC first connects to the primary server. If the primary server is not available, CAICCI-PC then connects to the alternate server. When the primary CCI server becomes available, the current connection to the alternate CAICCI server remains active. The CAICCI-PC client application does not reconnect to the primary CAICCI server until the current connection to the alternate CCI server terminates and a new connection request is initiated. Likewise, if the connected primary CAICCI server goes down, CAICCI-PC does not automatically switch to the alternate server. Any CAICCI-PC application that loses a connection to a server must restart the connection.

When you select Primary, the tool changes the Name or IP address and Port fields to let you edit the name/IP address and port number of the primary CAICCI server. The primary CAICCI server identification is required.

When you select Alternate, the tool changes the Name or IP address and Port fields to let you edit the name/IP address and port number of the alternate CAICCI server. The alternate CAICCI server identification is optional.

When the dropdown selection is changed, the information for primary and alternate CAICCI Servers is saved in the currently running Configurator.

Note: Any CAICCI server that the CAICCI-PC application specifies overrides the primary server identification, and the alternate server identification is ignored.

Name or IP address

IP address or Network name of the CAICCI server machine to which the CAICCI-PC client is to connect to service CCI requests from the PC application.

IPv6 is supported in CAICCI-PC Version 14.0. You can specify an IP address in either IPv4 format (dotted decimal notation: "ddd.ddd.ddd.ddd") or IPv6 format ("xx:xx:xx:xx:xx:xx:xx:xx").

Port

Port number of the CAICCI server to which CAICCI-PC is to connect.

Default: 1202

Note: A CAICCI-PC application may override the IP address, Network name, or Port number programmatically. If a question arises about configuration settings, you can obtain a CAICCI-PC trace to identify application overrides.

Client ID Options

System Name

Commonly known as the CCI SYSID. This field accepts an alphanumeric string, eight characters or less, that uniquely identifies this CCIPC client machine across the CCI network.

By default, CAICCI uses the name that TCP/IP defines. If the name is longer than eight characters, it uses the machine name to derive a different but unique eight-character name. To use a preferred ID, specify a unique new name in the text box.

Default: Name TCP/IP defines

Limits: Eight characters

CAICCI Timeout Interval Options:

Reply Wait

The Reply Wait Timeout interval in seconds; that is, the interval to wait for a response after a request is sent to the server. For send and receive requests to the server application, this value indicates the time that CAICCI-PC waits for the server application to respond before timing out the request.

Specifying a negative value causes the largest signed 32-bit integer (2147483647) in seconds to be used and is the most efficient setting.

Specifying 0 in this field requests that an infinite polling loop be used rather than a timed wait.

Default: -1 (largest signed 32-bit integer)

Note: Unless the Override appl timeout box is checked, the Reply Wait value is not used. If the Override appl timeout box is not checked, timeout values provided programmatically to CAICCI-PC by the application are used instead.

Ready to Receive

The Ready to Receive Timeout interval in seconds; that is, the interval to wait until at least one byte is available to read from the network. This value is used after the network has delivered part of a response packet to CAICCI-PC and further network reads are needed to obtain the remainder of the packet. Specifying a negative value causes the largest signed 32-bit integer (2147483647) in seconds to be used and is the most efficient setting. Specifying 0 in this field requests that an infinite polling loop be used rather than a timed wait.

Default: -1 (largest signed 32-bit integer)

Ready to Send

Ready to Send Timeout interval in seconds; that is, the interval to wait until the network can accept one or more bytes of a request packet from CAICCI-PC. A zero(0) in this field indicates to poll up to 9999 times, and then return an error. Specifying an interval is more efficient and allows a more precise wait time than polling. The tool does not allow negative values.

Default: 60

Override appl timeout

A check in this box overrides any timeout value that the application passes programmatically to CAICCI-PC. The Reply Wait Timeout is used instead. We recommend that you leave this box unchecked. If frequent timeouts are encountered due to application settings being too low, CA technical support may advise you to check this box.