1765 lines
63 KiB
Plaintext
1765 lines
63 KiB
Plaintext
DISMAN-SCRIPT-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
|
|
Integer32, Unsigned32, mib-2
|
|
FROM SNMPv2-SMI
|
|
|
|
RowStatus, TimeInterval, DateAndTime, StorageType, DisplayString
|
|
FROM SNMPv2-TC
|
|
|
|
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
|
|
FROM SNMPv2-CONF
|
|
|
|
SnmpAdminString
|
|
FROM SNMP-FRAMEWORK-MIB;
|
|
|
|
scriptMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200108210000Z"
|
|
ORGANIZATION "IETF Distributed Management Working Group"
|
|
CONTACT-INFO
|
|
"WG EMail: disman@dorothy.bmc.com
|
|
Subscribe: disman-request@dorothy.bmc.com
|
|
|
|
Chair: Randy Presuhn
|
|
BMC Software, Inc.
|
|
|
|
Postal: Office 1-3141
|
|
2141 North First Street
|
|
San Jose, California 95131
|
|
USA
|
|
EMail: rpresuhn@bmc.com
|
|
Phone: +1 408 546-1006
|
|
|
|
Editor: David B. Levi
|
|
Nortel Networks
|
|
Postal: 4401 Great America Parkway
|
|
Santa Clara, CA 95052-8185
|
|
USA
|
|
EMail: dlevi@nortelnetworks.com
|
|
Phone: +1 423 686 0432
|
|
|
|
Editor: Juergen Schoenwaelder
|
|
TU Braunschweig
|
|
Postal: Bueltenweg 74/75
|
|
38106 Braunschweig
|
|
Germany
|
|
EMail: schoenw@ibr.cs.tu-bs.de
|
|
Phone: +49 531 391-3283"
|
|
DESCRIPTION
|
|
"This MIB module defines a set of objects that allow to
|
|
delegate management scripts to distributed managers."
|
|
REVISION "200108210000Z"
|
|
DESCRIPTION
|
|
"Revised version, published as RFC 3165.
|
|
|
|
This revision introduces several new objects: smScriptError,
|
|
smScriptLastChange, smLaunchError, smLaunchLastChange,
|
|
smLaunchRowExpireTime, smRunResultTime, and smRunErrorTime.
|
|
|
|
The following existing objects were updated: the maximum
|
|
value of smRunLifeTime now disables the timer, an
|
|
autostart value was added to the smLaunchAdminStatus
|
|
object, and a new expired state was added to the
|
|
smLaunchOperStatus object.
|
|
|
|
A new smScriptException notification has been added to
|
|
support runtime error notifications.
|
|
|
|
Created new conformance and compliance statements that
|
|
take care of the new objects and notifications.
|
|
|
|
Clarifications have been added in several places to remove
|
|
ambiguities or contradictions that were discovered and
|
|
reported by implementors."
|
|
|
|
REVISION "199902221800Z"
|
|
DESCRIPTION
|
|
"Initial version, published as RFC 2592."
|
|
::= { mib-2 64 }
|
|
|
|
--
|
|
-- The groups defined within this MIB module:
|
|
--
|
|
|
|
smObjects OBJECT IDENTIFIER ::= { scriptMIB 1 }
|
|
smNotifications OBJECT IDENTIFIER ::= { scriptMIB 2 }
|
|
smConformance OBJECT IDENTIFIER ::= { scriptMIB 3 }
|
|
|
|
--
|
|
-- Script language and language extensions.
|
|
--
|
|
-- This group defines tables which list the languages and the
|
|
-- language extensions supported by a Script MIB implementation.
|
|
-- Languages are uniquely identified by object identifier values.
|
|
--
|
|
|
|
smLangTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF SmLangEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists supported script languages."
|
|
::= { smObjects 1 }
|
|
|
|
smLangEntry OBJECT-TYPE
|
|
SYNTAX SmLangEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describing a particular language."
|
|
INDEX { smLangIndex }
|
|
::= { smLangTable 1 }
|
|
|
|
SmLangEntry ::= SEQUENCE {
|
|
smLangIndex Integer32,
|
|
smLangLanguage OBJECT IDENTIFIER,
|
|
smLangVersion SnmpAdminString,
|
|
smLangVendor OBJECT IDENTIFIER,
|
|
smLangRevision SnmpAdminString,
|
|
smLangDescr SnmpAdminString
|
|
}
|
|
|
|
smLangIndex OBJECT-TYPE
|
|
SYNTAX Integer32 (1..2147483647)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The locally arbitrary, but unique identifier associated
|
|
with this language entry.
|
|
|
|
The value is expected to remain constant at least from one
|
|
re-initialization of the entity's network management system
|
|
to the next re-initialization.
|
|
|
|
Note that the data type and the range of this object must
|
|
be consistent with the definition of smScriptLanguage."
|
|
::= { smLangEntry 1 }
|
|
|
|
smLangLanguage OBJECT-TYPE
|
|
SYNTAX OBJECT IDENTIFIER
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The globally unique identification of the language."
|
|
::= { smLangEntry 2 }
|
|
|
|
smLangVersion OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (0..32))
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The version number of the language. The zero-length string
|
|
shall be used if the language does not have a version
|
|
number.
|
|
|
|
It is suggested that the version number consist of one or
|
|
more decimal numbers separated by dots, where the first
|
|
number is called the major version number."
|
|
::= { smLangEntry 3 }
|
|
|
|
smLangVendor OBJECT-TYPE
|
|
SYNTAX OBJECT IDENTIFIER
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An object identifier which identifies the vendor who
|
|
provides the implementation of the language. This object
|
|
identifier SHALL point to the object identifier directly
|
|
below the enterprise object identifier {1 3 6 1 4 1}
|
|
allocated for the vendor. The value must be the object
|
|
identifier {0 0} if the vendor is not known."
|
|
::= { smLangEntry 4 }
|
|
|
|
smLangRevision OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (0..32))
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The version number of the language implementation.
|
|
The value of this object must be an empty string if
|
|
version number of the implementation is unknown.
|
|
|
|
It is suggested that the value consist of one or more
|
|
decimal numbers separated by dots, where the first
|
|
number is called the major version number."
|
|
::= { smLangEntry 5 }
|
|
|
|
smLangDescr OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A textual description of the language."
|
|
::= { smLangEntry 6 }
|
|
|
|
smExtsnTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF SmExtsnEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists supported language extensions."
|
|
::= { smObjects 2 }
|
|
|
|
smExtsnEntry OBJECT-TYPE
|
|
SYNTAX SmExtsnEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describing a particular language extension."
|
|
INDEX { smLangIndex, smExtsnIndex }
|
|
::= { smExtsnTable 1 }
|
|
|
|
SmExtsnEntry ::= SEQUENCE {
|
|
smExtsnIndex Integer32,
|
|
smExtsnExtension OBJECT IDENTIFIER,
|
|
smExtsnVersion SnmpAdminString,
|
|
smExtsnVendor OBJECT IDENTIFIER,
|
|
smExtsnRevision SnmpAdminString,
|
|
smExtsnDescr SnmpAdminString
|
|
}
|
|
|
|
smExtsnIndex OBJECT-TYPE
|
|
SYNTAX Integer32 (1..2147483647)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The locally arbitrary, but unique identifier associated
|
|
with this language extension entry.
|
|
|
|
The value is expected to remain constant at least from one
|
|
re-initialization of the entity's network management system
|
|
to the next re-initialization."
|
|
::= { smExtsnEntry 1}
|
|
|
|
smExtsnExtension OBJECT-TYPE
|
|
SYNTAX OBJECT IDENTIFIER
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The globally unique identification of the language
|
|
extension."
|
|
::= { smExtsnEntry 2 }
|
|
|
|
smExtsnVersion OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (0..32))
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The version number of the language extension.
|
|
It is suggested that the version number consist of one or
|
|
more decimal numbers separated by dots, where the first
|
|
number is called the major version number."
|
|
::= { smExtsnEntry 3 }
|
|
|
|
smExtsnVendor OBJECT-TYPE
|
|
SYNTAX OBJECT IDENTIFIER
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An object identifier which identifies the vendor who
|
|
provides the implementation of the extension. The
|
|
object identifier value should point to the OID node
|
|
directly below the enterprise OID {1 3 6 1 4 1}
|
|
allocated for the vendor. The value must by the object
|
|
identifier {0 0} if the vendor is not known."
|
|
::= { smExtsnEntry 4 }
|
|
|
|
smExtsnRevision OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (0..32))
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The version number of the extension implementation.
|
|
The value of this object must be an empty string if
|
|
version number of the implementation is unknown.
|
|
|
|
It is suggested that the value consist of one or more
|
|
decimal numbers separated by dots, where the first
|
|
number is called the major version number."
|
|
::= { smExtsnEntry 5 }
|
|
|
|
smExtsnDescr OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A textual description of the language extension."
|
|
::= { smExtsnEntry 6 }
|
|
|
|
--
|
|
-- Scripts known by the Script MIB implementation.
|
|
--
|
|
-- This group defines a table which lists all known scripts.
|
|
-- Scripts can be added and removed through manipulation of the
|
|
-- smScriptTable.
|
|
--
|
|
|
|
smScriptObjects OBJECT IDENTIFIER ::= { smObjects 3 }
|
|
|
|
smScriptTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF SmScriptEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists and describes locally known scripts."
|
|
::= { smScriptObjects 1 }
|
|
|
|
smScriptEntry OBJECT-TYPE
|
|
SYNTAX SmScriptEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describing a particular script. Every script that
|
|
is stored in non-volatile memory is required to appear in
|
|
this script table."
|
|
INDEX { smScriptOwner, smScriptName }
|
|
::= { smScriptTable 1 }
|
|
|
|
SmScriptEntry ::= SEQUENCE {
|
|
smScriptOwner SnmpAdminString,
|
|
smScriptName SnmpAdminString,
|
|
smScriptDescr SnmpAdminString,
|
|
smScriptLanguage Integer32,
|
|
smScriptSource DisplayString,
|
|
smScriptAdminStatus INTEGER,
|
|
smScriptOperStatus INTEGER,
|
|
smScriptStorageType StorageType,
|
|
smScriptRowStatus RowStatus,
|
|
smScriptError SnmpAdminString,
|
|
smScriptLastChange DateAndTime
|
|
}
|
|
|
|
smScriptOwner OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (0..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The manager who owns this row in the smScriptTable."
|
|
::= { smScriptEntry 1 }
|
|
|
|
smScriptName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (1..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The locally-unique, administratively assigned name for this
|
|
script. This object allows an smScriptOwner to have multiple
|
|
entries in the smScriptTable.
|
|
|
|
This value of this object may be used to derive the name
|
|
(e.g. a file name) which is used by the Script MIB
|
|
implementation to access the script in non-volatile
|
|
storage. The details of this mapping are implementation
|
|
specific. However, the mapping needs to ensure that scripts
|
|
created by different owners with the same script name do not
|
|
map to the same name in non-volatile storage."
|
|
::= { smScriptEntry 2 }
|
|
|
|
smScriptDescr OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A description of the purpose of the script."
|
|
::= { smScriptEntry 3 }
|
|
|
|
smScriptLanguage OBJECT-TYPE
|
|
SYNTAX Integer32 (0..2147483647)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object type identifies an entry in the
|
|
smLangTable which is used to execute this script.
|
|
The special value 0 may be used by hard-wired scripts
|
|
that can not be modified and that are executed by
|
|
internal functions.
|
|
|
|
Set requests to change this object are invalid if the
|
|
value of smScriptOperStatus is `enabled' or `compiling'
|
|
and will result in an inconsistentValue error.
|
|
|
|
Note that the data type and the range of this object must
|
|
be consistent with the definition of smLangIndex."
|
|
::= { smScriptEntry 4 }
|
|
|
|
smScriptSource OBJECT-TYPE
|
|
SYNTAX DisplayString
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object either contains a reference to the script
|
|
source or an empty string. A reference must be given
|
|
in the form of a Uniform Resource Locator (URL) as
|
|
defined in RFC 2396. The allowed character sets and the
|
|
encoding rules defined in RFC 2396 section 2 apply.
|
|
|
|
When the smScriptAdminStatus object is set to `enabled',
|
|
the Script MIB implementation will `pull' the script
|
|
source from the URL contained in this object if the URL
|
|
is not empty.
|
|
|
|
An empty URL indicates that the script source is loaded
|
|
from local storage. The script is read from the smCodeTable
|
|
if the value of smScriptStorageType is volatile. Otherwise,
|
|
the script is read from non-volatile storage.
|
|
|
|
Note: This document does not mandate implementation of any
|
|
specific URL scheme. An attempt to load a script from a
|
|
nonsupported URL scheme will cause the smScriptOperStatus
|
|
to report an `unknownProtocol' error.
|
|
|
|
Set requests to change this object are invalid if the
|
|
value of smScriptOperStatus is `enabled', `editing',
|
|
`retrieving' or `compiling' and will result in an
|
|
inconsistentValue error."
|
|
DEFVAL { ''H }
|
|
::= { smScriptEntry 5 }
|
|
|
|
smScriptAdminStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
enabled(1),
|
|
disabled(2),
|
|
editing(3)
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object indicates the desired status of
|
|
the script. See the definition of smScriptOperStatus for
|
|
a description of the values.
|
|
|
|
When the smScriptAdminStatus object is set to `enabled' and
|
|
the smScriptOperStatus is `disabled' or one of the error
|
|
states, the Script MIB implementation will `pull' the script
|
|
source from the URL contained in the smScriptSource object
|
|
if the URL is not empty."
|
|
DEFVAL { disabled }
|
|
::= { smScriptEntry 6 }
|
|
|
|
smScriptOperStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
enabled(1),
|
|
disabled(2),
|
|
editing(3),
|
|
retrieving(4),
|
|
compiling(5),
|
|
noSuchScript(6),
|
|
accessDenied(7),
|
|
wrongLanguage(8),
|
|
wrongVersion(9),
|
|
compilationFailed(10),
|
|
noResourcesLeft(11),
|
|
unknownProtocol(12),
|
|
protocolFailure(13),
|
|
genericError(14)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The actual status of the script in the runtime system. The
|
|
value of this object is only meaningful when the value of
|
|
the smScriptRowStatus object is `active'.
|
|
|
|
The smScriptOperStatus object may have the following values:
|
|
|
|
- `enabled' indicates that the script is available and can
|
|
be started by a launch table entry.
|
|
|
|
- `disabled' indicates that the script can not be used.
|
|
|
|
- `editing' indicates that the script can be modified in the
|
|
smCodeTable.
|
|
|
|
- `retrieving' indicates that the script is currently being
|
|
loaded from non-volatile storage or a remote system.
|
|
|
|
- `compiling' indicates that the script is currently being
|
|
compiled by the runtime system.
|
|
|
|
- `noSuchScript' indicates that the script does not exist
|
|
at the smScriptSource.
|
|
|
|
- `accessDenied' indicates that the script can not be loaded
|
|
from the smScriptSource due to a lack of permissions.
|
|
|
|
- `wrongLanguage' indicates that the script can not be
|
|
loaded from the smScriptSource because of a language
|
|
mismatch.
|
|
|
|
- `wrongVersion' indicates that the script can not be loaded
|
|
from the smScriptSource because of a language version
|
|
mismatch.
|
|
|
|
- `compilationFailed' indicates that the compilation failed.
|
|
|
|
- `noResourcesLeft' indicates that the runtime system does
|
|
not have enough resources to load the script.
|
|
|
|
- `unknownProtocol' indicates that the script could not be
|
|
loaded from the smScriptSource because the requested
|
|
protocol is not supported.
|
|
|
|
- `protocolFailure' indicates that the script could not be
|
|
loaded from the smScriptSource because of a protocol
|
|
failure.
|
|
|
|
- `genericError' indicates that the script could not be
|
|
|
|
loaded due to an error condition not listed above.
|
|
|
|
The `retrieving' and `compiling' states are transient states
|
|
which will either lead to one of the error states or the
|
|
`enabled' state. The `disabled' and `editing' states are
|
|
administrative states which are only reached by explicit
|
|
management operations.
|
|
|
|
All launch table entries that refer to this script table
|
|
entry shall have an smLaunchOperStatus value of `disabled'
|
|
when the value of this object is not `enabled'."
|
|
DEFVAL { disabled }
|
|
::= { smScriptEntry 7 }
|
|
|
|
smScriptStorageType OBJECT-TYPE
|
|
SYNTAX StorageType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object defines whether this row and the script
|
|
controlled by this row are kept in volatile storage and
|
|
lost upon reboot or if this row is backed up by
|
|
non-volatile or permanent storage.
|
|
|
|
The storage type of this row always complies with the value
|
|
of this entry if the value of the corresponding RowStatus
|
|
object is `active'.
|
|
|
|
However, the storage type of the script controlled by this
|
|
row may be different, if the value of this entry is
|
|
`non-volatile'. The script controlled by this row is written
|
|
into local non-volatile storage if the following condition
|
|
becomes true:
|
|
|
|
(a) the URL contained in the smScriptSource object is empty
|
|
and
|
|
(b) the smScriptStorageType is `nonVolatile'
|
|
and
|
|
(c) the smScriptOperStatus is `enabled'
|
|
|
|
Setting this object to `volatile' removes a script from
|
|
non-volatile storage if the script controlled by this row
|
|
has been in non-volatile storage before. Attempts to set
|
|
this object to permanent will always fail with an
|
|
inconsistentValue error.
|
|
|
|
The value of smScriptStorageType is only meaningful if the
|
|
value of the corresponding RowStatus object is `active'.
|
|
|
|
If smScriptStorageType has the value permanent(4), then all
|
|
objects whose MAX-ACCESS value is read-create must be
|
|
writable, with the exception of the smScriptStorageType and
|
|
smScriptRowStatus objects, which shall be read-only."
|
|
DEFVAL { volatile }
|
|
::= { smScriptEntry 8 }
|
|
|
|
smScriptRowStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A control that allows entries to be added and removed from
|
|
this table.
|
|
|
|
Changing the smScriptRowStatus from `active' to
|
|
`notInService' will remove the associated script from the
|
|
runtime system.
|
|
|
|
Deleting conceptual rows from this table may affect the
|
|
deletion of other resources associated with this row. For
|
|
example, a script stored in non-volatile storage may be
|
|
removed from non-volatile storage.
|
|
|
|
An entry may not exist in the `active' state unless all
|
|
required objects in the entry have appropriate values. Rows
|
|
that are not complete or not in service are not known by the
|
|
script runtime system.
|
|
|
|
Attempts to `destroy' a row or to set a row `notInService'
|
|
while the smScriptOperStatus is `enabled' will result in an
|
|
inconsistentValue error.
|
|
|
|
Attempts to `destroy' a row or to set a row `notInService'
|
|
where the value of the smScriptStorageType object is
|
|
`permanent' or `readOnly' will result in an
|
|
inconsistentValue error.
|
|
|
|
The value of this object has no effect on whether other
|
|
objects in this conceptual row can be modified."
|
|
::= { smScriptEntry 9 }
|
|
|
|
smScriptError OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object contains a descriptive error message if the
|
|
|
|
transition into the operational status `enabled' failed.
|
|
Implementations must reset the error message to a
|
|
zero-length string when a new attempt to change the
|
|
script status to `enabled' is started."
|
|
DEFVAL { ''H }
|
|
::= { smScriptEntry 10 }
|
|
|
|
smScriptLastChange OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The date and time when this script table entry was last
|
|
modified. The value '0000000000000000'H is returned if
|
|
the script table entry has not yet been modified.
|
|
|
|
Note that the resetting of smScriptError is not considered
|
|
a change of the script table entry."
|
|
DEFVAL { '0000000000000000'H }
|
|
::= { smScriptEntry 11 }
|
|
|
|
--
|
|
-- Access to script code via SNMP
|
|
--
|
|
-- The smCodeTable allows script code to be read and modified
|
|
-- via SNMP.
|
|
--
|
|
|
|
smCodeTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF SmCodeEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains the script code for scripts that are
|
|
written via SNMP write operations."
|
|
::= { smScriptObjects 2 }
|
|
|
|
smCodeEntry OBJECT-TYPE
|
|
SYNTAX SmCodeEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describing a particular fragment of a script."
|
|
INDEX { smScriptOwner, smScriptName, smCodeIndex }
|
|
::= { smCodeTable 1 }
|
|
|
|
SmCodeEntry ::= SEQUENCE {
|
|
smCodeIndex Unsigned32,
|
|
smCodeText OCTET STRING,
|
|
smCodeRowStatus RowStatus
|
|
}
|
|
|
|
smCodeIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The index value identifying this code fragment."
|
|
::= { smCodeEntry 1 }
|
|
|
|
smCodeText OBJECT-TYPE
|
|
SYNTAX OCTET STRING (SIZE (1..1024))
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The code that makes up a fragment of a script. The format
|
|
of this code fragment depends on the script language which
|
|
is identified by the associated smScriptLanguage object."
|
|
::= { smCodeEntry 2 }
|
|
|
|
smCodeRowStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A control that allows entries to be added and removed from
|
|
this table.
|
|
|
|
The value of this object has no effect on whether other
|
|
objects in this conceptual row can be modified."
|
|
::= { smCodeEntry 3 }
|
|
|
|
--
|
|
-- Script execution.
|
|
--
|
|
-- This group defines tables which allow script execution to be
|
|
-- initiated, suspended, resumed, and terminated. It also provides
|
|
-- a mechanism for keeping a history of recent script executions
|
|
-- and their results.
|
|
--
|
|
|
|
smRunObjects OBJECT IDENTIFIER ::= { smObjects 4 }
|
|
|
|
smLaunchTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF SmLaunchEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists and describes scripts that are ready
|
|
to be executed together with their parameters."
|
|
::= { smRunObjects 1 }
|
|
|
|
smLaunchEntry OBJECT-TYPE
|
|
SYNTAX SmLaunchEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describing a particular executable script."
|
|
INDEX { smLaunchOwner, smLaunchName }
|
|
::= { smLaunchTable 1 }
|
|
|
|
SmLaunchEntry ::= SEQUENCE {
|
|
smLaunchOwner SnmpAdminString,
|
|
smLaunchName SnmpAdminString,
|
|
smLaunchScriptOwner SnmpAdminString,
|
|
smLaunchScriptName SnmpAdminString,
|
|
smLaunchArgument OCTET STRING,
|
|
smLaunchMaxRunning Unsigned32,
|
|
smLaunchMaxCompleted Unsigned32,
|
|
smLaunchLifeTime TimeInterval,
|
|
smLaunchExpireTime TimeInterval,
|
|
smLaunchStart Integer32,
|
|
smLaunchControl INTEGER,
|
|
smLaunchAdminStatus INTEGER,
|
|
smLaunchOperStatus INTEGER,
|
|
smLaunchRunIndexNext Integer32,
|
|
smLaunchStorageType StorageType,
|
|
smLaunchRowStatus RowStatus,
|
|
smLaunchError SnmpAdminString,
|
|
smLaunchLastChange DateAndTime,
|
|
smLaunchRowExpireTime TimeInterval
|
|
}
|
|
|
|
smLaunchOwner OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (0..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The manager who owns this row in the smLaunchTable. Every
|
|
instance of a running script started from a particular entry
|
|
in the smLaunchTable (i.e. entries in the smRunTable) will
|
|
be owned by the same smLaunchOwner used to index the entry
|
|
in the smLaunchTable. This owner is not necessarily the same
|
|
as the owner of the script itself (smLaunchScriptOwner)."
|
|
::= { smLaunchEntry 1 }
|
|
|
|
smLaunchName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (1..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The locally-unique, administratively assigned name for this
|
|
launch table entry. This object allows an smLaunchOwner to
|
|
have multiple entries in the smLaunchTable. The smLaunchName
|
|
is an arbitrary name that must be different from any other
|
|
smLaunchTable entries with the same smLaunchOwner but can be
|
|
the same as other entries in the smLaunchTable with
|
|
different smLaunchOwner values. Note that the value of
|
|
smLaunchName is not related in any way to the name of the
|
|
script being launched."
|
|
::= { smLaunchEntry 2 }
|
|
|
|
smLaunchScriptOwner OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (0..32))
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object in combination with the value of
|
|
smLaunchScriptName identifies the script that can be
|
|
launched from this smLaunchTable entry. Attempts to write
|
|
this object will fail with an inconsistentValue error if
|
|
the value of smLaunchOperStatus is `enabled'."
|
|
::= { smLaunchEntry 3 }
|
|
|
|
smLaunchScriptName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (0..32))
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object in combination with the value of
|
|
the smLaunchScriptOwner identifies the script that can be
|
|
launched from this smLaunchTable entry. The zero-length
|
|
string may be used to point to a non-existing script.
|
|
|
|
Attempts to write this object will fail with an
|
|
inconsistentValue error if the value of smLaunchOperStatus
|
|
is `enabled'."
|
|
DEFVAL { ''H }
|
|
::= { smLaunchEntry 4 }
|
|
|
|
smLaunchArgument OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The argument supplied to the script. When a script is
|
|
invoked, the value of this object is used to initialize
|
|
the smRunArgument object."
|
|
DEFVAL { ''H }
|
|
::= { smLaunchEntry 5 }
|
|
|
|
smLaunchMaxRunning OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The maximum number of concurrently running scripts that may
|
|
be invoked from this entry in the smLaunchTable. Lowering
|
|
the current value of this object does not affect any scripts
|
|
that are already executing."
|
|
DEFVAL { 1 }
|
|
::= { smLaunchEntry 6 }
|
|
|
|
smLaunchMaxCompleted OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The maximum number of finished scripts invoked from this
|
|
entry in the smLaunchTable allowed to be retained in the
|
|
smRunTable. Whenever the value of this object is changed
|
|
and whenever a script terminates, entries in the smRunTable
|
|
are deleted if necessary until the number of completed
|
|
scripts is smaller than the value of this object. Scripts
|
|
whose smRunEndTime value indicates the oldest completion
|
|
time are deleted first."
|
|
DEFVAL { 1 }
|
|
::= { smLaunchEntry 7 }
|
|
|
|
smLaunchLifeTime OBJECT-TYPE
|
|
SYNTAX TimeInterval
|
|
UNITS "centi-seconds"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The default maximum amount of time a script launched
|
|
from this entry may run. The value of this object is used
|
|
to initialize the smRunLifeTime object when a script is
|
|
launched. Changing the value of an smLaunchLifeTime
|
|
instance does not affect scripts previously launched from
|
|
|
|
this entry."
|
|
DEFVAL { 360000 }
|
|
::= { smLaunchEntry 8 }
|
|
|
|
smLaunchExpireTime OBJECT-TYPE
|
|
SYNTAX TimeInterval
|
|
UNITS "centi-seconds"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The default maximum amount of time information about a
|
|
script launched from this entry is kept in the smRunTable
|
|
after the script has completed execution. The value of
|
|
this object is used to initialize the smRunExpireTime
|
|
object when a script is launched. Changing the value of an
|
|
smLaunchExpireTime instance does not affect scripts
|
|
previously launched from this entry."
|
|
DEFVAL { 360000 }
|
|
::= { smLaunchEntry 9 }
|
|
|
|
smLaunchStart OBJECT-TYPE
|
|
SYNTAX Integer32 (0..2147483647)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object is used to start the execution of scripts.
|
|
When retrieved, the value will be the value of smRunIndex
|
|
for the last script that started execution by manipulating
|
|
this object. The value will be zero if no script started
|
|
execution yet.
|
|
|
|
A script is started by setting this object to an unused
|
|
smRunIndex value. A new row in the smRunTable will be
|
|
created which is indexed by the value supplied by the
|
|
set-request in addition to the value of smLaunchOwner and
|
|
smLaunchName. An unused value can be obtained by reading
|
|
the smLaunchRunIndexNext object.
|
|
|
|
Setting this object to the special value 0 will start
|
|
the script with a self-generated smRunIndex value. The
|
|
consequence is that the script invoker has no reliable
|
|
way to determine the smRunIndex value for this script
|
|
invocation and that the invoker has therefore no way
|
|
to obtain the results from this script invocation. The
|
|
special value 0 is however useful for scheduled script
|
|
invocations.
|
|
|
|
If this object is set, the following checks must be
|
|
|
|
performed:
|
|
|
|
1) The value of the smLaunchOperStatus object in this
|
|
entry of the smLaunchTable must be `enabled'.
|
|
2) The values of smLaunchScriptOwner and
|
|
smLaunchScriptName of this row must identify an
|
|
existing entry in the smScriptTable.
|
|
3) The value of smScriptOperStatus of this entry must
|
|
be `enabled'.
|
|
4) The principal performing the set operation must have
|
|
read access to the script. This must be checked by
|
|
calling the isAccessAllowed abstract service interface
|
|
defined in RFC 2271 on the row in the smScriptTable
|
|
identified by smLaunchScriptOwner and smLaunchScriptName.
|
|
The isAccessAllowed abstract service interface must be
|
|
called on all columnar objects in the smScriptTable with
|
|
a MAX-ACCESS value different than `not-accessible'. The
|
|
test fails as soon as a call indicates that access is
|
|
not allowed.
|
|
5) If the value provided by the set operation is not 0,
|
|
a check must be made that the value is currently not
|
|
in use. Otherwise, if the value provided by the set
|
|
operation is 0, a suitable unused value must be
|
|
generated.
|
|
6) The number of currently executing scripts invoked
|
|
from this smLaunchTable entry must be less than
|
|
smLaunchMaxRunning.
|
|
|
|
Attempts to start a script will fail with an
|
|
inconsistentValue error if one of the checks described
|
|
above fails.
|
|
|
|
Otherwise, if all checks have been passed, a new entry
|
|
in the smRunTable will be created indexed by smLaunchOwner,
|
|
smLaunchName and the new value for smRunIndex. The value
|
|
of smLaunchArgument will be copied into smRunArgument,
|
|
the value of smLaunchLifeTime will be copied to
|
|
smRunLifeTime, and the value of smLaunchExpireTime
|
|
will be copied to smRunExpireTime.
|
|
|
|
The smRunStartTime will be set to the current time and
|
|
the smRunState will be set to `initializing' before the
|
|
script execution is initiated in the appropriate runtime
|
|
system.
|
|
|
|
Note that the data type and the range of this object must
|
|
be consistent with the smRunIndex object. Since this
|
|
object might be written from the scheduling MIB, the
|
|
|
|
data type Integer32 rather than Unsigned32 is used."
|
|
DEFVAL { 0 }
|
|
::= { smLaunchEntry 10 }
|
|
|
|
smLaunchControl OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
abort(1),
|
|
suspend(2),
|
|
resume(3),
|
|
nop(4)
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object is used to request a state change for all
|
|
running scripts in the smRunTable that were started from
|
|
this row in the smLaunchTable.
|
|
|
|
Setting this object to abort(1), suspend(2) or resume(3)
|
|
will set the smRunControl object of all applicable rows
|
|
in the smRunTable to abort(1), suspend(2) or resume(3)
|
|
respectively. The phrase `applicable rows' means the set of
|
|
rows which were created from this entry in the smLaunchTable
|
|
and whose value of smRunState allows the corresponding
|
|
state change as described in the definition of the
|
|
smRunControl object. Setting this object to nop(4) has no
|
|
effect.
|
|
|
|
Attempts to set this object lead to an inconsistentValue
|
|
error only if all implicated sets on all the applicable
|
|
rows lead to inconsistentValue errors. It is not allowed
|
|
to return an inconsistentValue error if at least one state
|
|
change on one of the applicable rows was successful."
|
|
DEFVAL { nop }
|
|
::= { smLaunchEntry 11 }
|
|
|
|
smLaunchAdminStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
enabled(1),
|
|
disabled(2),
|
|
autostart(3)
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object indicates the desired status of
|
|
this launch table entry. The values enabled(1) and
|
|
autostart(3) both indicate that the launch table entry
|
|
|
|
should transition into the operational enabled(1) state as
|
|
soon as the associated script table entry is enabled(1).
|
|
|
|
The value autostart(3) further indicates that the script
|
|
is started automatically by conceptually writing the
|
|
value 0 into the associated smLaunchStart object during
|
|
the transition from the `disabled' into the `enabled'
|
|
operational state. This is useful for scripts that are
|
|
to be launched on system start-up."
|
|
DEFVAL { disabled }
|
|
::= { smLaunchEntry 12 }
|
|
|
|
smLaunchOperStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
enabled(1),
|
|
disabled(2),
|
|
expired(3)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object indicates the actual status of
|
|
this launch table entry. The smLaunchOperStatus object
|
|
may have the following values:
|
|
|
|
- `enabled' indicates that the launch table entry is
|
|
available and can be used to start scripts.
|
|
|
|
- `disabled' indicates that the launch table entry can
|
|
not be used to start scripts.
|
|
|
|
- `expired' indicates that the launch table entry can
|
|
not be used to start scripts and will disappear as
|
|
soon as all smRunTable entries associated with this
|
|
launch table entry have disappeared.
|
|
|
|
The value `enabled' requires that the smLaunchRowStatus
|
|
object is active. The value `disabled' requires that there
|
|
are no entries in the smRunTable associated with this
|
|
smLaunchTable entry."
|
|
DEFVAL { disabled }
|
|
::= { smLaunchEntry 13 }
|
|
|
|
smLaunchRunIndexNext OBJECT-TYPE
|
|
SYNTAX Integer32 (1..2147483647)
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This variable is used for creating rows in the smRunTable.
|
|
The value of this variable is a currently unused value
|
|
for smRunIndex, which can be written into the smLaunchStart
|
|
object associated with this row to launch a script.
|
|
|
|
The value returned when reading this variable must be unique
|
|
for the smLaunchOwner and smLaunchName associated with this
|
|
row. Subsequent attempts to read this variable must return
|
|
different values.
|
|
|
|
This variable will return the special value 0 if no new rows
|
|
can be created.
|
|
|
|
Note that the data type and the range of this object must be
|
|
consistent with the definition of smRunIndex."
|
|
::= { smLaunchEntry 14 }
|
|
|
|
smLaunchStorageType OBJECT-TYPE
|
|
SYNTAX StorageType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object defines if this row is kept in volatile storage
|
|
and lost upon reboot or if this row is backed up by stable
|
|
storage.
|
|
|
|
The value of smLaunchStorageType is only meaningful if the
|
|
value of the corresponding RowStatus object is active.
|
|
|
|
If smLaunchStorageType has the value permanent(4), then all
|
|
objects whose MAX-ACCESS value is read-create must be
|
|
writable, with the exception of the smLaunchStorageType and
|
|
smLaunchRowStatus objects, which shall be read-only."
|
|
DEFVAL { volatile }
|
|
::= { smLaunchEntry 15 }
|
|
|
|
smLaunchRowStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A control that allows entries to be added and removed from
|
|
this table.
|
|
|
|
Attempts to `destroy' a row or to set a row `notInService'
|
|
while the smLaunchOperStatus is `enabled' will result in
|
|
an inconsistentValue error.
|
|
|
|
Attempts to `destroy' a row or to set a row `notInService'
|
|
where the value of the smLaunchStorageType object is
|
|
`permanent' or `readOnly' will result in an
|
|
inconsistentValue error.
|
|
|
|
The value of this object has no effect on whether other
|
|
objects in this conceptual row can be modified."
|
|
::= { smLaunchEntry 16 }
|
|
|
|
smLaunchError OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object contains a descriptive error message if an
|
|
attempt to launch a script fails. Implementations must reset
|
|
the error message to a zero-length string when a new attempt
|
|
to launch a script is started."
|
|
DEFVAL { ''H }
|
|
::= { smLaunchEntry 17 }
|
|
|
|
smLaunchLastChange OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The date and time when this launch table entry was last
|
|
modified. The value '0000000000000000'H is returned if
|
|
the launch table entry has not yet been modified.
|
|
|
|
Note that a change of smLaunchStart, smLaunchControl,
|
|
smLaunchRunIndexNext, smLaunchRowExpireTime, or the
|
|
resetting of smLaunchError is not considered a change
|
|
of this launch table entry."
|
|
DEFVAL { '0000000000000000'H }
|
|
::= { smLaunchEntry 18 }
|
|
|
|
smLaunchRowExpireTime OBJECT-TYPE
|
|
SYNTAX TimeInterval
|
|
UNITS "centi-seconds"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object specifies how long this row remains
|
|
in the `enabled' or `disabled' operational state. The value
|
|
reported by this object ticks backwards. When the value
|
|
reaches 0, it stops ticking backward and the row is
|
|
deleted if there are no smRunTable entries associated with
|
|
|
|
this smLaunchTable entry. Otherwise, the smLaunchOperStatus
|
|
changes to `expired' and the row deletion is deferred
|
|
until there are no smRunTable entries associated with this
|
|
smLaunchTable entry.
|
|
|
|
The smLaunchRowExpireTime will not tick backwards if it is
|
|
set to its maximum value (2147483647). In other words,
|
|
setting this object to its maximum value turns the timer
|
|
off.
|
|
|
|
The value of this object may be set in order to increase
|
|
or reduce the remaining time that the launch table entry
|
|
may be used. Setting the value to 0 will cause an immediate
|
|
row deletion or transition into the `expired' operational
|
|
state.
|
|
|
|
It is not possible to set this object while the operational
|
|
status is `expired'. Attempts to modify this object while
|
|
the operational status is `expired' leads to an
|
|
inconsistentValue error.
|
|
|
|
Note that the timer ticks backwards independent of the
|
|
operational state of the launch table entry."
|
|
DEFVAL { 2147483647 }
|
|
::= { smLaunchEntry 19 }
|
|
|
|
smRunTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF SmRunEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists and describes scripts that are currently
|
|
running or have been running in the past."
|
|
::= { smRunObjects 2 }
|
|
|
|
smRunEntry OBJECT-TYPE
|
|
SYNTAX SmRunEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry describing a particular running or finished
|
|
script."
|
|
INDEX { smLaunchOwner, smLaunchName, smRunIndex }
|
|
::= { smRunTable 1 }
|
|
|
|
SmRunEntry ::= SEQUENCE {
|
|
smRunIndex Integer32,
|
|
smRunArgument OCTET STRING,
|
|
smRunStartTime DateAndTime,
|
|
smRunEndTime DateAndTime,
|
|
smRunLifeTime TimeInterval,
|
|
smRunExpireTime TimeInterval,
|
|
smRunExitCode INTEGER,
|
|
smRunResult OCTET STRING,
|
|
smRunControl INTEGER,
|
|
smRunState INTEGER,
|
|
smRunError SnmpAdminString,
|
|
smRunResultTime DateAndTime,
|
|
smRunErrorTime DateAndTime
|
|
}
|
|
|
|
smRunIndex OBJECT-TYPE
|
|
SYNTAX Integer32 (1..2147483647)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The locally arbitrary, but unique identifier associated
|
|
with this running or finished script. This value must be
|
|
unique for all rows in the smRunTable with the same
|
|
smLaunchOwner and smLaunchName.
|
|
|
|
Note that the data type and the range of this object must
|
|
be consistent with the definition of smLaunchRunIndexNext
|
|
and smLaunchStart."
|
|
::= { smRunEntry 1 }
|
|
|
|
smRunArgument OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The argument supplied to the script when it started."
|
|
DEFVAL { ''H }
|
|
::= { smRunEntry 2 }
|
|
|
|
smRunStartTime OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The date and time when the execution started. The value
|
|
'0000000000000000'H is returned if the script has not
|
|
started yet."
|
|
DEFVAL { '0000000000000000'H }
|
|
::= { smRunEntry 3 }
|
|
|
|
smRunEndTime OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The date and time when the execution terminated. The value
|
|
'0000000000000000'H is returned if the script has not
|
|
terminated yet."
|
|
DEFVAL { '0000000000000000'H }
|
|
::= { smRunEntry 4 }
|
|
|
|
smRunLifeTime OBJECT-TYPE
|
|
SYNTAX TimeInterval
|
|
UNITS "centi-seconds"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies how long the script can execute.
|
|
This object returns the remaining time that the script
|
|
may run. The object is initialized with the value of the
|
|
associated smLaunchLifeTime object and ticks backwards.
|
|
The script is aborted immediately when the value reaches 0.
|
|
|
|
The value of this object may be set in order to increase or
|
|
reduce the remaining time that the script may run. Setting
|
|
this value to 0 will abort script execution immediately,
|
|
and, if the value of smRunExpireTime is also 0, will remove
|
|
this entry from the smRunTable once it has terminated.
|
|
|
|
If smRunLifeTime is set to its maximum value (2147483647),
|
|
either by a set operation or by its initialization from the
|
|
smLaunchLifeTime object, then it will not tick backwards.
|
|
A running script with a maximum smRunLifeTime value will
|
|
thus never be terminated with a `lifeTimeExceeded' exit
|
|
code.
|
|
|
|
The value of smRunLifeTime reflects the real-time execution
|
|
time as seen by the outside world. The value of this object
|
|
will always be 0 for a script that finished execution, that
|
|
is smRunState has the value `terminated'.
|
|
|
|
The value of smRunLifeTime does not change while a script
|
|
is suspended, that is smRunState has the value `suspended'.
|
|
Note that this does not affect set operations. It is legal
|
|
to modify smRunLifeTime via set operations while a script
|
|
is suspended."
|
|
::= { smRunEntry 5 }
|
|
|
|
smRunExpireTime OBJECT-TYPE
|
|
SYNTAX TimeInterval
|
|
UNITS "centi-seconds"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object specifies how long this row can
|
|
exist in the smRunTable after the script has terminated.
|
|
This object returns the remaining time that the row may
|
|
exist before it is aged out. The object is initialized with
|
|
the value of the associated smLaunchExpireTime object and
|
|
ticks backwards. The entry in the smRunTable is destroyed
|
|
when the value reaches 0 and the smRunState has the value
|
|
`terminated'.
|
|
|
|
The value of this object may be set in order to increase or
|
|
reduce the remaining time that the row may exist. Setting
|
|
the value to 0 will destroy this entry as soon as the
|
|
smRunState has the value `terminated'."
|
|
::= { smRunEntry 6 }
|
|
|
|
smRunExitCode OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
noError(1),
|
|
halted(2),
|
|
lifeTimeExceeded(3),
|
|
noResourcesLeft(4),
|
|
languageError(5),
|
|
runtimeError(6),
|
|
invalidArgument(7),
|
|
securityViolation(8),
|
|
genericError(9)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object indicates the reason why a
|
|
script finished execution. The smRunExitCode code may have
|
|
one of the following values:
|
|
|
|
- `noError', which indicates that the script completed
|
|
successfully without errors;
|
|
|
|
- `halted', which indicates that the script was halted
|
|
by a request from an authorized manager;
|
|
|
|
- `lifeTimeExceeded', which indicates that the script
|
|
exited because a time limit was exceeded;
|
|
|
|
- `noResourcesLeft', which indicates that the script
|
|
exited because it ran out of resources (e.g. memory);
|
|
|
|
- `languageError', which indicates that the script exited
|
|
because of a language error (e.g. a syntax error in an
|
|
interpreted language);
|
|
|
|
- `runtimeError', which indicates that the script exited
|
|
due to a runtime error (e.g. a division by zero);
|
|
|
|
- `invalidArgument', which indicates that the script could
|
|
not be run because of invalid script arguments;
|
|
|
|
- `securityViolation', which indicates that the script
|
|
exited due to a security violation;
|
|
|
|
- `genericError', which indicates that the script exited
|
|
for an unspecified reason.
|
|
|
|
If the script has not yet begun running, or is currently
|
|
running, the value will be `noError'."
|
|
DEFVAL { noError }
|
|
::= { smRunEntry 7 }
|
|
|
|
smRunResult OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The result value produced by the running script. Note that
|
|
the result may change while the script is executing."
|
|
DEFVAL { ''H }
|
|
::= { smRunEntry 8 }
|
|
|
|
smRunControl OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
abort(1),
|
|
suspend(2),
|
|
resume(3),
|
|
nop(4)
|
|
}
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object indicates the desired status of the
|
|
script execution defined by this row.
|
|
|
|
Setting this object to `abort' will abort execution if the
|
|
|
|
value of smRunState is `initializing', `executing',
|
|
`suspending', `suspended' or `resuming'. Setting this object
|
|
to `abort' when the value of smRunState is `aborting' or
|
|
`terminated', or if the implementation can determine that
|
|
the attempt to abort the execution would fail, will result
|
|
in an inconsistentValue error.
|
|
|
|
Setting this object to `suspend' will suspend execution
|
|
if the value of smRunState is `executing'. Setting this
|
|
object to `suspend' will cause an inconsistentValue error
|
|
if the value of smRunState is not `executing' or if the
|
|
implementation can determine that the attempt to suspend
|
|
the execution would fail.
|
|
|
|
Setting this object to `resume' will resume execution
|
|
if the value of smRunState is `suspending' or
|
|
`suspended'. Setting this object to `resume' will cause an
|
|
inconsistentValue error if the value of smRunState is
|
|
not `suspended' or if the implementation can determine
|
|
that the attempt to resume the execution would fail.
|
|
|
|
Setting this object to nop(4) has no effect."
|
|
DEFVAL { nop }
|
|
::= { smRunEntry 9 }
|
|
|
|
smRunState OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
initializing(1),
|
|
executing(2),
|
|
suspending(3),
|
|
suspended(4),
|
|
resuming(5),
|
|
aborting(6),
|
|
terminated(7)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object indicates the script's execution
|
|
state. If the script has been invoked but has not yet
|
|
begun execution, the value will be `initializing'. If the
|
|
script is running, the value will be `executing'.
|
|
|
|
A running script which received a request to suspend
|
|
execution first transitions into a temporary `suspending'
|
|
state. The temporary `suspending' state changes to
|
|
`suspended' when the script has actually been suspended. The
|
|
temporary `suspending' state changes back to `executing' if
|
|
|
|
the attempt to suspend the running script fails.
|
|
|
|
A suspended script which received a request to resume
|
|
execution first transitions into a temporary `resuming'
|
|
state. The temporary `resuming' state changes to `running'
|
|
when the script has actually been resumed. The temporary
|
|
`resuming' state changes back to `suspended' if the attempt
|
|
to resume the suspended script fails.
|
|
|
|
A script which received a request to abort execution but
|
|
which is still running first transitions into a temporary
|
|
`aborting' state.
|
|
|
|
A script which has finished its execution is `terminated'."
|
|
::= { smRunEntry 10 }
|
|
|
|
smRunError OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object contains a descriptive error message if the
|
|
script startup or execution raised an abnormal condition.
|
|
An implementation must store a descriptive error message
|
|
in this object if the script exits with the smRunExitCode
|
|
`genericError'."
|
|
DEFVAL { ''H }
|
|
::= { smRunEntry 11 }
|
|
|
|
smRunResultTime OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The date and time when the smRunResult was last updated.
|
|
The value '0000000000000000'H is returned if smRunResult
|
|
has not yet been updated after the creation of this
|
|
smRunTable entry."
|
|
DEFVAL { '0000000000000000'H }
|
|
::= { smRunEntry 12 }
|
|
|
|
smRunErrorTime OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The date and time when the smRunError was last updated.
|
|
The value '0000000000000000'H is returned if smRunError
|
|
|
|
has not yet been updated after the creation of this
|
|
smRunTable entry."
|
|
DEFVAL { '0000000000000000'H }
|
|
::= { smRunEntry 13 }
|
|
|
|
--
|
|
-- Notifications. The definition of smTraps makes notification
|
|
-- registrations reversible (see STD 58, RFC 2578).
|
|
--
|
|
|
|
smTraps OBJECT IDENTIFIER ::= { smNotifications 0 }
|
|
|
|
smScriptAbort NOTIFICATION-TYPE
|
|
OBJECTS { smRunExitCode, smRunEndTime, smRunError }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This notification is generated whenever a running script
|
|
terminates with an smRunExitCode unequal to `noError'."
|
|
::= { smTraps 1 }
|
|
|
|
smScriptResult NOTIFICATION-TYPE
|
|
OBJECTS { smRunResult }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This notification can be used by scripts to notify other
|
|
management applications about results produced by the
|
|
script.
|
|
|
|
This notification is not automatically generated by the
|
|
Script MIB implementation. It is the responsibility of
|
|
the executing script to emit this notification where it
|
|
is appropriate to do so."
|
|
::= { smTraps 2 }
|
|
|
|
smScriptException NOTIFICATION-TYPE
|
|
OBJECTS { smRunError }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This notification can be used by scripts to notify other
|
|
management applications about script errors.
|
|
|
|
This notification is not automatically generated by the
|
|
Script MIB implementation. It is the responsibility of
|
|
the executing script or the runtime system to emit this
|
|
notification where it is appropriate to do so."
|
|
::= { smTraps 3 }
|
|
|
|
-- conformance information
|
|
|
|
smCompliances OBJECT IDENTIFIER ::= { smConformance 1 }
|
|
smGroups OBJECT IDENTIFIER ::= { smConformance 2 }
|
|
|
|
-- compliance statements
|
|
|
|
smCompliance2 MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for SNMP entities which implement
|
|
the Script MIB."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
smLanguageGroup, smScriptGroup2, smLaunchGroup2,
|
|
smRunGroup2, smNotificationsGroup2
|
|
}
|
|
GROUP smCodeGroup
|
|
DESCRIPTION
|
|
"The smCodeGroup is mandatory only for those implementations
|
|
that support the downloading of scripts via SNMP."
|
|
OBJECT smScriptSource
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"The smScriptSource object is read-only for implementations
|
|
that are not able to download script code from a URL."
|
|
OBJECT smCodeText
|
|
DESCRIPTION
|
|
"A compliant implementation need only support write access to
|
|
the smCodeText object only during row creation."
|
|
OBJECT smLaunchArgument
|
|
DESCRIPTION
|
|
"A compliant implementation has to support a minimum size
|
|
for smLaunchArgument of 255 octets."
|
|
OBJECT smRunArgument
|
|
DESCRIPTION
|
|
"A compliant implementation has to support a minimum size
|
|
for smRunArgument of 255 octets."
|
|
OBJECT smRunResult
|
|
DESCRIPTION
|
|
"A compliant implementation has to support a minimum size
|
|
for smRunResult of 255 octets."
|
|
OBJECT smRunState
|
|
DESCRIPTION
|
|
"A compliant implementation does not have to support script
|
|
suspension and the smRunState `suspended'. Such an
|
|
implementation will change into the `suspending' state
|
|
when the smRunControl is set to `suspend' and remain in this
|
|
state until smRunControl is set to `resume' or the script
|
|
terminates."
|
|
::= { smCompliances 2 }
|
|
|
|
smLanguageGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
smLangLanguage, smLangVersion,
|
|
smLangVendor, smLangRevision,
|
|
smLangDescr, smExtsnExtension,
|
|
smExtsnVersion, smExtsnVendor,
|
|
smExtsnRevision, smExtsnDescr
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing information about the
|
|
capabilities of the scripting engine."
|
|
::= { smGroups 1 }
|
|
|
|
smScriptGroup2 OBJECT-GROUP
|
|
OBJECTS {
|
|
smScriptDescr, smScriptLanguage,
|
|
smScriptSource, smScriptAdminStatus,
|
|
smScriptOperStatus, smScriptStorageType,
|
|
smScriptRowStatus, smScriptError,
|
|
smScriptLastChange
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing information about
|
|
installed scripts."
|
|
::= { smGroups 7 }
|
|
|
|
smCodeGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
smCodeText, smCodeRowStatus
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects used to download or modify scripts
|
|
by using SNMP set requests."
|
|
::= { smGroups 3 }
|
|
|
|
smLaunchGroup2 OBJECT-GROUP
|
|
OBJECTS {
|
|
smLaunchScriptOwner, smLaunchScriptName,
|
|
smLaunchArgument, smLaunchMaxRunning,
|
|
smLaunchMaxCompleted, smLaunchLifeTime,
|
|
smLaunchExpireTime, smLaunchStart,
|
|
smLaunchControl, smLaunchAdminStatus,
|
|
smLaunchOperStatus, smLaunchRunIndexNext,
|
|
smLaunchStorageType, smLaunchRowStatus,
|
|
smLaunchError, smLaunchLastChange,
|
|
smLaunchRowExpireTime
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing information about scripts
|
|
that can be launched."
|
|
::= { smGroups 8 }
|
|
|
|
smRunGroup2 OBJECT-GROUP
|
|
OBJECTS {
|
|
smRunArgument, smRunStartTime,
|
|
smRunEndTime, smRunLifeTime,
|
|
smRunExpireTime, smRunExitCode,
|
|
smRunResult, smRunState,
|
|
smRunControl, smRunError,
|
|
smRunResultTime, smRunErrorTime
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing information about running
|
|
scripts."
|
|
::= { smGroups 9 }
|
|
|
|
smNotificationsGroup2 NOTIFICATION-GROUP
|
|
NOTIFICATIONS {
|
|
smScriptAbort,
|
|
smScriptResult,
|
|
smScriptException
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The notifications emitted by the Script MIB."
|
|
::= { smGroups 10 }
|
|
|
|
--
|
|
-- Deprecated compliance and conformance group definitions
|
|
-- from RFC 2592.
|
|
--
|
|
|
|
smCompliance MODULE-COMPLIANCE
|
|
STATUS deprecated
|
|
DESCRIPTION
|
|
"The compliance statement for SNMP entities which implement
|
|
the Script MIB."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
|
|
smLanguageGroup, smScriptGroup, smLaunchGroup, smRunGroup
|
|
}
|
|
GROUP smCodeGroup
|
|
DESCRIPTION
|
|
"The smCodeGroup is mandatory only for those implementations
|
|
that support the downloading of scripts via SNMP."
|
|
OBJECT smScriptSource
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"The smScriptSource object is read-only for implementations
|
|
that are not able to download script code from a URL."
|
|
OBJECT smCodeText
|
|
DESCRIPTION
|
|
"A compliant implementation need only support write access
|
|
to the smCodeText object during row creation."
|
|
OBJECT smLaunchArgument
|
|
DESCRIPTION
|
|
"A compliant implementation has to support a minimum size
|
|
for smLaunchArgument of 255 octets."
|
|
OBJECT smRunArgument
|
|
DESCRIPTION
|
|
"A compliant implementation has to support a minimum size
|
|
for smRunArgument of 255 octets."
|
|
OBJECT smRunResult
|
|
DESCRIPTION
|
|
"A compliant implementation has to support a minimum size
|
|
for smRunResult of 255 octets."
|
|
OBJECT smRunState
|
|
DESCRIPTION
|
|
"A compliant implementation does not have to support script
|
|
suspension and the smRunState `suspended'. Such an
|
|
implementation will change into the `suspending' state
|
|
when the smRunControl is set to `suspend' and remain in this
|
|
state until smRunControl is set to `resume' or the script
|
|
terminates."
|
|
::= { smCompliances 1 }
|
|
|
|
smScriptGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
smScriptDescr, smScriptLanguage,
|
|
smScriptSource, smScriptAdminStatus,
|
|
smScriptOperStatus, smScriptStorageType,
|
|
smScriptRowStatus
|
|
}
|
|
STATUS deprecated
|
|
DESCRIPTION
|
|
"A collection of objects providing information about
|
|
installed scripts."
|
|
::= { smGroups 2 }
|
|
|
|
smLaunchGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
smLaunchScriptOwner, smLaunchScriptName,
|
|
smLaunchArgument, smLaunchMaxRunning,
|
|
smLaunchMaxCompleted, smLaunchLifeTime,
|
|
smLaunchExpireTime, smLaunchStart,
|
|
smLaunchControl, smLaunchAdminStatus,
|
|
smLaunchOperStatus, smLaunchRunIndexNext,
|
|
smLaunchStorageType, smLaunchRowStatus
|
|
}
|
|
STATUS deprecated
|
|
DESCRIPTION
|
|
"A collection of objects providing information about scripts
|
|
that can be launched."
|
|
::= { smGroups 4 }
|
|
|
|
smRunGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
smRunArgument, smRunStartTime,
|
|
smRunEndTime, smRunLifeTime,
|
|
smRunExpireTime, smRunExitCode,
|
|
smRunResult, smRunState,
|
|
smRunControl, smRunError
|
|
}
|
|
STATUS deprecated
|
|
DESCRIPTION
|
|
"A collection of objects providing information about running
|
|
scripts."
|
|
::= { smGroups 5 }
|
|
|
|
smNotificationsGroup NOTIFICATION-GROUP
|
|
NOTIFICATIONS {
|
|
smScriptAbort,
|
|
smScriptResult
|
|
}
|
|
STATUS deprecated
|
|
DESCRIPTION
|
|
"The notifications emitted by the Script MIB."
|
|
::= { smGroups 6 }
|
|
|
|
END
|