Use the KN3 TCP Collector Status attributes to view configuration and status information about the OMEGAMON XE for Mainframe Networks TCP collector.
Collection Status The completion status of the most recent collection cycle for this TCP/IP stack. This value is stored as an integer and displayed as a string. Valid values for this integer are:
If the stack was not designated for monitoring during configuration, then this attribute value is blank, and the Monitor attribute in this table has a value of No.
Collection Time The time and date at which status information was collected. This time is displayed in the following format:
mm/dd/yy hh:mm:ss
Where:
The stored format is a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:
Connections and Applications Collection Indicates whether TCP/IP connection and application performance statistics are being collected for this stack. This value is stored as an integer and displayed as a string. Valid values for this integer are:
This parameter is defined by the TCP/IP Connection and Application Performance Statistics Collection value that was set in the Configuration Tool on the "Specify Component Configuration (Page 2)" panel. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START CONN command or the KN3FCCMD STOP CONN command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified using the Configuration Tool. Once the TCP collector is started, this attribute displays the value that what was configured for the stack.
Data Link Control Statistics Collection Indicates whether interface Data Link Control (DLC) statistics are to be collected for this stack. This value is stored as an integer and displayed as a string. Valid values are:
This parameter is defined by the Interface Data Link Control Statistics Collection:value that was set in the Configuration Tool on the "Specify Component Configuration" panel. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START INTE command or the KN3FCCMD STOP INTE command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
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 stack. This value is stored as an integer and displayed as a string. Valid values for this integer are:
This parameter is defined by the FTP Data Collection value that was set in the Configuration Tool on the "Specify Component Configuration (Page 2)" panel. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START FTP command or the KN3FCCMD STOP FTP command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified using the Configuration Tool. Once the TCP collector is started, this attribute displays the value that what was configured for the stack.
FTP Data Display Interval Determines how long FTP data will be displayed on the Tivoli Enterprise Portal for this address space. A value of “1" means that FTP data is displayed for one hour. This value is expressed as a whole number in hours from 1 to 24. The default is 2 hours.
This interval is defined by the FTP Data Display Interval value that was set in the Configuration Tool on the "Specify Component Configuration (Page 2)" panel. The Configuration Tool value can be modified while the monitoring agent is running using the DSPINTV parameter on the KN3FCCMD START FTP command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
This attribute will have a value of 0 (zero) when the TCP collector is not started, regardless of what value was specified using the Configuration Tool.
Host Name The TCP host name of the monitored stack as specified in the HOSTNAME statement of the TCPIP.DATA configuration file for the stack. The format is an alphanumeric character string of up to 255 characters. 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.
Interface Statistics Collection Indicates whether interface statistics are to be collected for this stack. This value is stored as an integer and displayed as a string. Valid values are:
This parameter is defined by the Interface Statistics Collection value that was set in the Configuration Tool on the "Specify Component Configuration" panel. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START INTS command or the KN3FCCMD STOP INTS command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
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 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.
IP Security Collection Indicates whether IP security statistics are being collected for this stack. This value is stored as an integer and displayed as a string. Valid values for this integer are:
This parameter is defined by the IP Filters and IPSec Tunnels Statistics Collection value that was set in the Configuration Tool on the "Specify Component Configuration (Page 2)" panel. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START IPSEC command or the KN3FCCMD STOP IPSEC command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified using the Configuration Tool. Once the TCP collector is started, this attribute displays the value that what was configured for the stack.
IPv4 Security Enabled Indicates whether IP security is enabled for IPv4 interfaces. This value is stored as an integer and displayed as a string. Valid values for this integer are:
A value of Unknown means that the status could not be determined due to an internal error in the agent. If you see this value, contact IBM Software Support.
IPv6 Security Enabled Indicates whether IP security is enabled for IPv6 interfaces. This value is stored as an integer and displayed as a string. Valid values for this integer are:
A value of Unknown means that the status could not be determined due to an internal error in the agent. If you see this value, contact IBM Software Support.
Monitor Indicates whether monitoring is enabled for this stack. This value is stored as an integer and displayed as a string. Valid values for this integer are:
This parameter is defined by the "Do you want to monitor this stack?" value that was set in the Configuration Tool on the Add/Copy/Update TCP/IP Monitored Systems Info panels.
Origin Node The unique identifier for the Mainframe Networks agent node on the navigation tree. The format is an alphanumeric string no longer than 32 characters in this format: agentProcName:SMFID:KN3AGENT. This field is not displayed.
OSA Statistics Collection Indicates whether OSA statistics are to be collected for this stack. This value is stored as an integer and displayed as a string. Valid values are:
This parameter is defined by the OSA Statistics Collection value that was set in the Configuration Tool on the "Specify Component Configuration" panel. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START OSA command or the KN3FCCMD STOP OSA command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
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 stack. This value is stored as an integer and displayed as a string. Valid values for this integer are:
This parameter is defined by the Routing Table Statistics Collection value that was set in the Configuration Tool on the "Specify Component Configuration" panel. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START ROUTE command or the KN3FCCMD STOP ROUTE command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified using the Configuration Tool. Once the TCP collector is started, this attribute displays the value that what was configured for the stack.
Routing Table Collection Frequency The number of TCP collection intervals to wait between routing table statistics collections. 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. This format is a whole number from 1 to 99 inclusive. The default value is 10.
This interval is defined by the Routing Table Collection Frequency value that was set in the Configuration Tool on the "Specify Component Configuration (Page 2)" panel. The Configuration Tool value can be modified while the monitoring agent is running using the FREQ parameter on the KN3FCCMD START ROUTE command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
This attribute will have a value of 0 (zero) when the TCP collector is not started, regardless of what value was specified using the Configuration Tool.
SMF Service Enabled Indicates whether the real-time SMF record information service is enabled. This value is stored as an integer and displayed as a string. Valid values for this integer are:
A value of Unknown means that the status could not be determined due to an internal error in the agent. If you see this value, contact IBM Software Support.
If the value of this attribute is No, verify that the real-time SMF record information service function is enabled for this stack. The real-time SMF record information service provides an interface for the monitoring agent to obtain information about FTP and Telnet connections on this stack. To correct this problem, enable the real-time SMF record information service. See the ‘Enabling FTP and TN3270 monitoring' topic in the IBM Tivoli OMEGAMON XE for Mainframe Networks: Planning and Configuration Guide chapter on "Preparing your z/OS Environment."
Note that it is possible for this attribute to have a value of Yes, indicating that the SMF Service is enabled, but z/OS might not be capable of collecting IP security data if the address space you are monitoring is running z/OS v1.8. If your z/OS level is 1.8, the SMF Service is not capable of collecting IP security data unless you apply a PTF to z/OS. For information about the prerequisite PTF refer to the IBM Tivoli OMEGAMON XE for Mainframe Networks: Program Directory.
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 XE for Mainframe Networks SNMP configuration file. If no application is bound to the port or no SNMP agent port definition was found in the SNMP configuration file for this TCP/IP stack, then a value of UNKNOWN is displayed. A status of UNKNOWN can also mean that the monitoring agent encountered an error in retrieving data. The format is an 8-character string.
SNMP Agent Port The port used to connect to the SNMP agent. The format is a string of up to 5 characters. This parameter is obtained from the TCP Collector SNMP Parameter Dataset. For more information, see the "Format of the SNMP configuration file" appendix in the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide.
This attribute is blank for all monitored stacks if one of these conditions is true:
This attribute is blank for a specific stack if the IP Address displayed for the stack cannot be found in the SNMP Configuration file. For more information, see the "Format of the SNMP configuration file" appendix in the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide.
SNMP Version The version of the SNMP protocol that is used to send SNMP requests to the SNMP agent. The format is a string of up to 8 characters. The only value supported is snmpv2.
This parameter is obtained from the TCP Collector SNMP Parameter Dataset. For more information, see the "Format of the SNMP configuration file" appendix in the IBM Tivoli OMEGAMON XE for Mainframe Networks Configuration Guide.
This attribute is blank for all monitored stacks if one of these conditions is true:
This attribute is blank for a specific stack if the IP Address displayed for the stack cannot be found in the SNMP Configuration file.
Stack Layer Statistics Collection Indicates whether stack layer statistics are to be collected for this stack. This value is stored as an integer and displayed as a string. Valid values are:
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. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START GLBS command or the KN3FCCMD STOP GLBS command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
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 the monitored system is part of. The format is a string of up to 8 characters. This field is not displayed.
System ID The SMF system ID. The format is an alphanumeric string no longer than 4 characters. This field is not displayed.
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. This value is stored as integer and displayed as a string. Valid values for this integer are:
The attribute is blank if data is not being collected for the stack. If the 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. The OMEGAMON XE for Mainframe Networks monitoring agent has been configured to monitor this TCP/IP address space. The format is a string of up to 8 characters.
TCPIP Profile Dataset Name The name of the data set that contains the TCP/IP profile. This data set can be either a partitioned data set or a sequential data set. The format is a string of up to 54 characters. 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 name enclosed in parentheses.
This parameter is defined by the "TCP/IP profile dataset name" and "Member name" values that were set in the Configuration Tool on the Add/Copy/Update TCP/IP Monitored Systems Info panels in the Configuration Tool.
TCPIP Version The version and release of the stack. The format is an 8-character string with a value of CS VxRyy. The characters in this string are defined as follows:
Leading zeros are not displayed in the release identifier. For example, if the version for the a selected stack is 1 and the release is 9, then the string "CS V1R9" is displayed. However, if the version is 1 and the release is 10, then "CS V1R10" is displayed.
TN3270 Data Display Interval Determines how long TN3270 server statistics are displayed on the Tivoli Enterprise Portal. This value is expressed as a whole number in hours from 1 to 24. The default is 2 hours.
This interval is defined by the TN3270 Data Display Interval value that was set in the Configuration Tool on the "Specify Component Configuration (Page 2)" panel. The Configuration Tool value can be modified while the monitoring agent is running using the DSPINTV parameter on the KN3FCCMD START TN3270 command or the KN3FCCMD STOP TN3270 command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
This attribute will have a value of 0 (zero) when the TCP collector is not started, regardless of what value was specified using the Configuration Tool.
TN3270 Server Collection Indicates whether TN3270 server statistics are being collected for this stack. This value is stored as integer and displayed as a string. Valid values for this integer are:
This parameter is defined by the TN3270 Server Statistics Collection value that was set in the Configuration Tool on the "Specify Component Configuration (Page 2)" panel. The Configuration Tool value can be modified while the monitoring agent is running using the KN3FCCMD START TN3270 command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.
This attribute will have a value of No when the TCP collector is not started, regardless of what value was specified using the Configuration Tool. Once the TCP collector is started, this attribute displays the value that what was configured for the stack.