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 "9902221800Z"

    ORGANIZATION "IETF Distributed Management Working Group"

    CONTACT-INFO

        "David B. Levi

         Nortel Networks

         4401 Great America Parkway

         Santa Clara, CA 95052-8185

         U.S.A.

         Tel: +1 423 686 0432

         E-mail: dlevi@nortelnetworks.com

         Juergen Schoenwaelder

         TU Braunschweig

         Bueltenweg 74/75

         38106 Braunschweig

         Germany

         Tel: +49 531 391-3283

         E-mail: schoenw@ibr.cs.tu-bs.de"

    DESCRIPTION

        "This MIB module defines a set of objects that allow to

         delegate management scripts to distributed managers."

    ::= { 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, 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 identifer which identifies the vendor who

         provides the implementation of the language. This object

         identifer 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 identifer which identifies the vendor who

         provides the implementation of the extension. The

         object identifer 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

}

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

    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.

         Note, 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. A 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 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.

         The value of smScriptOperStatus will be reset to `disabled'.

         Deleting conceptual rows from this table includes the

         deletion of all resources associated with this row. This

         implies that a script stored in non-volatile storage is

         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 script is executing 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."

    ::= { smScriptEntry 9 }

--

-- 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."

    ::= { 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

}

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. Attempts to write

         this objects will fail with an inconsistentValue error if

         the value of smLaunchOperStatus is `enabled'."

    ::= { 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, 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