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

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

The GATEWAY 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.

By specifying a GATEWAY rather than a NODE control option for a particular remote host, the remote host is subsequently passed all resource information from all other remote hosts that are connected to the local host. Likewise, all resource information received from the remote host is forwarded to all other remote hosts. This allows the remote host to communicate through the local host with all its other remote hosts without having a direct connection with them.

The following parameters must be entered with the GATEWAY control option:

• protocol
• netparm
• retry
• sysid

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 on IPv6 address identification, 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.

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

Specifies 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 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.

netparm2

For VTAM and LU0, specifies 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 each other.

Examples (console)

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

CCI GATEWAY(TCPIPGW,IPGW73:7000,01,A73SYSID)

CCI GATEWAY(TCPSSLGW,,01,A93S)

CCI GATEWAY(TCPSSLGW,USILCA31;S=NO,1,A31ENF)

Examples (ENFPARMS)

GATEWAY(LU0,A73CVC01,10,A73SYSID,4000,START/SHUT)

GATEWAY(LU0,A73CVC01,,A73SYSID,4000,START/SHUT)