CAICCI Control Options › Control Options Summary - CAICCI › NODE(protocol,netparm,retry,sysid,maxru,start/stop,netparm2)

NODE(protocol,netparm,retry,sysid,maxru,start/stop,netparm2)

The NODE control option is used to define a remote CAICCI node to the local host. The default values are: retry=10, maxru=4096, start/stop=START/SHUT.

The following parameters must be entered:

• protocol
• netparm
• retry
• sysid

Separate multiple options with commas.

protocol

Specifies the desired communication protocol to be used. Possible values are:

LU0

LU0 is the communications protocol supported by the local host node to access the remote CAICCI node.

TCPIPGW

TCPIPGW is the communications protocol supported by the local host node to access the remote host node using IBM TCP/IP or CA TCPaccess Communications Server for z/OS.

TCPSSLGW

TCPSSLGW is the communications protocol supported by the local host node to access the remote host node using IBM TCP/IP or CA TCPaccess Communications Server for z/OS with Secure Sockets layer (SSL) support.

netparm[:port][;keyword=value...]

• For LU0 (or VTAM), netparm specifies the name defined in VTAMLST (as a cross-domain resource) that the remote CAICCI uses as its APPLID.
• For TCPIPGW or TCPSSLGW, netparm specifies the TCP/IP Hostname or address of the remote CAICCI host. This is a positional operand that requires two commas as a place holder if it is not specified. When not specified, the IP information is obtained from the remote CAICCI specified by the sysid operand.

  The IP address may be specified in IPv6 format. For information in IPv6 addressing, see the notes in CAICCI Control Option Summary.

:port

The port operand specifies the port number on which the gateway will connect to the remote host. It is only valid when specifying a protocol of either TCPIPGW or TCPSSLGW. The port number needs to be specified if the listening port of the remote host is different than the port number specified with the PROTOCOL control option. If the port number is specified, it must be appended to the hostname or IP address prefixed with a colon(:).

;keyword=value

The keyword operand specifies SSL Keywords and their values. It is only valid when specifying a protocol of either TCPIPGW or TCPSSLGW. Each keyword=value must be prefixed with a semi-colon (;).

The following is a list of valid keywords, their abbreviations, and allowable values (case insensitive). Each keyword=value parameter must be prefixed with a semicolon (;) as a delimeter.

• SECURE | SEC | S =

  Indicates whether or not to request an SSL (secured) connection (default is set from the PROTOCOL UNSECURED_CONNECT setting):

  YES | Y - Connection must be secure. If the remote system does not support or is not enabled for SSL, the connection request fails.

  ALLOW | A – An unsecured connection is allowed and requested. If the remote CCI REQUIRES an SSL connection, then a secure connection is permitted and made.

  DEFER | D – Connection type defers to the remote system: If the remote CCI supports and is enabled for SSL, then it connects securely; otherwise the connection is made unsecured.

  NO | N - Only unsecured connections allowed. If the remote system REQUIRES an SSL connection, the connection request fails.

retry

Specifies the re-poll time in minutes that CAICCI uses to attempt to re-establish a session with the remote CAICCI using the netparm specified. This time ranges from 1 to 59 minutes. This operand has a default value of 10. This is a positional operand that requires two commas as a place holder when the default value is to be used.

A retry time of zero for a NODE will generate the messages:

CAS9604W-CAICCI-INVALID RETRY TIME SPECIFIED

CAS9604W-CAICCI-NODE ENCOUNTERED ERRORS

sysid

Specifies the unique 1 to 8 character identifier of the remote CAICCI system.

maxru

Specifies the maximum data packet size, specified in decimal bytes, that is allowed to be transmitted between the local CAICCI and this remote CAICCI node.

The default MAXRU value is 4096 or the value set by the MAXRU control option.

start/stop

The control words used to specify when the session with the remote CAICCI is to be established and terminated.

Acceptable values are:

START/SHUT

Start link at CAICCI startup time. Drop link when CAICCI shuts down. START/SHUT is the default.

START/TERM

Start link at CAICCI startup time. Drop link when the first CA application issues a CAICCI TERM.

INIT/SHUT

Start link when the first CA application issues a CAICCI INIT. Drop link when CAICCI shuts down.

INIT/TERM

Start link when the first CA application issues a CAICCI INIT. Drop link when the first CA application issues a CAICCI TERM.

Note: For z/OS, VM, and VSE, this operand should be specified as START/SHUT. Other operands available are shown but should not be selected unless specifically requested by the installation procedures of the CA solution you are installing.

netparm2

For LU0, this is the logmode name for assigning a class of service (COS) to the session with the remote CAICCI node.

Important! The operands STOP and SHUT are fully compatible and can be substituted for one another.

Examples (console)

CCI NODE(LU0,A73CVC01,01,A73SYSID,4000,START/SHUT)

CCI NODE(TCPIPGW,141.202.1.114:7000,1)

CCI NODE(TCPSSLGW,,01,A93S)

Examples (ENFPARMS)

NODE(LU0,A73CVC01,01,A73SYSID,4000,START/SHUT)

NODE(TCPIPGW,141.202.1.114:7000,1)

NODE(TCPSSLGW,USILCA11:1721;SECURE=D,1,ALLSENF)