Use the KN3 SNA Collector Status attributes to view configuration and status information about the OMEGAMON for Networks on z/OS 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 dataset. A valid value is a string of up to 8 characters.
This VTAM application must be defined to VTAM and have a status of ACTIVE before the VTAM application, buffer pool, environment and session 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. The status strings displayed for this attribute match the status strings displayed by the DISPLAY NET command. A valid value is an integer. Values appear on the workspace as follows:
A value of Unknown represents less common, transient states. When 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 application, buffer pool, environment and session 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. A valid value is a string of up to 8 characters.
This major node must be active for VTAM application, buffer pool, environment and session 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. The status string ACTIV displayed for this attribute matches the status string displayed by the DISPLAY NET command. A valid value is an integer. Values appear on the workspace as follows:
A value of Unknown represents less common, transient states. 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 application, buffer pool, environment and session 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 Documentation for IBM OMEGAMON for Networks on z/OS.
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. When the value for this attribute is No, data is only collected for those HPR connections that flow data over Enterprise Extender (EE) connections. The value is set based on the value of the KN3_TCP_ALLHPR PARMGEN parameter. A valid value is an integer. Values appear on the workspace as follows:
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 Documentation for IBM OMEGAMON for Networks on z/OS 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 was configured for the stack.
Buffer Pool And VTAM Environment Collection Indicates whether VTAM buffer pool and environment statistics are being collected. When the value for this attribute is Yes, data for VTAM buffer pools and environment is being collected. The SNA collector collects this data once every SNA collection interval. The value is set based on the value of the KN3_SNA_VTAM_COLLECT_DATA PARMGEN parameter. A valid value is an integer. Values appear on the workspace as follows:
These are possible reasons that the value of this attribute might be No:
Collection Time The time and date at which the 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:
This time is stored as 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 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. The value is set based on the value of the KN3_TCP_CSM PARMGEN parameter. parameter. A valid value is an integer. Values appear on the workspace as follows:
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 Documentation for IBM OMEGAMON for Networks on z/OS 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 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. The value is set based on the value of the KN3_TCP_EEHPR PARMGEN parameter. A valid value is an integer. Values appear on the workspace as follows:
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 Documentation for IBM OMEGAMON for Networks on z/OS 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 was configured for the stack.
Origin Node The unique identifier for the IBM OMEGAMON for Networks on z/OS agent node on the navigation tree. A valid value is a string of up to 32 characters.
PMI Exit Name The alias name of the agent VTAM performance monitor interface (PMI) exit being used by this monitoring agent instance. A valid value is a string of up to 8 characters.
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. The ACTIVE value shown is the same value that is seen in the output of the DISPLAY NET command. A valid value is an integer. Values appear on the workspace as follows:
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. If you want to collect high performance routing (HPR) or enterprise extended (EE) 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 Documentation for IBM OMEGAMON for Networks on z/OS for more information. A valid value is an integer. Values appear on the workspace as follows:
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.
SNAMGMT Agent Access Displays the access type that the OMEGAMON for Networks agent user ID has to the SNA network management interface (NMI). Read access is required to successfully collect communications storage manager (CSM), enterprise extender (EE) and high performance routing (HPR) data. A valid value is an integer. Values appear on the workspace as follows:
SNAMGMT Resource Defined Indicates whether the IST.NETMGMT.sysname.SNAMGMT resource is defined to the SERVAUTH class on the monitored system. Where sysname is the host name of the monitored system. In order to control access to the SNA network management interface (NMI) the system administrator may have defined this resource. If so, the OMEGAMON for Networks agent user ID has to be permitted to this resource in order to collect communications storage manager (CSM), enterprise extender (EE) and high performance routing (HPR) data. A valid value is an integer. Values appear on the workspace as follows:
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.
System ID The System Management Facility (SMF) system identifier for the z/OS system where the OMEGAMON for Networks monitoring agent collected the data. A valid value is a string of up to 4 characters.
VTAM Application Collection Indicates whether the VTAM application and session statistics are to be collected. This data is collected once every SNAC collection interval by the agent. A valid value is an integer. Values appear on the workspace as follows:
The configured value can be modified while the monitoring agent is running by using the KN3FCCMD START VAPP command or the KN3FCCMD STOP VAPP command. For more information, see the IBM Documentation for IBM OMEGAMON for Networks on z/OS.