Previous Topic: DISPLAY,SYSIDNext Topic: GENERIC(protocol,generic-name)


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

The GATEWAY control option defines 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 then passed all resource information from all other remote hosts that are connected to the local host. Likewise, all resource information that is received from the remote host is forwarded to all other remote hosts. This action lets the remote host communicate through the local host with all its other remote hosts without having a direct connection with them.

The following parameters must be entered:

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...]
: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 is specified with the PROTOCOL control option. If the port number is specified, it must be appended to the hostname or IP address which 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 delimiter.

  • 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 – The 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 using the default value.

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