KN3 Agent Status Attributes

Use the KN3 Agent Status attributes to view configuration and status information about the OMEGAMON XE for Mainframe Networks monitoring agent.

Agent Group ID The numeric group ID value of the OMVS security group to which the OMEGAMON XE for Mainframe Networks monitoring agent user ID belongs. Job KN3UAUTH generated by the Configuration Tool adds user name KN3USER to the OMVS security group. The format is a 4-byte integer.

Agent Group Name The OMVS security group name to which the OMEGAMON XE for Mainframe Networks monitoring agent user belongs. Job KN3UAUTH generated by the Configuration Tool adds user name KN3USER to the OMVS security group. The format is an 8-character string.

Agent Procedure Name The name specified on the PROC or JOB statement of the JCL used to start the OMEGAMON XE for Mainframe Networks monitoring agent. The format is an 8-character string.

Agent Start Time The time and date at which this instance of the monitoring agent was started. 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:

Agent User ID The numeric user ID value associated with the OMEGAMON XE for Mainframe Networks monitoring agent OMVS security group user name. Job KN3UAUTH is generated by the Configuration Tool. This job adds user name KN3USER to the OMVS security group and defines a numeric value for the user name. The format is a 4-byte integer.

Agent User Name The OMVS security group user name for the OMEGAMON XE for Mainframe Networks monitoring agent started task. Job KN3UAUTH is generated by the Configuration Tool. This job adds user name KN3USER to the OMVS security group. Job KN3UAUTH also defines a profile named MfNProcName.* in the STARTED class and sets the user name to KN3USER. This action causes user name KN3USER to be used for the OMEGAMON XE for Mainframe Networks monitoring agent task. The system administrator can choose to edit the KN3UAUTH sample. The format is an 8-character string.

If the KN3UAUTH job has defined UID(0) for the Agent User ID, then the Agent User Name attribute will show a value of ROOT. If the UID is not UID(0), the Agent User Name is displayed as KN3USER (the default user name in the sample file) or the user name that the system administrator coded on the RACF ADDUSER statement.

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:

IKE Daemon Started Indicates whether the Internet Key Exchange (IKE) daemon has been started on the monitored system. The IKE daemon must be started for IPSec data to be available for collection. This value is stored as an integer and displayed as a string. Valid values are:

A value of Unknown means the status could not be determined due to an internal error in the agent. If you see this value, contact IBM Software Support.

The default jobname, identifier, and step name for the IKE Daemon procedure are all IKED. The value of this attribute might not be correct if the substring IKED is not part of the jobname, identifier, or step name for the IKE Daemon procedure. Also, if you use the substring IKED as part of another procedure's or job's jobname, or identifier, or step name, the value for this attribute might not be correct. For more information about jobname and identifier, see the "Starting a System Task from a Console" topic in the IBM z/OS: MVS System Commands book.

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.

PAGENT Daemon Started Indicates whether the Policy Agent (PAGENT) daemon is started on the monitored system. The PAGENT daemon must be started in order for IPSec data to be available for collection. This value is stored as an integer and displayed as a string. Valid values are:

A value of Unknown means the status could not be determined due to an internal error in the agent. If you see this value, contact IBM Software Support.

The default jobname, identifier, and step name for the PAGENT Daemon procedure are all PAGENT. The value of this attribute might not be correct if the substring PAGENT is not part of the jobname, or the identifier, or the step name for the PAGENT Daemon procedure. Also, if you use the substring PAGENT as part of another procedure's or job's jobname, or identifier, or step name, the value for this attribute might not be correct. For more information about jobname and identifier, see the "Starting a System Task from a Console" topic in the IBM z/OS: MVS System Commands book.

SNA Collection Interval The interval in minutes between data collection samples for the VTAM buffer pool and VTAM address space performance data. A value of “1" means that SNA data is collected every minute. This value is expressed as a whole number from 1 to 60, indicating the collection interval in minutes. The default is 5 minutes.

This interval is defined by the SNA Data Collection Interval value that was set in the Configuration Tool on the "Specify VTAM APPLID Values (Page 4)" panel. The Configuration Tool value can be modified while the monitoring agent is running using the SNACINTV parameter on the KN3FCCMD START SNAC command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.

SNA Collection Start Time The time and date when SNA data collection for this monitoring agent instance was last started. 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:

SNA Collection Started Indicates whether the agent SNA data collection is started on the monitored system. This value is stored as an integer and displayed as a string. Valid values are:

If you indicated in the Configuration Tool that VTAM environment and buffer pool data are to be collected, then the SNA collector is started when the agent is started.

These are possible reasons that the value of this attribute might be No:

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.

TCP Collection Interval The interval in minutes between data collection samples by the TCP/IP data collector. This collection interval is used by the network monitoring interface (NMI) collector and the SNMP collector. SNA data such as Communications Storage Manager (CSM) and High Performance Route (HPR) and Enterprise Extender (EE) data are collected by the NMI collector and use this interval also. A value of “1" means that TCP data is collected every minute. This value is expressed as a whole number from 1 to 60, indicating the collection interval in minutes. The default is 5 minutes.

This interval is defined by the TCP/IP Sample Interval value that was set in the Configuration Tool on the "Specify Component Configuration" panel. The Configuration Tool value 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.

TCP Collection Start Time The time and date at which TCP Collection was last started. 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:

TCP Collection Started Indicates whether TCP data collection has been started. This value is stored as an integer and displayed as a string. Valid values are:

TCP Collector SNMP Parameter Dataset Name The name of the data set that contains parameters used by the TCP/IP data collector to communicate with the SNMP agents for each of the TCP/IP stacks on the system. The format is an alphanumeric string of up to 54 characters.

This data set is identified on the KN3SNMP DD statement of the OMEGAMON XE for Mainframe Networks started task procedure. A sample of what should be in this dataset is provided in member KN3SNMP of the RKANSAMU data set. For each TCP/IP stack being monitored, this data set needs to provide the following information:

If this information cannot be located or the data set is unreadable, no data will be available for any of the workspaces whose data source is SNMP. If no data set name is provided or someone has the data set open in write mode, this attribute will be set to a value of UNKNOWN.

If the TCP Collector SNMP parameter data set name attribute has a value of UNKNOWN, verify that the KN3SNMP DD statement is not commented out in the OMEGAMON XE for Mainframe Networks started task procedure and that it refers to a data set that exists on the system where the monitoring agent will run. If access to the data set is being controlled by a SAF product, also make sure that the agent user ID has permission to read the data set.

If any of the SNMP parameters defined in the TCP Collector SNMP parameter data set are incorrect for a stack, check the KN3ACTCS log for the monitoring agent for error messages that may have been generated when processing the data set. If no error messages are found there, examine the parameters in the data set and verify that the information is correct for the TCP/IP stack or stacks. Also verify that no one has the data set open in write mode.

This data set name is defined by the SNMP Configuration file value that was set in the Configuration Tool on the "Specify Component Configuration (Page 2)" panel. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.

Virtual IO Unit Name The TCP/IP virtual I/O unit name to be used for temporary data sets. The default is VIO. The format is an alphanumeric string no longer than 8 characters.

This value is defined by the "Specify your site's VIO unit name" question that was set in the Configuration Tool on the "Specify Agent Configuration" panel. The Configuration Tool value can be modified while the monitoring agent is running using the TCPCVIOU parameter on the KN3FCCMD INSTALL TCPC command. See the IBM Tivoli Monitoring for Mainframe Networks: Planning and Configuration Guide for more information.