Common Communications Interface › TCP/IP Configurations › Configure CAICCI on Windows Running CA Products › LOCAL and REMOTE Statements

LOCAL and REMOTE Statements

The LOCAL statement applies to the local computer. The REMOTE statements apply to the remote nodes that exchange information with CAICCI.

The statements have the following syntax:

LOCAL|REMOTE=tcp/ip_name cci_name buffersize STARTUP|NOSTART [ALIAS=alias_name] [PORT=port_number] retry_interval

tcp/ip_name

Specifies either an IP address in IPV4 format (dotted decimal notation: ddd.ddd.ddd.ddd), in IPV6 format ("xx:xx:xx:xx:xx:xx:xx:xx") in release r12 and above, or a name as input to a name service to retrieve an IP address. You can use tcp/ip_name with the ping command to determine whether a remote connection is live.

Default: Local TCP/IP host name

cci_name

Specifies the host name, which may or may not be the same as the TCP/IP host name. CAICCI uses cci_name to identify this host.

For the REMOTE statement that defines the mainframe, the CAICCI name is the value specified by CAICCI SYSID(sysid) control option on the mainframe.

Default: Local host name

buffersize

Specifies the maximum size of the buffer CAICCI receives or sends. It is used for segmenting data transfer.

Default: 32768

Limits: 1024 through 32768

Important! Contact CA Support before changing the buffer size.

STARTUP|NOSTART

Specifies whether to initiate a remote connection when CAICCI becomes active:

• STARTUP specifies that CAICCI will initiate the connection.
• NOSTART specifies that the remote system will initiate the connection.

ALIAS=alias_name

(Optional) Defines an alias name to differentiate multiple remote systems that have the same first eight characters in their host names.

PORT=port_number

(Optional) Specifies the port number.

Default: 1721

retry_interval

Specifies the number of seconds between attempts to connect:

• -1 specifies that attempts to connect starts with a two-second retry interval that doubles after each unsuccessful attempt.
• 0 specifies that no attempts are made to connect.
• Integer greater than zero specifies that attempts to connect occur at the specified retry interval.

Example: LOCAL Statement

The following LOCAL statement tells CAICCI that the TCP/IP name for the local system is NTSRVR1 and that any remote system wanting to communicate with this system can do so by referencing NTSRVR1 as the name.

LOCAL=NTSRVR1 NTSRVR1 32768 STARTUP

Example: REMOTE Statement

The following REMOTE statement tells CAICCI to attempt to connect to 172.22.111.121 and to register MF01 as the CAICCI name internally.

REMOTE=172.22.111.121 MF01 32768 STARTUP PORT=1721

Example: REMOTE Statement Using an Alias

The following REMOTE statement tells CAICCI to attempt to connect to the system whose TCP/IP name is NTSRVR1 and whose CAICCI name (host name) is WINNTSERVER1. It also lets CAICCI to send and receive messages using the alias NT1.

REMOTE=NTSRVR1 WINNTSERVER1 32768 STARTUP ALIAS=NT1