TCP Parameter Card - ironstream_for_micro_focus_universal_discovery - 7.4

Ironstream for Micro Focus® Universal Discovery for IBM Z® Installation

Product type
Software
Portfolio
Integrate
Product family
Ironstream
Product
Ironstream > Ironstream for Micro Focus® Universal Discovery
Version
7.4
Language
English
Product name
Ironstream for Micro Focus Universal Discovery for IBM Z
Title
Ironstream for Micro Focus® Universal Discovery for IBM Z® Installation
Copyright
2022
First publish date
2007
ft:lastEdition
2023-11-28
ft:lastPublication
2023-11-28T05:42:35.385852

Identify port numbers and parameters for the TCP/IP connection to the Ironstream client.

Valid Values

Sample Syntax
TCP 6106 6107 BUFDD=BFR1,BFR2 ACK=5 LIMIT=20 HB=30 BINDIP=10.1.1.8 SERVERIP=10.1.1.0/2


Description
By default the use of TLS will expect the certificate used to include client authentication.  You can turn off this behavior by setting CLAUTH=N.  This feature was introduced in z/OS agents v7.3 patch 'G' and v7.4 patch 'F'.  For this feature to work you must be using an updated ev390mcs module that will show 'Version: 7.4.0.1' if you use the command:
ev390mcs.exe -version.

Parameters

Parameter

Description

mmsport

Port number opened on the mainframe for establishing a socket connection with the Master Message Server task on the Ironstream client. This number must match the EVOMF_HCI_AGENT_PORT value entered when adding the IBM Z node through the Ironstream Task Manager.

cmdport

Port number opened on the mainframe for establishing a socket connection with the Command Server task on the Ironstream client. This number must match the EVOMF_CMDS_AGENT_PORT value entered when adding the IBM Z node through the Ironstream Task Manager.

hlq

Optional, deprecated. High-level qualifier (hlq) for the mainframe TCP/IP datasets. This parameter is used to find the TCP/IP profile datasets, and is needed only if the default hlq is not used during TCP/IP installation.

The hlq must be identified on each card. The TCP subtask will not be initialized if the hlq is misstated.

BUFDD=dd1,dd2

Optional. The DD names of the two buffering datasets. These DD names must be listed in the VP390 startup job, and they must point to predefined datasets with DCB=(DSORG=PS,RECFM=V,LRECL=1663).

ACK=ack

Optional. The number of unsolicited mainframe messages that will be passed on to the Ironstream client before an acknowledgment is expected from the Ironstream client. By default, Ironstream will expect an acknowledgment after every 5 messages. If an acknowledgment is not received, the mainframe agent will resend all of the messages back to the last successful acknowledgment. Then, if the Ironstream client acknowledgment is still not received, the mainframe agent will close the TCP/IP connection and wait for a reconnect request. Upon reconnection, all unacknowledged messages back to the last successful acknowledgment will be resent to the Ironstream client. The ACK parameter is only valid if BUFDD is specified.

LIMIT=limit

Optional. The age limit (in minutes) of buffered messages that the mainframe agent will send to the Ironstream client. By default, messages read from the buffering files that are over 20 minutes old will not be forwarded to the Ironstream client. Set this value to 0 to receive all buffered messages regardless of their age. The LIMIT parameter is only valid if BUFDD is specified.

HB=hb

Optional. Length of time (in seconds) between heartbeat tests to verify the TCP/IP connection. By default, a short heartbeat message will be sent between the Ironstream client and the mainframe agent every 30 seconds.

BINDIP=bindaddr

Optional. An IPV4 dotted decimal address that names a specific mainframe IP address that the listening ports should bind to (useful at sites with multiple TCP/IP addresses defined in the same mainframe LPAR).

SERVERIP=servaddr

Optional. An IPV4 dotted decimal address that names a specific Proxy Server IP address that the listening ports will accept a connection from. servaddr must be specified in the nnn.nnn.nnn.nnn IP address format.

Additionally, the servaddr can be masked to allow a range of IP addresses to connect to the ports. To specify a mask, add a slash (/) after servaddr followed by either a dotted decimal maskaddr (e.g., 255.255.255.0) or a numerical maskprefix between 0-32 to represent the number of bits to be included in the mask starting from the leftmost bit (e.g.: "16" would be equivalent to 255.255.0.0).

TLS=Y|N|V

Optional. Enter "Y" to specify that TLS encryption should be used for connections between the mainframe and the Proxy server. By default, TLS encryption will not be used for the session.

Specify "V" to validate client certificates to verify that the address of the incoming connection request matches the DNS name specified in the certificate's Common Name. This option will require the DNS name of the Proxy server be resolvable by the mainframe. See Appendix B for instructions on using these options.

KEYF=filename1
STAF=filename2

Optional. The "KEYF", and "STAF" options are used when defining TLS encryption for the connection. These options are only valid when "TLS=Y" or "TLS=V" is specified. See Appendix B for instructions on using these options.