Use the KN3 TCP Collector Status attributes to view configuration and status information about the OMEGAMON for Networks on z/OS TCP collector.
Collection Status The completion status of the most recent collection cycle for this TCP/IP stack. If the TCP/IP stack was not designated for monitoring during configuration, this attribute value is blank, and the Monitor attribute in this table has a value of No. A valid value is an integer. Values appear on the workspace as follows:
Collection Time The time and date at which the status information was collected. This time is displayed in the following format:
mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)
Where:
This time is stored as a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:
Community Name The SNMP community string that acts like a user id or password that allows access to the SNMP agent's data. The community string is sent in each SNMP request. The SNMP agent validates the community string and only responds when the string is correct. A valid value is a string of up to 255 characters.
Connections and Applications Collection Indicates whether TCP/IP connection and application performance statistics are being collected for this TCP/IP stack. The TCP/IP network monitoring interface (NMI) collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_CONN and KN3_TCPXnn_OVRD_CONN PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START CONN command or the KN3FCCMD STOP CONN command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified during configuration. Once the TCP collector is started, this attribute displays the value that was configured for the TCP/IP stack.
Data Link Control Statistics Collection Indicates whether interface Data Link Control (DLC) statistics are being collected for this TCP/IP stack. The TCP/IP network monitoring interface (NMI) collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_INTE and KN3_TCPXnn_OVRD_INTE PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START INTE command or the KN3FCCMD STOP INTE command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute displays a value of No if TCP collection is not started. If TCP collection is stopped and restarted using the KN3FCCMD z/OS MODIFY commands, three collection cycles must pass before the value for this attribute reflects what is actually configured.
FTP Collection Indicates whether FTP statistics are being collected for this TCP/IP stack. The TCP/IP network monitoring interface (NMI) collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_FTP and KN3_TCPXnn_OVRD_FTP PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START FTP command or the KN3FCCMD STOP FTP command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified during configuration. Once the TCP collector is started, this attribute displays the value that was configured for the TCP/IP stack.
FTP Data Display Interval Determines how long, in hours, FTP data will be displayed in the Tivoli Enterprise Portal or OMEGAMON Enhanced 3270 user interfaces. The value is set based on the value of the KN3_TCP_FTP_DSPINTV and KN3_TCPXnn_OVRD_FTP_DSPINTV PARMGEN parameters. A value of 1 means that FTP data is displayed for one hour. The default is 2 hours. A valid value is an integer. The range for this value is from 1 to 24.
The configured value can be modified while the monitoring agent is running by using the DSPINTV parameter on the KN3FCCMD START FTP command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute will have a value of 0 (zero) when the TCP collector is not started, regardless of what value was specified during configuration.
Host Name The TCP host name of the monitored TCP/IP stack as specified in the HOSTNAME statement of the TCPIP DATA configuration file for the TCP/IP stack. See the IBM z/OS Communications Server: IP Configuration Reference for more about the format of this name and what name can be substituted if the HOSTNAME statement is not specified in the TCPIP.DATA file. A valid value is a string of up to 255 characters.
Interface Statistics Collection Indicates whether Interface statistics are being collected for this TCP/IP stack. The TCP/IP network monitoring interface (NMI) collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_INTS and KN3_TCPXnn_OVRD_INTS PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START INTS command or the KN3FCCMD STOP INTS command. For more information, see the IBM Knowledge Center for IBM OMEGAMON for Networks on z/OS.
This attribute displays a value of No if TCP collection is not started. If TCP collection is stopped and restarted using the KN3FCCMD z/OS MODIFY commands, three collection cycles must pass before the value for this attribute reflects what is actually configured.
IP Address The IP address used to locate SNMP configuration information for this TCP/IP stack, as defined by the TCP Collector SNMP Parameter Dataset Name attribute in the Agent Status attribute group. This IP address is the default local IP address of the host where the monitored TCP/IP stack is running. This address is specified using the PRIMARYINTERFACE statement or the first address in the HOME list of the TCP/IP profile (PROFILE.TCPIP). See the IBM z/OS Communications Server: IP Configuration Reference for more information about these statements. A valid value is a string of up to 45 characters.
IP Security Collection Indicates whether IP security statistics are being collected for this TCP/IP stack. The TCP/IP network monitoring interface (NMI) collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_IPSEC and KN3_TCPXnn_OVRD_IPSEC PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START IPSEC command or the KN3FCCMD STOP IPSEC command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified during configuration. Once the TCP collector is started, this attribute displays the value that was configured for the TCP/IP stack.
Monitor Indicates whether monitoring is enabled for this TCP/IP stack. The value is set based on the value of the KN3_TCP_COLLECT_STACK and KN3_TCPXnn_OVRD_COLLECT_STACK PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
Origin Node The unique identifier for the OMEGAMON for Networks on z/OS agent node on the navigation tree. A valid value is a string of up to 32 characters.
OSA Statistics Collection Indicates whether OSA statistics are being collected for this TCP/IP stack. The SNMP manager collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_OSA and KN3_TCPXnn_OVRD_OSA PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START OSA command or the KN3FCCMD STOP OSA command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute displays a value of No if TCP collection is not started. If TCP collection is stopped and restarted using the KN3FCCMD z/OS MODIFY commands, three collection cycles must pass before the value for this attribute reflects what is actually configured.
Routing Table Collection Indicates whether routing table statistics are being collected for this TCP/IP stack. The TCP/IP network monitoring interface (NMI) collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_ROUTE_TBL and KN3_TCPXnn_OVRD_ROUTE_TBL PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START ROUTE command or the KN3FCCMD STOP ROUTE command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified during configuration. Once the TCP collector is started, this attribute displays the value that was configured for the TCP/IP stack.
Routing Table Collection Frequency The number of TCP collection intervals to wait between routing table statistics collections. The value is set based on the value of the KN3_TCP_ROUTE_TBL_FREQ and KN3_TCPXnn_OVRD_ROUTE_TBL_FREQ PARMGEN parameters. A value of 1 means that routing information is collected every collection interval. A value of 2 means that routing information is collected every other collection interval. The default value is 10. A valid value is an integer. The range for this value is from 1 to 99.
SMC-D Enabled Indicates whether the TCP/IP stack supports Shared Memory Communications - Direct Memory Access (SMC-D). A valid value is an integer. Values appear on the workspace as follows:
SMC-R Enabled Indicates whether the TCP/IP stack supports Shared Memory Communications over Remote Direct Memory Access (SMC-R). A valid value is an integer. Values appear on the workspace as follows:
SNMP Agent Jobname The job name for the application that is bound to the SNMP agent port for this TCP/IP stack. The SNMP agent port is specified in the OMEGAMON for Networks SNMP configuration file. When no SNMP agent port definition is found in the SNMP configuration file for this TCP/IP stack or no application is bound to the port, then a blank jobname and a status of Unknown is displayed. A blank jobname and status of Unknown can also mean that the monitoring agent encountered an error in retrieving data. A valid value is a string of up to 8 characters.
SNMP Agent Port
The port used to connect to the SNMP agent.
The value is obtained from the TCP Collector SNMP Parameter Dataset. For more information,
see the Format of the SNMP configuration file
topic in the IBM
Documentation for IBM OMEGAMON for Networks on z/OS.
A valid value is a string of up to 5 characters.
This attribute is blank for all monitored TCP/IP stacks if one of these conditions is true:
This attribute is blank for a specific TCP/IP stack if the IP Address displayed for the TCP/IP stack
cannot be found in the SNMP Configuration file. For more information, see the Format of the SNMP configuration
file
topic in the IBM Documentation for IBM OMEGAMON for Networks on
z/OS.
SNMP Agent Status Indicates whether the SNMP Agent port is known by TCP/IP and an application is bound to the SNMP agent port. When no SNMP agent port definition is found in the SNMP configuration file for this TCP/IP stack or no application is bound to the port, a status of Unknown is displayed. A status of Unknown can also mean that the monitoring agent encountered an error in retrieving data. A valid value is an integer. Values appear on the workspace as follows:
SNMP Version The version of the SNMP protocol that is used to send SNMP requests to the SNMP agent. The supported values are snmpv2 and snmpv3. A valid value is a string of up to 8 characters.
This parameter is obtained from the TCP Collector SNMP Parameter Dataset. For more information,
see the Format of the SNMP configuration file
topic in the IBM Documentation
for IBM OMEGAMON for Networks on z/OS.
This attribute is blank for all monitored TCP/IP stacks if one of these conditions is true:
This attribute is blank for a specific TCP/IP stack if the IP Address displayed for the TCP/IP stack cannot be found in the SNMP Configuration file.
Stack Layer Statistics Collection Indicates whether Stack Layer statistics are being collected for this TCP/IP stack. The TCP/IP network monitoring interface (NMI) collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_GLBS and KN3_TCPXnn_OVRD_GLBS PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
This parameter is defined by the TCP/IP Stack Layer Statistics Collection value that was set in the Configuration Tool on the "Specify Component Configuration" panel or the KN3_TCP_GLBS PARMGEN parameter. The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START GLBS command or the KN3FCCMD STOP GLBS command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute displays a value of No if TCP collection is not started. If TCP collection is stopped and restarted using the KN3FCCMD z/OS MODIFY commands, three collection cycles must pass before the value for this attribute reflects what is actually configured.
Sysplex Name The name of the sysplex that this LPAR is a member of. A valid value is a string of up to 8 characters.
System ID The System Management Facility (SMF) system identifier for the z/OS system where the OMEGAMON for Networks monitoring agent collected the data. A valid value is a string of up to 4 characters.
TCPIP Address Space Status The status of the TCP/IP address space the last time that TCP data was collected for this TCP/IP stack. A valid value is an integer. Values appear on the workspace as follows:
The value is blank when data is not being collected for this TCP/IP stack. If the TCP/IP stack was not designated for monitoring during configuration, the Monitor attribute in this table has a value of No.
TCPIP Procedure Name The name specified on the PROC or JOB statement of the JCL used to start the TCP/IP procedure. A valid value is a string of up to 8 characters.
The value is blank when data is not being collected for this TCP/IP stack. If the TCP/IP stack was not designated for monitoring during configuration, the Monitor attribute in this table has a value of No.
TCPIP Profile Data Set Name The name of the data set that contains the TCP/IP profile. The value is based on the KN3_TCPXnn_TCPIP_PROFILES_DSN and KN3_TCPXnn_TCPIP_PROFILES_MBR PARMGEN parameters. This data set can be either a partitioned data set or a sequential data set. Sequential data set names are expressed as a sequence of period-separated qualifiers. Partitioned data sets are expressed as a sequence of period-separated qualifiers ending with a member enclosed in parentheses. A valid value is a string of up to 54 characters.
TCPIP SNMP Subagent Started Indicates whether the TCP/IP SNMP subagent is started. Interfaces, gateways, and devices data cannot be collected if this has a value of No. A valid value is an integer. Values appear on the workspace as follows:
TCPIP Version
The version and release of the TCP/IP stack.
A valid value is an 8-character string with a value of CS VxRyy
, where:
Leading zeros are not displayed in the release identifier. For example, if the version for the a selected TCP/IP stack is 2 and the release is 3, "CS V2R3" is displayed.
TN3270 Data Display Interval Determines how long, in hours, TN3270 server statistics will be displayed in the Tivoli Enterprise Portal or OMEGAMON Enhanced 3270 user interfaces. The value is set based on the value of the KN3_TCP_TN3270_DSPINTV and KN3_TCPXnn_OVRD_TN3270_DSPINTV PARMGEN parameters. A value of 1 means that TN3270 data is displayed for one hour. The default is 2 hours. A valid value is an integer. The range for this value is from 1 to 24.
The configured value can be modified while the monitoring agent is running by using the DSPINTV parameter on the KN3FCCMD START TN3270 command or the KN3FCCMD STOP TN3270 command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute will have a value of 0 (zero) when the TCP collector is not started, regardless of what value was specified during configuration.
TN3270 Server Collection Indicates whether TN3270 server statistics are being collected for this TCP/IP stack. The TCP/IP network monitoring interface (NMI) collects this data once every TCP collection interval. The value is set based on the value of the KN3_TCP_TN3270 and KN3_TCPXnn_OVRD_TN3270 PARMGEN parameters. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START TN3270 command or the KN3FCCMD STOP TN3270 command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified during configuration. Once the TCP collector is started, this attribute displays the value that was configured for the TCP/IP stack.
zERT Aggregation Enabled Indicates whether z/OS Encryption Readiness Technology aggregation function has been enabled on this TCP/IP stack. A valid value is an integer. Values appear on the workspace as follows:
zERT Collection Indicates whether z/OS Encryption Readiness Technology (zERT) statistics are being collected for this TCP/IP stack. The value is set based on the value of the KN3_TCP_ZERT and KN3_TCPXnn_OVRD_ZERT PARMGEN parameters. This will have a value of No when zERT collection is not started. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START ZERT command or the KN3FCCMD STOP ZERT command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified during configuration. Once the TCP collector is started, this attribute displays the value that was configured for the TCP/IP stack.
zERT Detail Enabled Indicates whether the real-time zERT Detail SMF information service is enabled. A valid value is an integer. Values appear on the workspace as follows:
zERT Enabled Indicates whether the TCP/IP stack supports z/OS Encryption Readiness Technology (zERT). A valid value is an integer. Values appear on the workspace as follows:
zERT Summary Enabled Indicates whether the real-time zERT Summary SMF information service is enabled. A valid value is an integer. Values appear on the workspace as follows: