KN3 TCP Collector Status attributes

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:

0 = OK
1 = TCP AS NotFound
2 = TCP AS SwappedOut
3 = Proc Not TCP
4 = Collector ABENDED
5 = User Stopped Monitoring
99 = <blank>

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)

yy/mm/dd hh:mm:ss (3270)

Where:

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

This time is stored as a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (for example, 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

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:

0 = No
1 = Yes

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.

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:

0 = No
1 = Yes

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.

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:

0 = No
1 = Yes

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.

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 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. 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:

KN3_TCP_FTP_DSPINTV

KN3_TCPXnn_OVRD_FTP_DSPINTV

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:

0 = No
1 = Yes

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.

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:

0 = No
1 = Yes

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.

IPSEC Display Agent Access Displays the access type that the OMEGAMON for Networks agent user ID has to the EZB.NETMGMT.sysname.tcpprocname.IPSEC.DISPLAY resource of the SERVAUTH class. Read access is required in order to successfully collect IPSec data if the OMEGAMON for Networks on z/OS agent user ID is something other than 0. A valid value is an integer. Values appear on the workspace as follows:

0 = None
1 = Read
2 = Update
3 = Control
4 = Alter
5 = Execute

IPSEC Display Resource Defined Indicates whether resource EZB.NETMGMT.sysname.tcpprocname.IPSEC.DISPLAY is defined to the SERVAUTH class on the monitored system. sysname is the host name of the monitored system and tcpprocname is the proc name for the monitored TCP/IP stack. In order to control access to the local IPSec NMI display requests, the system administrator might have defined this resource. If so, the OMEGAMON for Networks on z/OS agent user ID has to be permitted to this resource in order to collect IPSec data. If the resource is not defined, the OMEGAMON for Networks on z/OS agent user ID must have a value of 0 and must be permitted to the BPX.SUPERUSER resource in the FACILITY class. A valid value is an integer. Values appear on the workspace as follows:

0 = No
1 = Yes

IPv4 Security Enabled Indicates whether IP security is enabled for IPv4 interfaces. A valid value is an integer. Values appear on the workspace as follows:

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. A valid value is an integer. Values appear on the workspace as follows:

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 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:

0 = No
1 = Yes

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 Express Direct SNMP Subagent Started Indicates whether the OSA Express Direct SNMP subagent is started. OSA data cannot be successfully collected if this has a value of No. A valid value is an integer. Values appear on the workspace as follows:

0 = No
1 = Yes

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:

0 = No
1 = Yes

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.

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:

0 = No
1 = Yes

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.

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:

0 = No
1 = Yes
2 = Unknown

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:

0 = No
1 = Yes
2 = Unknown

SMF Service Enabled Indicates whether the real-time SMF record information service is enabled. A valid value is an integer. Values appear on the workspace as follows:

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 TCP/IP stack. The real-time SMF record information service provides an interface for the monitoring agent to obtain information about FTP and TN3270 connections on this TCP/IP stack. To correct this problem, enable the real-time SMF record information service. For more information, see Enabling the z/OS Communications Server network management interface.

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 on z/OS 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 Format of the SNMP configuration file. 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:

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 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 Format of the SNMP configuration file.

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:

0 = Unknown
1 = Available

SNMP Version The version of the SNMP protocol that is used to send SNMP requests to the SNMP agent. The only value supported is snmpv2. 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 Format of the SNMP configuration file.

This attribute is blank for all monitored TCP/IP 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 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:

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 by using the KN3FCCMD START GLBS command or the KN3FCCMD STOP GLBS command.

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.

SYSTCPSM Agent Access Displays the access type that the OMEGAMON for Networks on z/OS agent user ID has to the EZB.NETMGMT.sysname.tcpprocname.SYSTCPSM resource of the SERVAUTH class. Read access is required in order to successfully collect TCP/IP data if the OMEGAMON for Networks on z/OS agent user ID is something other than 0. A valid value is an integer. Values appear on the workspace as follows:

0 = None
1 = Read
2 = Update
3 = Control
4 = Alter
5 = Execute

SYSTCPSM Resource Defined Indicates whether resource EZB.NETMGMT.sysname.tcpprocname.SYSTCPSM is defined to the SERVAUTH class on the monitored system. sysname is the host name of the monitored system and tcpprocname is the proc name for the monitored TCP/IP stack. In order to control access to the real-time SMF data NMI, the system administrator might have defined this resource. If so, the OMEGAMON for Networks on z/OS agent user ID has to be permitted to this resource in order to collect TCP/IP data. If the resource is not defined, the OMEGAMON for Networks on z/OS agent user ID must have a value of 0 and must be permitted to the BPX.SUPERUSER resource in the FACILITY class. A valid value is an integer. Values appear on the workspace as follows:

0 = No
1 = Yes

System ID The System Management Facility (SMF) system identifier for the z/OS system where the OMEGAMON for Networks on z/OS 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:

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

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.

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:

0 = No
1 = Yes

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:

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 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.

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:

0 = No
1 = Yes

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.

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:

0 = No
1 = Yes
2 = Unknown

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:

0 = No
1 = Yes
2 = Unknown

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.

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:

0 = No
1 = Yes
2 = Unknown

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:

0 = No
1 = Yes
2 = Unknown

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:

0 = No
1 = Yes
2 = Unknown