Configuration and Security › Configuration › CAGSPARM Parameters › TCPIPC00

TCPIPC00

The TCPIPC00 member describes the GTS-to-GTS TCP/IP client connectivity. Each GTS has a server and a client component. This member describes the client information, whereby the TCPIPS00 member describes the CA GTS Server information. Not all CA GTS applications require network connections. This includes the two applications that are included with CA GTS: ECHO and USSF. You should only define these connections if they are needed by the applications that will be using CA GTS.

The TCPIPC00 member supports the following keywords:

DEBUG(YES|NO|ON|OFF)
SERVER(xxxxxxxx)
Connection(PORT(nnnnn) +
HOSTNAME(url.name) +
HOSTADDR(ip.address) +
KEY(encryption_key) )

DEBUG

Indicates whether debugging messages should be generated; this should only be turned on at the request of CA Support. The default is NO or OFF.

SERVER

Specifies the name of the TCP/IP server to use; this can be one to eight characters. This keyword is only necessary if the code cannot otherwise determine which TCP/IP is available and the standard identifier 'TCPIP' is not active. To allow for the automatic recognition of the proper TCP/IP, allocate the SYSTCPD DD statement to the TCP/IP data set containing the system definitions. Specifying SERVER() should only be a last recourse or necessary if GTS does not automatically pick the proper identifier. Only one SERVER keyword is permitted in this member.

CONNECTION

Defines a connection to another CA GTS system; each CA GTS that you want to connect requires a CONNECTION keyword with subparameters to define the connection. Each CONNECTION keyword will contain one or more of the following subparamters:

Subparameters

HOSTNAME

Specifies the host name; this can be up to 255 alphanumeric characters. If the host names are not fully qualified, TCP/IP will complete the domain information if so configured. Code either the HOSTNAME or the HOSTADDR for a connection, but not both.

CA GTS will attempt to connect to this domain name using the specified port for the purposes of routing requests. Thus the port specification should point to another CA GTS system.

HOSTADDR

Specifies the IP address of another CA GTS system to which this CA GTS should connect; this can be seven-to-45 alphanumeric characters. For IPv4, the format of the IP address is xxx.xxx.xxx.xxx. For IPv6, the format of the IP address is :xxxx:xxxx:xxxx:xxx.xxx.xxx.xxx. CA GTS internally converts an IPv4 address to an IPv6 compatibility address. Code either HOSTADDR or HOSTNAME for each CA GTS connection, but not both.

PORT

Designates the numeric value of the port that CA GTS should use to connect to another CA GTS system; the value is four or five numerals in length and must be in the range 1024-65535. The port specification must match the definition made in the TCPIPS00 member of the 'other' CA GTS system. Ensure that this port does not conflict with any other product or the CA GTS systems cannot establish a successful connection. There is no default.

CA GTS attempts to connect to these addresses and ports for the purposes of routing requests.

KEY

Indicates the encryption key to use for this connection; encryption keys are 16 character hexadecimal. When specified, CA GTS uses the IBM Integrated Cryptographic Services Facility (ICSF) to encrypt traffic to this node. When not specified, or if ICSF is not available, the traffic between the nodes will not be encrypted.