KN3 SNA Collector Status Attributes

Use the KN3 SNA Collector Status attributes to view configuration and status information about the OMEGAMON XE for Mainframe Networks 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:

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:

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:

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 Tivoli OMEGAMON XE for Mainframe Networks: 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 or not 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:

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. The Configuration Tool value can be modified while the monitoring agent is running using the ALLHPR parameter on the KN3FCCMD START EEHPR 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.

Buffer Pool And VTAM Environment Collection Indicates whether or not 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:

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.

These are possible reasons that the value of this attribute might be 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:

CSM Buffer Reporting Collection Indicates whether or not VTAM communications storage manager (CSM) buffer reporting statistics are being 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:

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. 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 using the Configuration Tool can be modified while the monitoring agent is running using the TCPCINTV parameter on the KN3FCCMD INSTALL TCPC 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.

EE And HPR Collection Indicates whether or not 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:

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. 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 using the Configuration Tool can be modified while the monitoring agent is running using the TCPCINTV parameter on the KN3FCCMD INSTALL TCPC 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.

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.

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:

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

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 Tivoli OMEGAMON XE for Mainframe Networks: 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. 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.