TCP Interface Parameters

The TCP Interface member specifies the TCP Interface parameters so that Substation ES can communicate with Mainframe WebUI through this interface. The TCP Interface member template is stored in the SXSITCP file.

If you make a copy of this member, you can point to it by specifying the member name on the INTFMEMBER keyword in the main SIP definition member.

The following table lists the TCP Interface parameters supported by Substation ES.

TCP Interface Parameters
Parameter Description
CHUNK-BUFFERS = {0 | number} The CHUNK-BUFFERS parameter sets the number of buffers each “chunk of buffers” comprised by the TCP interface’s buffer pool. The valid values range from 1 to 100. The default value is 0.
CHUNK-MAX-SIZE = {64000 | number} The CHUNK-MAX-SIZE parameter sets the maximum number of bytes in each “chunk of buffers” comprised by the TCP interface’s buffer pool, The valid values range from 1024 to 4096000. The default value is 64000.
CONNECTIONS = {5 | number} The CONNECTIONS parameter sets the maximum number of open client connections. The valid values range from 1 to 500. The default value is 5.
DESCR = {description} See DESCR = {description}.
DISPATCHERS = {2 | number} The DISPATCHERS parameter is used to set the number of dispatcher worker for the TCP interface. The valid values range from 1 through 40. The default value is 2.
GSK-FILE = { | name} The name of the USS file to which GSK should write its trace; when GSK-FILE and TRCLVL-GSK are specified, the GSK library’s trace functions are enabled.
INTF-ID = {name} See INTF-ID = {name}.
INTF-TYPE = {number} See INTF-TYPE = {number}.
KEEP-ALIVE = {1 | number} The KEEP-ALIVE parameter indicates whether or not the keep-alive technique should be used to maintain idle connections. The valid values is 1 (True) and 0 (False). The default value is 1.
LAZY-RETRY = {60 | number} The LAZY-RETRY parameter sets the number of seconds between attempts to reconnect to a disconnected member of a multi-host connection. The valid values range from 1 to 600. The default value is 60.
LOGFILE-DDN = {S7RPRINT | DDName} The LOGFILE-DDN parameter specifies the DD name of the data set to which formatted TCP interface log information is written.

The number of characters from 1 to 8. If you do not specify a value, the default value applies.

SELECT-TO = {10 | number} The SELECT-TO parameter sets the timeout in seconds for the main TCP interface-related event loop. The valid values range from 0 to 50. The default value is 10.
STACK-NAME = { | name} The IBM stack name to be used with this TCP connection, and a blank value signifies the system default stack.
START-YN = {N | Yes, No} See START-YN = {Yes, No}.
URL = {URL:PORT} The URL parameter specifies the host name or the IP address and the TCP port that Substation ES exposes for WebUI clients to connect.

The default value is a blank space.

WEBUI-BUFFER-SIZE = {8192 | number} The WEBUI-BUFFER-SIZE parameter sets the maximum buffer size for messages returned by TCP Interface to WebUI. The valid values range from 8192 to 128000. The default value is 8192 bytes.
WORKERS = {2 | number} The WORKERS parameter specifies the number of concurrent worker subtasks that are started to service Substation ES TCP requests. The valid values range from 1 through 40. The default value is 2.
TLS-CIPHER = { | name} (Optional) The IBM cipher codes for encryption (for example: 35363738392F303132); if specified, overrides the default cipher specification list.
TLS-RING-FILE = { | name} The Resource Access Control Facility (RACF) key ring name; mandatory if using TLS.
TLS-RING-LABEL = { | name} (Optional) The RACF identity name; if not specified, the default certificate is used to make connections.
TRCLVL = {0 | 0-5} The TRCLVL parameter specifies the TCP Interface trace level when tracing payloads that pass through the interface; does not duplicate what is set on the system TRCLVL setting but only shows entries in TCP Interface.
The valid values are listed as follows:
  • Levels 1 to 3 show information mostly useful to users and TIBCO field staff.
  • Levels 4 and 5 show information only useful to engineering staff. The information is detailed and usually specific to internal stacks and control blocks.
TRCLVL-GSK = {0 | 0-63} The TRCLVL-GSK parameter specifies the trace level of the messages produced by TLS APIs; when TRCLVL-GSK and GSK-FILE are specified, the GSK library’s trace functions are enabled. The valid values range from 0 to 63. The default value is 0.