4.3.2 Description of GATEWAY TYPE=LOCAL Parameters

The GATEWAY TYPE=LOCAL statement uses the following parameters.

Parameter	Value	Description
LMID	logical-machine-id	Specifies a symbolic name (1-16 characters) that uniquely identifies this gateway/port. Note: Special characters are not supported.
PORT	port-number	Specifies the port number (decimal, 1-32,767) at which inbound connections from remote gateways are accepted. Choose a port number that is not in the range of well-known port numbers reserved for use by TCP/IP applications.
ACCOUNT	account-id|*	Specifies the account ID (1-8 characters) that must be specified by a remote gateway to establish a connection. If an account ID is not used, ACCOUNT=* should be specified. The account ID for connection validation is obsolete.
PASSWORD	password|*	Specifies the password (1-8 characters) that must be specified by a remote gateway to establish a connection. If a password is not used, PASSWORD=* should be specified. The password for connection validation is obsolete.
HOSTADDR	ip-address|hostname	Is the IP address or hostname for this machine over which inbound connections from remote gateways are accepted at the specified port number. The IP address is specified using standard dotted-decimal notation (for example, 199.203.45.99). The hostname is specified as a 1-256 character string and must match the DNS entry. Note: If any special characters, such as "-" are in the host address, quotes must be placed around the address name. Example: HOSTADDR="SIA-COTS" Default value: If this parameter is not specified, then connections are accepted over any network interface.
MAXMSGLEN	max-message-length|2048	Specifies the maximum TCP/IP message length that is accepted over the connection. The value range is 1-32,767. Default value: 2048
SESSIONS	(startup-sessions,max-sessions)|1	Is the maximum number of concurrent, active inbound sessions that is accepted by this gateway. The input format is (startup-sessions,max-sessions), where the startup-sessions represents the number of sessions to initiate at startup and max-sessions specifying the maximum concurrent, active, inbound sessions. The range for the max-sessions is 0-32,767. Default value: 1
IDLETIMEOUT	nn|0	Specifies the number of seconds that lapse before the local gateway terminates a session. Default value: 0
MULTIPLEX	nn|1	Is the maximum number of concurrent messages per session that is accepted by this gateway. Default value: 1
KEYRINGFILE	keyringfilename	Is the RACF certificates Key ring file name for this gateway over which inbound connections from remote gateways are accepted. If the key ring belongs to other users (for example, SYSSTC/RINGNAME), then the Key ring name needs to be specified with userid along with key ring. If key ring name belongs to same user, it can be specified as is (for example, RINGNAME). Note: Only the special character‘/’ when used with user id is supported for this field. No other special characters are supported.
KEYLABEL	keylabel	Is the RACF certificate Key label name for this gateway over which inbound connections from remote gateways are accepted. Key label needs to be specified for corresponding key ring file name used (for example, INT-TEST). Note: Maximum of 4 ‘-‘ are supported in Key label name. Only characters values are supported, numeric values are not supported. None of the existing configuration file keywords should be used (for example, IMS, MVS should not be present in key label name) if SSLFLAG is defined as SSL_ONE_WAY but the Default value is not specified , then connections are not accepted. Thus, the Default value field is mandatory if the SSLFLAG is set to SSL_ONE_WAY
SSLFLAG	sslflag	Is either TCP or SSL_ONE_WAY for this gateway over which inbound connections from remote gateways are accepted. Note: Default value: If this parameter is not specified, then connections are not accepted as SSL This field is mandatory to use for defining connections via SSL. No special characters or numbers are supported.