KN3 TCP Collector Status Attributes

Use the KN3 TCP Collector Status attributes to view configuration and status information about the IBM® Z OMEGAMON® AI for 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:

  • 0 = OK
  • 1 = TCP_AS_NotFound
  • 2 = TCP_AS_SwappedOut
  • 3 = Proc_Not_TCP
  • 4 = Collector_ABENDED
  • 5 = User_Stopped_Monitoring

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 (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)

Where:

  • mm = Month
  • dd = Day of the month
  • yy = Year
  • hh = Hour
  • mm = Minute
  • ss = Seconds

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:

  • C = Century (0 for 20th, 1 for 21st)
  • Y = Year
  • M = Month
  • D = Day
  • H = Hour
  • M = Minute
  • S = Second
  • m = Millisecond

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:

  • 0 = No
  • 1 = Yes

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 or the KN3_TCP_CONN PARMGEN parameter. The configured 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® Z OMEGAMON® AI for 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 during configuration. 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:

  • 0 = No
  • 1 = Yes

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 or the KN3_TCP_INTE PARMGEN parameter. This configured 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® Z OMEGAMON® AI for 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:

  • 0 = No
  • 1 = Yes

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 or the KN3_TCP_FTP PARMGEN parameter. The configured 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® Z OMEGAMON® AI for 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 during configuration. 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 or the KN3_TCP_FTP_DSPINTV PARMGEN parameter. The configured value can be modified while the monitoring agent is running using the DSPINTV parameter on the KN3FCCMD START FTP command. See the IBM® Z OMEGAMON® AI for 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 during configurationl.

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:

  • 0 = No
  • 1 = Yes

This parameter is defined by the Interface Statistics Collection value that was set in the Configuration Tool on the Specify Component Configuration panel or the KN3_TCP_INTS PARMGEN parameter. The configured 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® Z OMEGAMON® AI for 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:

  • 0 = No
  • 1 = Yes

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 or the KN3_TCP_IPSEC PARMGEN parameter. The configured 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® Z OMEGAMON® AI for 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 during configuration. 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:

  • 0 = No
  • 1 = Yes
  • 2 = Unknown

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:

  • 0 = No
  • 1 = Yes
  • 2 = Unknown

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:

  • 0 = No
  • 1 = Yes

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 or the KN3_TCP_COLLECT_STACK PARMGEN parameter.

Origin Node The unique identifier for the IBM® Z OMEGAMON® AI for Networks agent node on the navigation tree. The format is an alphanumeric string no longer than 32 characters.

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:

  • 0 = No
  • 1 = Yes

This parameter is defined by the OSA Statistics Collection value that was set in the Configuration Tool on the Specify Component Configuration panel or the KN3_TCP_OSA PARMGEN parameter. The configured 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® Z OMEGAMON® AI for 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:

  • 0 = No
  • 1 = Yes

This parameter is defined by the Routing Table Statistics Collection value that was set in the Configuration Tool on the Specify Component Configuration panel or the KN3_TCP_ROUTE_TBL PARMGEN parameter. The configured 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® Z OMEGAMON® AI for 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 during configuration. 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 or the KN3_TCP_ROUTE_TBL_FREQ PARMGEN parameter. The configured value can be modified while the monitoring agent is running using the FREQ parameter on the KN3FCCMD START ROUTE command. See the IBM® Z OMEGAMON® AI for 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 during configuration.

SMC-D Enabled Indicates whether the TCP/IP stack supports Shared Memory Communications via Direct Memory Access (SMC-D).  Valid values are: 
No=0 
Yes=1 
Unknown=2

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:

  • 0 = No
  • 1 = Yes
  • 2 = Unknown

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® Z OMEGAMON® AI for Networks: Planning and Configuration Guide chapter on Preparing your z/OS Environment.

SMC-R Enabled Indicates whether the TCP/IP stack supports Shared Memory Communications via Remote Direct Memory Access (SMC-R).  Valid values are: 
No=0 
Yes=1 
Unknown=2

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 IBM® Z OMEGAMON® AI for 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® Z OMEGAMON® AI for Networks: Planning and Configuration Guide.

This attribute is blank for all monitored stacks if one of these conditions is true:

  • There is a syntax error in the SNMP Configuration file.
  • The agent procedure JCL does not have a KN3SNMP DD statement specifying the name of the SNMP Configuration file or it does have a KN3SNMP DD but the file cannot be found or opened.

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® Z OMEGAMON® AI for 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® Z OMEGAMON® AI for Networks Configuration Guide.

This attribute is blank for all monitored stacks if one of these conditions is true:

  • There is a syntax error in the SNMP Configuration file.
  • The agent procedure JCL does not have a KN3SNMP DD statement specifying the name of the SNMP Configuration file or it does have a KN3SNMP DD but the file cannot be found or opened.

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:

  • 0 = No
  • 1 = Yes

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 using the KN3FCCMD START GLBS command or the KN3FCCMD STOP GLBS command. See the IBM® Z OMEGAMON® AI for 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.

System ID The SMF system ID. The format is an alphanumeric string no longer than 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. This value is stored as integer and displayed as a string. Valid values for this integer are:

  • 0 = NOT_FOUND
  • 1 = ACTIVE
  • 2 = TERMINATING
  • 3 = DOWN
  • 4 = STOPPED OR STOPPING
  • 5 = ABENDED
  • 99 = <blank>

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 IBM® Z OMEGAMON® AI for 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, or the KN3_TCPXnn_TCPIP_PROFILES_DSN and KN3_TCPXnn_TCPIP_PROFILES_MBR PARMGEN parameters.

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:

  • CS means Communications Server
  • V means version.
  • x identifies the version.
  • R means release.
  • yy identifies the release.

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 or the KN3_TCP_TN3270_DSPINTV PARMGEN parameter. The configured 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® Z OMEGAMON® AI for 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 during configuration.

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:

  • 0 = No
  • 1 = Yes

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 or the KN3_TCP_TN3270 PARMGEN parameter. The configured value can be modified while the monitoring agent is running using the KN3FCCMD START TN3270 command. See the IBM® Z OMEGAMON® AI for 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 during configuration. Once the TCP collector is started, this attribute displays the value that what was configured for the stack.

zERT Aggregation Enabled Indicates whether the TCP/IP stack is enabled for zERT aggregation.  Valid values are: 
No=0 
Yes=1 
Unknown=2
zERT Collection Indicates whether zERT data collection is enabled for the OMEGAMON Networks Agent. Valid values are: 
No=0 
Yes=1 
Unknown=2
zERT Detail Enabled Indicates whether retrieval of zERT Detail SMF information is enabled. Valid values are: 
No=0 
Yes=1 
Unknown=2
zERT Enabled Indicates whether the TCP/IP stack supports zERT.  Valid values are: 
No=0 
Yes=1 
Unknown=2
zERT Summary Enabled Indicates whether retrieval of zERT Summary SMF information is enabled. Valid values are: 
No=0 
Yes=1 
Unknown=2