KN3 SNA Collector Status Attributes
Use the KN3 SNA Collector Status attributes to view configuration and status information about the IBM Z OMEGAMON Network Monitor SNA collector.
Agent VTAM® Application Name The name of the agent VTAM application that acts as a secondary program operator. The default value is CTDN3SP, which is the application name in the CTDN3N member of the RKANSAMU data set. The format is an 8-character string.
This VTAM application must be defined to VTAM and have a status of ACTIVE before the VTAM environment and buffer pool data can be collected successfully. If the SNA Collection Started attribute in the Agent Status Attribute table has a value of No, indicating that the SNA collector is not started, this field will be blank.
Agent VTAM Application Status Indicates the current status of the VTAM application used by the agent to collect VTAM buffer pool and environment data. This value is stored as an integer and displayed as a string. The following are valid values:
- 0 = Unknown
- 1 = CONCT (Connectable)
- 2 = ACTIV (Active)
- 3 = INACT (Inactive)
The status strings displayed for this attribute match the status
strings displayed by the DISPLAY NET
command. CONCT,
ACTIV, and INACT are the values expected most of the time. Less
common, transient states are represented by displaying a value of
Unknown. If a value of Unknown is displayed, issue a DISPLAY
NET
command to verify the actual status of the resource.
If the SNA Collector Status column of the Agent Status table has a value of Yes, then a value other than ACTIV for this attribute means that you need to take one of the following actions, depending on the value of this attribute:
- Unknown: Activate the agent VTAM major node
- INACT: Activate the agent VTAM application
- CONCT: Check the RKLVLOG for error messages indicating why the VTAM application access control block (ACB) cannot be opened.
If the SNA Collector Status column of the Agent Status table has a value of No, then the value in this column will be Unknown. If you want to collect VTAM buffer pool and environment data, start SNA data collection. Refer to the description of the SNA Collection Started attribute in the Agent Status table for information about why SNA data collection is not started.
Note: A value of Unknown might be the result of an internal error. If you think this is the case, contact IBM® Software Support.
Agent VTAM Major Node Name The name of a dataset member that contains the definition of a VTAM major node that defines the application used by the agent to collect VTAM buffer pool and environment data. The member must be on the VTAMLST concatenation list. By default the name of the member is CTDN3N. A sample that can be copied to VTAMLST is available in the RKANSAMU dataset. The format is an 8-character string.
This major node must be active for VTAM buffer pool and environment data to be successfully collected. If the value of the Agent VTAM Application Name is blanks, the value of this attribute will also be blanks.
Agent VTAM Major Node Status Indicates the current status of the agent VTAM major node. This value is stored as an integer and displayed as a string. The following are valid values:
- 0 = Unknown
- 1 = ACTIV (Active)
The status string ACTIV displayed for this attribute matches the
status string displayed by the DISPLAY NET
command.
Less common, transient states are represented by displaying a value
of Unknown. If a value of Unknown is displayed, issue a DISPLAY
NET
command to verify the actual status of the resource.
If a value of Unknown is displayed because the VTAM major node is inactive, and you would like to collect VTAM buffer pool and environment data, activate the VTAM major node that defines the application identified by the Agent VTAM Application Name attribute. For more information on how to activate the VTAM major node using the sample provided, see the IBM Z OMEGAMON Network Monitor: Configuration Guide.
Note: A value of Unknown might be the result of an internal error. If you think this is the case, contact IBM Software Support.
ALL HPR Collection Indicates whether statistics are being collected for all high performance routing (HPR) connections. This value is stored as an integer and displayed as a string. The following are valid values:
- 0 = No
- 1 = Yes
If the value for this attribute is No, then data is only collected for only those HPR connections that flow data over Enterprise Extender (EE) connections.
This parameter is defined by the All High Performance Routing Connections value that was set in
the Configuration Tool on the Specify Component Configuration (Page 3)
panel or the
KN3_TCP_ALLHPR PARMGEN parameter. The configured value can be modified while the monitoring agent is
running using the ALLHPR parameter on the KN3FCCMD START EEHPR command. See the IBM Z OMEGAMON Network Monitor: 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.
Buffer Pool And VTAM Environment Collection Indicates whether VTAM buffer pool and environment statistics are being collected. The SNA collector assembles this data once every SNA collection interval. This value is stored as an integer and displayed as a string. The following are valid values:
- 0 = No
- 1 = Yes
If the value for this attribute is Yes, then data for VTAM buffer pools, applications, extents, and address spaces is being collected. This
parameter is defined by the Buffer Pool/VTAM Environment Data Collection value that was set in the
Configuration Tool on the Specify Component Configuration (Page 3)
panel or by the
KN3_SNA_VTAM_COLLECT_DATA PARMGEN parameter.
These are possible reasons that the value of this attribute might be No:
- You did not respond Y to the Buffer Pool/VTAM Environment Data Collection parameter in the Configuration Tool or select Y as the value for the KN3_SNA_VTAM_COLLECT_DATA PARMGEN parameter.
- The agent's PMI exit and its aliases are not available to VTAM. To confirm that this issue is what is preventing SNA data collection, check the RKLVLOG for message KN3PN023. See the IBM Tivoli® Monitoring for Mainframe Networks: Planning and Configuration Guide for information on making the PMI exit and its aliases available to VTAM.
- The VTAM application needed by the agent to collect VTAM environment and buffer pool data is either not defined to
VTAM or is not in the correct state. To confirm that this
issue is preventing SNA data collection, check the RKLVLOG for message KN3PN011 or KN3PN022. See the
Troubleshooting SNA collector problems
topic in the IBM Z OMEGAMON Network Monitor: Troubleshooting Guide for more information about this problem.
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
- 0 = No
- 1 = Yes
This parameter is defined by the CSM Buffer Reporting value that was set in the Configuration
Tool on the Specify Component Configuration (Page 3)
panel or the KN3_TCP_CSM PARMGEN
parameter. CSM Buffer Reporting Collection can be started while the monitoring agent is running with
the KN3FCCMD START CSM command. The interval that you specified for this value during configuration
can be modified while the monitoring agent is running using the TCPCINTV parameter on the KN3FCCMD
INSTALL TCPC command. See the IBM Z OMEGAMON Network Monitor: 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.
EE And HPR Collection Indicates whether Enterprise Extender (EE) and High Performance Routing (HPR) connection statistics are to be collected. The SNA network monitoring interface (NMI) collects this data once every TCP collection interval. This value is stored as an integer and displayed as a string. The following are valid values:
- 0 = No
- 1 = Yes
This parameter is defined by the Enterprise Extender and High Performance Routing Statistics
Collection value that was set in the Configuration Tool on the Specify Component Configuration
(Page 3)
panel or the KN3_TCP_EEHPR PARMGEN parameter. EE and HPR Collection can be started
while the monitoring agent is running with the KN3FCCMD START EEHPR command. The interval that you
specified for this value during configuration can be modified while the monitoring agent is running
using the TCPCINTV parameter on the KN3FCCMD INSTALL TCPC command. See the IBM Z OMEGAMON Network Monitor: 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.
Origin Node The unique identifier for the IBM Z OMEGAMON Network Monitor agent node on the navigation tree. The format is an alphanumeric string no longer than 32 characters.
PMI Exit Name The alias name of the agent VTAM performance monitor interface (PMI) exit being used by this monitoring agent instance. The format is an 8-character string.
The agent PMI exit and its aliases must be made accessible to VTAM before VTAM environment and buffer pool data can be collected successfully. If the SNA Collection Started attribute in the Agent Status Attribute table has a value of No, indicating that the SNA collector is not started, this field will be blank.
PMI Exit Status Indicates the current status of the agent VTAM performance monitor interface (PMI) exit. This value is stored as an integer and displayed as a string. The following are valid values:
- 0 = Unknown
- 2 = ACTIVE
The ACTIVE value shown is the same value that is seen in the output
of the DISPLAY NET
command.
If the SNA Collector Status column of the Agent Status table has a value of Yes, then a value of Unknown for this attribute means that an operator or a program operator application (POA) has temporarily deactivated the PMI exit. The agent may reactivate it automatically. If, after waiting two or three data collection cycles, this attribute does not show a value of ACTIVE, you might need to stop and restart the agent.
If the SNA Collector Status column of the Agent Status table has a value of No, then the value of this attribute will be Unknown. If you would like to collect VTAM buffer pool and environment data, start SNA data collection. See the description of the SNA Collection Started attribute in the Agent Status table for information about why SNA data collection is not started.
Note: A value of Unknown might be the result of an internal error. If you think this is the case, contact IBM Software Support.
SNA NMI Enabled Indicates whether the SNA network monitoring interface (NMI) is enabled. This value is stored as an integer and displayed as a string. The following are valid values:
- 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 you want to collect high performance routing (HPR) or enterprise extended (EE) data or
communications storage manager (CSM) data and the SNA NMI is not enabled, you must enable it. See
the IBM
z/OS® Communications Server: IP Programmer's Guide for
information about enabling the SNA NMI. See the Enabling the z/OS Communications Server network management interface
section of the "Preparing your z/OS Environment" chapter of the IBM Z OMEGAMON Network Monitor: Planning and Configuration Guide for
more information.
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.
No=0
Yes=1