This chapter provides an overview of the BEA MIB which is supported by the SNMP agents shipped with the Agent Integrator product. The following groups are included.
This group contains general purpose objects such as operating system name and version and the fields in the
beaSystem Group
beamgr.conf configuration file. Fields in the configuration file can be changed through an SNMP SET on the corresponding MIB object. This MIB is supported by the unix_snmpd and nt_snmpd subagents, provided with Agent Integrator.
beaSysDescr
Syntax
DisplayStringAccess
read-only
Description
Contains the agent version and copyright notice as well as the architecture that the agent runs on.
Syntax
Object Identifier
Access
read-only
Description
The value of this object is an OID that consists of the BEA OID followed by the IP address of the managed node, (i.e.,
.1.3.6.1.4.1.140.IP_Address).
Syntax
DisplayString
Access
read-only
Description
A string that specifies when the agent was installed on the host. This is specified in the SYS_INSTALL entry in the BEA Manager configuration file.
Syntax
DisplayString
Access
read-only
Description
A user-specified string that specifies the contact person for problems on the host. This field is specified the SYS_CONTACT entry in the
beamgr.conffile.
Syntax
DisplayString
Access
read-only
Description
A user-defined string that specifies the system name for the host. This field is specified in the
beamgr.conffile.
Syntax
DisplayString
Access
read-only
Description
A user-defined string that specifies the location of the host. This field is specified in the
beamgr.conffile by the keyword SYS_LOCATION.
Syntax
DisplayString
Access
read-only
Description
A user-defined string that specifies the system services provided by the host. This field is specified in the
beamgr.conffile by the keyword SYS_SERVICES.
Syntax
DisplayString
Access
read-only
Description
A user-defined string that specifies the name of the host that is the destination for traps sent from this host. This field is specified by the TRAP_HOST entry in the
beamgr.conffile.
Syntax
DisplayString
Access
read-only
Description
Community string to use when sending a trap to the host identified by
beaTrapHost. This field is specified in the TRAP_HOST entry in the BEA Manager configuration file (beamgr.conf).
Syntax
Integer
Access
read-only
Description
The port number to use when sending a trap to the host designated by
beaTrapHost. This field is specified in the TRAP_HOST entry in thebeamgr.conffile.
Syntax
DisplayString
Access
read-only
Description
This string contains a message explaining the reason for a trap. This object is passed as part of the variable bindings in the trap. This field is used to describe transition (OK to ERR, or ERR to OK) for traps sent as actions in response to local Agent Integrator polling.
Syntax
Integer
Access
read-only
Description
Indicates whether the host has a hard disk. Acceptable values, and their interpretation, are:
0 : Unknown
1 : No
2 : Yes
Syntax
DisplayString
Access
read-only
Description
Operating system name as given by the
uname -scommand. For example,SunOS.
Syntax
DisplayString
Access
read-only
Description
Node (machine) name as given by the
uname -ncommand. For example,blueberry.
Syntax
DisplayString
Access
read-only
Description
Operating system release as given by the
uname -rcommand. For example,4.1.1.
Syntax
DisplayString
Access
read-only
Description
Operating system version as given by the
uname -mcommand. For example,1.
Syntax
DisplayString
Access
read-only
Description
Machine type as given by the
uname -mcommand. For example,sun4c.
Syntax
DisplayString
Access
read-only
Description
Software revision level of the BEA Manager SNMP agent. For example,
3.6.
This group includes such objects as the process table, file system table, the ipcs tables, the performance measurements (rstat), and the pstat -s command. The message queue and semaphore (ipcs -sa) tables are not supported on Windows NT systems. This MIB group is supported by the unix_snmpd and nt_snmpd subagents provided with Agent Integrator. However, the nt_snmpd subagent does not support the beaMqTable, beaShmTable, and beaSemTable subgroups.
Each entry (row) in the beaPsTable is a sequence of the following columnar objects. These objects represent the attributes of a software process executing on the host. A process is an entity created when a program is executed.
Syntax
DisplayString
Access
read-only
Description
Name of the owner of the process.
Syntax
Integer
Access
read-only
Description
Process ID number.
Syntax
DisplayString
Access
read-only
Description
Percentage of CPU capacity in use.
Syntax
DisplayString
Access
read-only
Description
Percentage of real memory being used by this process.
Syntax
Integer
Access
read-only
Description
The combined size of the data and stack segments (in kilobytes).
Syntax
Integer
Access
read-only
Description
The real memory (resident set) size of this process (in kilobytes). On systems where this attribute is not available, the value for all processes is set to zero.
Syntax
DisplayString
Access
read-only
Description
TTY used by this process.
Syntax
DisplayString
Access
read-only
Description
Process status. This field may contain multiple characters such as R, T, P, D, I, Z.
Syntax
DisplayString
Access
read-only
Description
Date and time when the process started.
Syntax
DisplayString
Access
read-only
Description
The command that was used to start the process.
Syntax
Integer
Access
read-only
Description
CPU time is the cumulative time, in timeticks, that all of the threads of this process have made use of the processor to execute instructions. Instructions are the basic unit of execution in a computer, and threads are the object that executes instructions. A process is an object created when a program is executed. Code executed to handle certain hardware interrupts or hardware traps may be counted towards the total value for this object. This object is supported only for Windows NT systems.
Syntax
Integer
Access
read-only
Description
The number of threads currently active in this process. A thread is an object that executes instructions. Instructions are the basic unit of execution in a processor. Every running process has at least one thread. This object is supported for Windows NT systems only.
Syntax
Integer
Access
read-only
Description
The total number of handles open for this process. This number is the sum of the number of handles open for each thread in this process.
Each entry (row) in the beaDfTable is a sequence of the following columnar objects. These objects represent the attributes of file systems mounted on the host. The objects in this table are equivalent to the output of the UNIX df command.
Syntax
Integer
Access
read-only
Description
Index of the entry (row) in the file system table.
Syntax
DisplayString
Access
read-only
Description
The name of the host on which the file system is mounted. If the file system is local, this field is a hyphen (-).
Syntax
DisplayString
Access
read-only
Description
Name of the file system.
Syntax
Integer
Access
read-only
Description
Size of the file system in kilobytes.
Syntax
Integer
Access
read-only
Description
The number of kilobytes used in the file system.
Syntax
Integer
Access
read-only
Description
The number of kilobytes available in the file system.
Syntax
Integer
Access
read-only
Description
Percentage of the total capacity of the file system that is in use.
Syntax
DisplayString
Access
read-only
Description
Directory where the file system is mounted.
The scalar objects in this section are equivalent to the information provided by the UNIX pstat -s command.
Syntax
Integer
Access
read-only
Description
Amount of swap space (in kilobytes) allocated to private pages.
Syntax
Integer
Access
read-only
Description
Number of kilobytes of swap space that are not currently allocated but which are claimed by memory mappings that have not yet created private pages.
Syntax
Integer
Access
read-only
Description
Total amount of swap space, in kilobytes, that is either allocated or reserved.
Syntax
Integer
Access
read-only
Description
Total swap space, in kilobytes, that is currently available for future reservation or allocation.
Each entry (row) in the beaMqTable is a sequence of the following columnar objects. These objects represent the attributes of message queue entries. This table is not supported by the nt_snmpd subagent.
Syntax
DisplayString
Access
read-only
Description
Type of facility. This value is always set to q.
Syntax
Integer
Access
read-only
Description
The identifier for the facility entry.
Syntax
DisplayString
Access
read-only
Description
The interprocess communication (IPC) key for the message queue.
Syntax
DisplayString
Access
read-only
Description
Access modes and flags for the facility.
Syntax
DisplayString
Access
read-only
Description
Login name of the owner of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Name of the group of the owner of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Login name of the creator of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Name of the group of the creator of the facility entry.
Syntax
Integer
Access
read-only
Description
The number of bytes in messages currently outstanding in the associated message queue.
Syntax
Integer
Access
read-only
Description
Number of messages currently outstanding in the associated message queue.
Syntax
Integer
Access
read-only
Description
Maximum number of bytes allowed in messages outstanding in the associated message queue.
Syntax
Integer
Access
read-only
Description
Process ID of the last process to send a message to the associated queue.
Syntax
Integer
Access
read-only
Description
Process ID of the last process to receive a message from the associated queue.
Syntax
DisplayString
Access
read-only
Description
Time when the last message was sent to the associated queue.
Syntax
DisplayString
Access
read-only
Description
Time when the last message was received from the associated queue.
Syntax
DisplayString
Access
read-only
Description
Time when the associated entry was created or changed.
Each entry (row) in the beaShmTable is a sequence of the following columnar objects. These objects represent the attributes of entries in the UNIX shared memory table. This is equivalent to the UNIX ipcs -ma command. This table is not supported by the nt_snmpd subagent.
Syntax
DisplayString
Access
read-only
Description
Type of facility. This value is always set to m.
Syntax
Integer
Access
read-only
Description
The identifier for the facility entry.
Syntax
DisplayString
Access
read-only
Description
The interprocess communication (IPC) key for the shared memory.
Syntax
DisplayString
Access
read-only
Description
The access modes and flags for the facility.
Syntax
DisplayString
Access
read-only
Description
Login name of the owner of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Name of the group of the owner of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Login name of the creator of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Name of the group of the creator of the facility entry.
Syntax
Integer
Access
read-only
Description
Number of processes attached to the associated shared memory segment.
Syntax
Integer
Access
read-only
Description
The size of the associated shared memory segment.
Syntax
Integer
Access
read-only
Description
The process ID of the creator of the shared memory entry.
Syntax
Integer
Access
read-only
Description
Process ID of the last process to attach to or detach from the shared memory segment.
Syntax
DisplayString
Access
read-only
Description
The time of the last attachment of a process to the associated shared memory segment.
Syntax
DisplayString
Access
read-only
Description
The time of the last detachment of a process from the associated shared memory segment.
Syntax
DisplayString
Access
read-only
Description
The time when the associated entry was created or changed.
Each entry (row) in the beaSemTable is a sequence of the following columnar objects. These objects represent the attributes of entries in the UNIX semaphore table. This is equivalent to the UNIX ipcs -sa command. This table is not supported by the nt_snmpd subagent.
Syntax
DisplayString
Access
read-only
Description
Type of facility. This value is always set to s.
Syntax
Integer
Access
read-only
Description
The identifier for the facility entry.
Syntax
DisplayString
Access
read-only
Description
The interprocess communication (IPC) key for the semaphore.
Syntax
DisplayString
Access
read-only
Description
Access modes and flags for the facility.
Syntax
DisplayString
Access
read-only
Description
Login name of the owner of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Name of the group of the owner of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Login name of the creator of the facility entry.
Syntax
DisplayString
Access
read-only
Description
Name of the group of the creator of the facility entry.
Syntax
Integer
Access
read-only
Description
The number of semaphores in the set associated with the semaphore entry.
Syntax
DisplayString
Access
read-only
Description
The time of completion of the last operation on the set associated with the semaphore entry.
Syntax
DisplayString
Access
read-only
Description
The time when the associated entry was created or changed.
Each entry (row) in the beaLclDfTable is a sequence of the following columnar objects. These objects represent the attributes of local file systems. This is equivalent to the output of the UNIX df command.
Syntax
DisplayString
Access
read-only
Description
Name of the file system.
Syntax
Integer
Access
read-only
Description
File system size in kilobytes.
Syntax
Integer
Access
read-only
Description
The number of kilobytes used in the file system.
Syntax
Integer
Access
read-only
Description
The number of kilobytes available in the file system.
Syntax
Integer
Access
read-only
Description
Percentage of the file system capacity that is in use.
Syntax
DisplayString
Access
read-only
Description
Directory where the file system is mounted.
The shared memory manager table is the only object under the beaSmgr group.
The shared memory manager table is supported by the unix_snmpd subagent shipped with the Agent Integrator. Each entry (row) in the beaSmgrTable is a sequence of the following columnar objects. Each row is a sequence of attributes for a block of shared memory.
Syntax
Integer
Access
read-only
Description
Index into the table of shared memory blocks.
Syntax
DisplayString
Access
read-only
Description
Interprocess communication (IPC) key used by the block of shared memory.
Syntax
Integer {
no (1),
yes (2) }Access
read-only
Description
Status of the block of shared memory. This object can be monitored to detect when shared memory is corrupted or removed accidentally.
Syntax
DisplayString
Access
read-only
Description
Name of the subsystem using the block of shared memory.
Syntax
DisplayString
Access
read-only
Description
Timestamp when the block of shared memory was allocated.
Syntax
DisplayString
Access
read-only
Description
Software version of the shared memory manager library which was linked in to allocate the block of shared memory.
Syntax
Integer
Access
read-only
Description
Maximum number of entries configured for shared memory.
Syntax
Integer
Access
read-only
Description
Current number of entries in shared memory.
Syntax
Integer
Access
read-only
Description
High-water mark of the number of entries used in shared memory.
Syntax
Integer
Access
read-only
Description
Percentage of the current number of entries in shared memory that are in use.
Syntax
Integer
Access
read-only
Description
High-water mark of the percentage of entries in use in shared memory. This object can be used to determine if more entries need to be allocated without having to poll continuously for the maximum current number of entries.
Syntax
Integer
Access
read-only
Description
Total size of the shared memory segment.
Syntax
Integer
Access
read-only
Description
Size of the user segment in the shared memory segment.
Syntax
Integer
Access
read-only
Description
Size of the auxiliary segment in the shared memory segment.
Syntax
Integer
Access
read-only
Description
Semaphore ID used to arbitrate allocation of user segments within the shared memory segment.
Syntax
Integer
Access
read-only
Description
Shared memory ID.
Workstation performance attributes. This MIB group is supported by the unix_snmpd subagent shipped with the Agent Integrator. The objects in this group are similar to those supported by the Sun perfmeter on Sun workstations. The beaSysPerfIfTable object is described following the descriptions of all the scalar objects in this group.
Syntax
Integer
Access
read-only
Description
Percentage of CPU capacity being utilized between polls.
Syntax
Integer
Access
read-only
Description
Number of context switches. This is a cumulative counter.
Syntax
Integer
Access
read-only
Description
Jobs swapped. This is a cumulative counter.
Syntax
Integer
Access
read-only
Description
Disk traffic in numbers of transfers in blocks. This is a cumulative counter.
Syntax
Integer
Access
read-only
Description
Number of device interrupts. This includes receive, transmit, and modem type interrupts from console, ports, and hiports boards. This is a cumulative counter.
Syntax
Integer
Access
read-only
Description
The size of the run queue every second. This is a cumulative counter.
Syntax
Integer
Access
read-only
Description
The paging activity in the number of pages. This is a cumulative counter.
Syntax
Integer
Access
read-only
Description
The number of network interfaces (regardless of their current state) present on this system.
Syntax
Integer
Access
read-only
Description
The number of context switches. This represents the change since the last poll.
Syntax
Integer
Access
read-only
Description
The number of jobs swapped. This represents the change since the last poll.
Syntax
Integer
Access
read-only
Description
Disk traffic in numbers of transfers in blocks. This represents the change since the last poll.
Syntax
Integer
Access
read-only
Description
The number of device interrupts. This includes receive, transmit, and modem types of interrupts from the console, ports, and hiports boards. This represents the change since the last poll.
Syntax
Integer
Access
read-only
Description
The size of the run queue every second. This represents the change since the last poll.
Syntax
Integer
Access
read-only
Description
The paging activity in the number of pages. This represents the change since the last poll.
This tabular object within the beaSysPerf MIB group represents the physical interfaces on a system. Each entry (row) in the beaSysPerfIfTable is a sequence of the following columnar objects. Each row represents attributes of a particular interface. This table is supported by the unix_snmpd subagent shipped with the Agent Integrator. The last five columnar objects provide differences between last and current poll. This is intended to compensate for the fact that some network managers cannot effectively use absolute values to calculate differences needed for defining thresholds.
Syntax
Integer
Access
read-only
Description
A unique number for each interface. The value ranges between 1 and
beaSysPerfIfNumber. The value for each interface must remain constant between re-initializations of the entity's network management system.
Syntax
DisplayString (SIZE 0..255)
Access
read-only
Description
A string containing information about the interface. This should include the name of the manufacturer, the product name, and the version of the hardware interface.
Syntax
Integer {
up (1),
down (2),
testing (3) }Access
read-only
Description
The current operational state of the interface. An interface is
upif it is ready to pass packets. An interface is not ready to pass packets if it is in thetestingstate.
Syntax
Counter
Access
read-only
Description
The total number of packets received on the interface. This object differs from the MIB II
interfacesgroupifInPacketsobject in that the latter represents number of octets rather than packets.
Syntax
Counter
Access
read-only
Description
The number of inbound packets that contained errors that prevented them from being delivered to a higher-layer protocol.
Syntax
Counter
Access
read-only
Description
The total number of packets transmitted out of the interface.
Syntax
Counter
Access
read-only
Description
The number of outbound packets that could not be transmitted because of errors. This differs from the MIB II
interfacesgroupifOutErrorsobject in that the latter represents octets rather than packets.
Syntax
Counter
Access
read-only
Description
The number of collisions on CSMA interfaces.
Syntax
Counter
Access
read-only
Description
The total number of packets received on the interface. This represents the change since the last poll. This differs from the MIB II
interfacesgroupifInPacketsobject in that the latter represents octets rather than packets.
Syntax
Counter
Access
read-only
Description
The number of inbound packets that contained errors preventing them from being delivered to a higher-level protocol. This represents the difference since the last poll.
Syntax
Counter
Access
read-only
Description
The total number of packets transmitted out of the interface. This represents the change since the last poll.
Syntax
Counter
Access
read-only
Description
The number of outbound packets that could not be transmitted because of errors. This represents the change since the last poll. This object differs from the MIB II
interfacesgroupifOutErrorsobject in that the latter counts octets rather than packets.
Syntax
Counter
Access
read-only
Description
The number of collisions on CSMA interfaces. This represents the change since the last poll.
This MIB group represents system performance attributes specific to the Windows NT system. This MIB group is supported by the nt_snmpd subagent shipped with the Agent Integrator. This MIB group contains the following scalar objects.
Syntax
Integer
Access
read-only
Description
This is a cumulative counter of calls to Windows NT system service routines. These routines perform all of the basic scheduling and synchronization tasks on the computer and provide access to non-graphical devices, memory management, and name-space management.
Syntax
Integer
Access
read-only
Description
This is a cumulative counter of all alignment faults fixed by the system.
Syntax
Integer
Access
read-only
Description
This is a cumulative counter of all exceptions dispatched by the system.
Syntax
Integer
Access
read-only
Description
This is a cumulative counter of all floating emulations performed by the system.
Syntax
Integer
Access
read-only
Description
This is a count of the page faults in the processor. A page fault occurs when a process refers to a virtual memory page that is not in its working set in main memory. A page fault will not cause the page to be fetched from disk if that page is on the standby list, and hence already in main memory, or if it is in use by another process when the page is shared.
Syntax
Integer
Access
read-only
Description
The number of pages read from disk or written to the disk to resolve memory references to pages that were not in memory at the time of the reference. This is the sum of pages input and output. This counter includes paging traffic on behalf of the system cache to access file data for applications. This is the primary counter to observe if you are concerned about excessive pressure on memory (that is, memory thrashing), and the excessive paging that may result.
Syntax
Integer
Access
read-only
Description
Measures the number of bytes currently in use by the system cache. The system cache is used to buffer data retrieved from disk or local area network (LAN) resources. The system cache uses memory not in use by the active processes in the computer.
Syntax
Integer
Access
read-only
Description
The number of kilobytes of pages that can be paged in
ntoskrn1.exe,hal.d11, and the boot drivers and file systems loaded byntldr/osloader.
Syntax
Integer
Access
read-only
Description
The number of kilobytes of system code currently resident in core memory. This is the working code set of the pagable executive. In addition to this, there is roughly an additional 300 kilobytes non-paged kernel code.
Syntax
Integer
Access
read-only
Description
The number of kilobytes of pagable pages in all loaded device drivers other than those counted in
beaNTSysPerfCodeTotal.
Syntax
Integer
Access
read-only
Description
The number of kilobytes of
beaNTSysPerfDriverTotalcurrently resident in core memory. This number is the working code set of the pagable drivers. In addition to this, there is roughly another 300 kilobytes of non-paged driver code.
Syntax
Integer
Access
read-only
Description
The number of bytes currently resident in the global disk cache.
Syntax
DisplayString
Access
read-only
Description
The percent of the page file instance that is in use.
Syntax
DisplayString
Access
read-only
Description
The peak usage of the page file instance in percent.
The only object in the beaIntAgt group is the BEA intelligent agent table.
This MIB group is supported directly by the Agent Integrator master agent. The beaIntAgtTable permits the addition or deletion or modification of RULE_ACTION entries that are used to control local polling by the Agent Integrator. Each entry (row) in the beaIntAgtTable supports a particular polling rule. The beaIntAgtStatus object is a read-write object that can be used to de-activate or activate polling execution by particular rules. For more information about Agent Integrator polling, refer to Chapter 4, "Using Agent Integrator for Polling."
| Variable Name | Object ID |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Syntax
DisplayString
Access
read-write
Description
A name of the rule that must be unique within the table. This provides an index into the table. The string must not be longer than eight characters.
Syntax
Integer
Access
read-write
Description
Polling interval in seconds. This is the length of delay from the previous evaluation of the rule entry.
Syntax
DisplayString
Access
read-write
Description
This string contains the actual rule that defines the threshold to be checked and the action to be taken if there is a change of state in the rule. There are two possible states for the rule, OK or ERR. If the rule condition is satisfied, the state is ERR. If the rule condition is not satisfied, the state is OK. Actions are executed only if a transition from one state to the other occurs. RULE_ACTION entries are explained in Chapter 4, "Using Agent Integrator for Polling." The syntax of the RULE_ACTION entry can be found in Chapter 7, "Configuration Files."
Syntax
Integer {
active(1),
invalid (2),
inactive (3) }Access
read-write
Description
Status of the row (RULE_ACTION entry). Polling is active if and only if the status is
active. If the status of the rule is set toinvalid, the row (RULE_ACTION entry) is deleted. Polling is disabled without deleting the RULE_ACTION entry if the row status is set toinactive.