-- -- file: monsub.mib -- -- COMTEK Services, Inc. -- COMTEK MIB for NMServer VMS Monitor Standard Subagent Data -- Release 3.3 -- Date June 2000 -- Author NF -- -- Copyright 1999-2000 COMTEK Services, Inc. All Rights Reserved. -- -- This COMTEK Services COMTEK Subagent SNMP Management Information Base -- Specification (MIB) embodies COMTEK Services' confidential and -- proprietary intellectual property. COMTEK Services retains all -- title and ownership in the Specification, including any -- revisions. -- -- This Specification is supplied "AS IS," and COMTEK Services makes -- no warranty, either express or implied, as to the use, -- operation, condition, or performance of the Specification. -- -- PURPOSE: -- The VMS Monitor Subagent MIB contains definitions of variables that -- are supported by the COMTEK Subagent Kernel. These variables exist -- in all COMTEK subagents. -- MIB VARIABLES: -- All COMTEK Subagents implement the following kinds of variables: -- subagent OID -- trap variables -- software error variables -- configuration variables -- See below for more information on these variables. -- -- TRAP VARIABLES: -- Each COMTEK subagent process maintains an internal trap table -- containing the latest traps that have been sent by the subagent. -- The number of traps that are retained in the internal trap table -- is controlled by the vCfgTrapTblSize variable. Each trap that is -- sent by the subagent includes a trap sequence number and a timestamp -- as well as any trap specific data. The trap sequence number may -- be used to request that a trap be resent to the manager. -- -- The number of traps per second that may be sent is governed by the -- vCfgMaxTrapSec variable. vTrapLastSeqNumSent identifies the -- sequence number of the last trap that was actually sent, if no -- backlog of traps exists, this number will be one less than -- vTrapNextSeqNum. If a backlog exists due to throttling, then -- the size of the backlog may be determined by comparing these -- numbers. If the size of the backlog exceeds the size of the -- trap table (as set by vCfgTrapTblSize), the backlogged traps -- will be lost as they are overwritten by new traps, the number -- of traps that have been lost is contained in vTrapLostCount. -- -- SOFTWARE ERROR VARIABLES: -- The software error variables allow for diagnostic and informational -- messages to be available to the network manager. This data is -- most frequently used to provide explanations when SNMP set-requests -- are denied. These variables are available for use by the subagent -- developer. -- -- CONFIGURATION VARIABLES: -- The configuration variables reflect subagent configuration settings -- that may be made using the configuration file. All SNMP set-requests -- performed on these variables cause the disk based configuration file -- to be updated accordingly. COMTEK-VMS-MONITOR-SUBAGENT-MIB DEFINITIONS ::= BEGIN IMPORTS DisplayString FROM RFC1213-MIB OBJECT-TYPE FROM RFC-1212 TimeTicks, Counter FROM RFC1155-SMI TRAP-TYPE FROM RFC-1215 comtekSubagent, comtekVmsNMVmsMonSubagent FROM COMTEK-DEFINITIONS-MIB; vmsMon OBJECT IDENTIFIER ::= { comtekSubagent 7 } vSubagentOID OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "Subagent OID used to identify the subagent." ::= { vmsMon 1 } vTrapNextSeqNum OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The next sequence number in trap table. When this variable is sent as part of a trap, it identifies the sequence number assigned to that trap. This is a 32-bit value and will wrap after 4294967295." ::= { vmsMon 2 } vTrapTime OBJECT-TYPE SYNTAX TimeTicks ACCESS read-only STATUS mandatory DESCRIPTION "vCfgUpTime when the trap was created." ::= { vmsMon 3 } vTrapResendSeqNum OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "Sequence number of a trap message to be resent to the manager. Setting this variable to a trap sequence number causes the specified trap message to be resent. If the set-request contains a sequence number that is not available (the number of items retained in the trap table is dependent on the value of vCfgTrapTblSize), an error indicator will be returned." ::= { vmsMon 4 } vTrapLastSeqNumSent OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "Sequence number of the last trap sent. This value may be compared to vTrapNextSeqNum to determine if a backlog of traps exists. If this value is one less than vTrapNextSeqNum, then no backlog exists. A backlog of traps may exist if more traps are generated per second than may be sent (as specified by the variable vCfgMaxTrapSec)." ::= { vmsMon 5 } vTrapLostCount OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "This variable indicates the number of traps that have been lost. A trap is considered to be lost if it is overwritten in the internal trap table before it is sent to the manager. This may occur if the trap table is not large enough (see vCfgTrapTblSize) to hold all of unsent traps. How quickly traps are sent to the manager is governed by the vCfgMaxTrapSec variable. To prevent trap loss, set these two variables so that the trap backlog does not overflow the trap table and so that traps do not flood the network." ::= { vmsMon 6 } vSwErrStatus OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The latest software status code." ::= { vmsMon 7 } vSwErrFile OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "The file name of the software element which generated the latest software status code." ::= { vmsMon 8 } vSwErrLineNum OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The line number in the file which generated the latest software status code." ::= { vmsMon 9 } vSwErrLastTime OBJECT-TYPE SYNTAX TimeTicks ACCESS read-only STATUS mandatory DESCRIPTION "vCfgUpTime when the most recent software status code was generated." ::= { vmsMon 10 } vSwErrMessage OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Description of the latest software error." ::= { vmsMon 11 } vCfgFile OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) ACCESS read-write STATUS mandatory DESCRIPTION "Name of the file currently being used for subagent initialization parameters. The subagent must be reinitialized (by setting the variable vCfgReinitSubagent to true) after a set-request on this variable before the new file is used. If a set-request is performed on this variable and the specified file name does not exist, is not accessible, or contains invalid data, the file name is not changed, an error is returned, and a vSwErr trap is generated describing the error. Set-requests: Take effect only after reinitialization (vCfgReinitSubagent)" ::= { vmsMon 12 } vCfgLogFile OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "Name of the log file currently being used by the subagent." ::= { vmsMon 13 } vCfgReinitSubagent OBJECT-TYPE SYNTAX INTEGER { true(1), false(2) } ACCESS read-write STATUS mandatory DESCRIPTION "Flag which may be set to force the subagent to reinitialize. Reinitialization involves resetting the process configuration using the parameters contained in the vCfgFile and sending the vWarmStart trap." DEFVAL { false } ::= { vmsMon 14 } vCfgTraps OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2) } ACCESS read-write STATUS mandatory DESCRIPTION "Flag which determines if any trap messages are sent to the master agent. Setting this variable to disabled(2) disables all traps from being sent. Configuration Variable: Traps Set-requests: Take effect immediately Changes to this value are written to the vCfgFile." DEFVAL { enabled } ::= { vmsMon 15 } vCfgTrapTblSize OBJECT-TYPE SYNTAX INTEGER (10..5000) ACCESS read-write STATUS mandatory DESCRIPTION "The maximum number of traps to be retained. Traps that are retained may be resent (see vTrapResendSeqNum) unless too many subsequent traps have been generated. This variable controls how many traps are retained in the subagent's internal trap table. Configuration Variable: TrapTableSize Set-Requests: Take effect immediately Changes to this value are written to the vCfgFile." DEFVAL { 100 } ::= { vmsMon 16 } vCfgTimeout OBJECT-TYPE SYNTAX INTEGER (0..3600) ACCESS read-only STATUS mandatory DESCRIPTION "This variable identifies the time-out value that is to be used by the subagent during subtree registration. If this value is set to zero, the default value identified by the master agent will be used. If the value specified exceeds the current maximum that the master agent allows, the master agent's maximum will be used instead. This value is specified in seconds. Configuration Variable: Timeout" DEFVAL { 0 } ::= { vmsMon 17 } vCfgControlTermProc OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2) } ACCESS read-only STATUS mandatory DESCRIPTION "Flag which may be used to disable process termination by the vCfgTermProc variable. Setting this variable to enabled(1) allows the vCfgTermProc variable to be set to true(1) to terminate the subagent process. Setting this variable to disabled(2) prevents the vCfgTermProc variable from being set. Configuration Variable: ControlTermProc" DEFVAL { disabled } ::= { vmsMon 18 } vCfgTermProc OBJECT-TYPE SYNTAX INTEGER { true(1), false(2) } ACCESS read-write STATUS mandatory DESCRIPTION "Flag which may be used to shutdown the subagent process. Setting this flag to true causes the subagent process to respond to the set-request, send the vTermProc trap, close the connection to the master agent, and shutdown. If the vCfgControlTermProc flag state is disabled(2), the vCfgTermProc variable can not be set. Set-requests: Take effect immediately if vCfgControlTermProc is enabled(2)" DEFVAL { false } ::= { vmsMon 19 } vCfgVersion OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Current version of the NM*Toolkit Subagent Kernel software." ::= { vmsMon 20 } vCfgUpTime OBJECT-TYPE SYNTAX TimeTicks ACCESS read-only STATUS mandatory DESCRIPTION "Subagent up time." ::= { vmsMon 21 } vCfgMaxTrapSec OBJECT-TYPE SYNTAX INTEGER (0..100) ACCESS read-write STATUS mandatory DESCRIPTION "This value specifies the maximum number of traps per second that may be sent. A value of zero disables trap throttling, allowing all traps to be sent as they are generated. It is recommended that this value and vCfgTrapTblSize be tuned to each operational environment. Configuration Variable: MaxTrapSec Set-requests: Take effect immediately. Changes to this value are written to the vCfgFile." DEFVAL { 0 } ::= { vmsMon 22 } vColdStart TRAP-TYPE ENTERPRISE comtekVmsNMVmsMonSubagent VARIABLES { vTrapNextSeqNum, vTrapTime, vCfgVersion } DESCRIPTION "A vColdStart trap signifies that the sending protocol entity is reinitializing itself such that the agent's configuration or the protocol entity implementation may be altered." ::= 0 vSwErr TRAP-TYPE ENTERPRISE comtekVmsNMVmsMonSubagent VARIABLES { vTrapNextSeqNum, vTrapTime, vSwErrStatus, vSwErrFile, vSwErrLineNum, vSwErrMessage } DESCRIPTION "Software error encountered. This trap indicates that subagent was unable to perform some action and explains the error. This trap is typically encountered if vCfgFile is set to a new file name which is erroneous or contains invalid data." ::= 1 vTermProc TRAP-TYPE ENTERPRISE comtekVmsNMVmsMonSubagent VARIABLES { vTrapNextSeqNum, vTrapTime } DESCRIPTION "Subagent process termination." ::= 2 vWarmStart TRAP-TYPE ENTERPRISE comtekVmsNMVmsMonSubagent VARIABLES { vTrapNextSeqNum, vTrapTime } DESCRIPTION "The subagent process has been reinitialized." ::= 3 END