Use the KN3 Agent Status attributes to view configuration and status information about the OMEGAMON for Networks on z/OS monitoring agent.
Agent CPU Percentage The percentage of CPU in use when the sampling interval ended. A valid value is an integer. The range for this value is from 0 to 100.
Agent CPU Time The cumulative CPU time used, in seconds, for the address space since collection started. This will be a sum of Job_TCB_Time and Job_SRB_Time. A valid value is a number to two decimal places accuracy.
Agent Group ID The numeric group ID value of the OMVS security group to which the OMEGAMON for Networks on z/OS monitoring agent user ID belongs. Job KN3UAUTH generated during configuration adds user name KN3USER to the OMVS security group. A valid value is an integer.
Agent Group Name The OMVS security group name to which the OMEGAMON for Networks on z/OS monitoring agent user belongs. Job KN3UAUTH generated during configuration adds user name KN3USER to the OMVS security group. A valid value is a string of up to 8 characters.
Agent Procedure Name The name specified on the PROC or JOB statement of the JCL used to start the OMEGAMON for Networks on z/OS monitoring agent. A valid value is a string of up to 8 characters.
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 (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:
Agent User ID The numeric user ID value associated with the OMEGAMON for Networks on z/OS monitoring agent OMVS security group user name. Job KN3UAUTH is generated during configuration. This job adds user name KN3USER to the OMVS security group and defines a numeric value for the user name. A valid value is an integer.
Agent User Name The OMVS security group user name for the OMEGAMON for Networks on z/OS monitoring agent started task. Job KN3UAUTH is generated during configuration. 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 for Networks on z/OS monitoring agent task. The system administrator can choose to edit the KN3UAUTH sample. A valid value is a string of up to 8 characters.
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 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:
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. A valid value is an integer. Values appear on the workspace as follows:
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.
PAGENT Daemon Started 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. Indicates whether or not the PAGENT (Policy Agent) daemon is started on the monitored system. The PAGENT daemon must be started in order for IPSec data to be available for collection. The default proc name for the PAGENT Daemon is PAGENT. If you customize the proc for your environment and the proc name does not contain the substring "PAGENT", the value for this attribute may not be correct. A valid value is an integer. Values appear on the workspace as follows:
SNA Collection Interval The interval in minutes between data collection samples for the VTAM performance data. The default is a SNA collection interval of 5 minutes. A valid value is an integer. The range for this value is from 1 to 60.
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 or the KN3_SNA_VTAM_SNAC_SNACINTV PARMGEN parameter. The configured value can be modified while the monitoring agent is running using the SNACINTV parameter on the KN3FCCMD START SNAC command. See IBM Documentation for IBM OMEGAMON for Networks on z/OS 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 (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:
SNA Collection Started Indicates whether the agent SNA data collection is started on the monitored system. A valid value is an integer. Values appear on the workspace as follows:
If you indicated in the Configuration Tool or during PARMGEN configuration 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 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.
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. The default is a TCP collection interval of 5 minutes. A valid value is an integer.
This interval is defined by the TCP/IP Sample Interval value that was set in the Configuration Tool on the "Specify Component Configuration" panel or the KN3_TCP_SAMPLE_INTERVAL PARMGEN parameter. The configured value 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.
TCP Collection Start Time The time and date at which TCP collection was most recently started. 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:
TCP Collection Started Indicates whether TCP data collection has been started. A valid value is an integer. Values appear on the workspace as follows:
TCP Collector SNMP Parameter Data Set 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. This dataset is identified on the KN3SNMP DD statement of the OMEGAMON for Networks on z/OS started task procedure. 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. A valid value is a string of up to 54 characters.
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 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 for Networks on z/OS 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 or with the KN3_SNMP_CONFIG_FILE PARMGEN parameter. See IBM Documentation for IBM OMEGAMON for Networks on z/OS for more information.
TCPC Elapsed Time The elapsed time between the two most recent TCPC Data collection intervals in minutes. A valid value is an integer.
Virtual IO Unit Name The TCP/IP virtual I/O unit name to be used for temporary data sets. The default is VIO. A valid value is a string of up to 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 or using the KN3_TCP_VIO_UNIT PARMGEN parameter. The configured value can be modified while the monitoring agent is running using the TCPCVIOU parameter on the KN3FCCMD INSTALL TCPC command. See IBM Documentation for IBM OMEGAMON for Networks on z/OS for more information.