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

Desired communication protocol to be used.

LU0

LU0 is the communications protocol that the local host node to access the remote CAICCI node supports.

TCPIPGW

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

TCPSSLGW

TCPSSLGW is the communications protocol that 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 supports.

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

• For LU0 (or VTAM), netparm specifies the name that is 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 operand 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 can 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 connects to the remote host. It is only valid when specifying a protocol of TCPIPGW or TCPSSLGW. Specify the port number if the listening port of the remote host is different from the port number that the PROTOCOL control option specifies. If the port number is specified, it must be appended to the hostname or IP address that is 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 lists 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 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 CAICCI requires an SSL connection, a secure connection is permitted and made.

  DEFER | D – Connection type defers to the remote system: If the remote CAICCI supports and is enabled for SSL, 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

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 operand is a positional operand that requires two commas as a place holder when the default value is used.

A retry time of zero for a NODE generates the messages:

CAS9604W-CAICCI-INVALID RETRY TIME SPECIFIED

CAS9604W-CAICCI-NODE ENCOUNTERED ERRORS

sysid

Unique one through eight character identifier of the remote CAICCI system.

maxru

Maximum data packet size, which is 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

Control words that are used to specify when the session with the remote CAICCI is established and terminated.

START/SHUT (default)

Start link at CAICCI startup time. Drop link when CAICCI shuts down.

START/TERM

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

INIT/SHUT

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

INIT/TERM

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

Note: For z/OS, VM, and VSE, specify this operand as START/SHUT. Only select other available operands if the installation procedures of the CA solution you are installing specifically requests them.

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:1721,1)

CCI NODE(TCPSSLGW,,01,A93S)

Examples (ENFPARMS)

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

NODE(TCPIPGW,141.202.1.114:1721,1)

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