Blame mibs/ietf/SYSAPPL-MIB

Packit 022b05
  SYSAPPL-MIB DEFINITIONS ::= BEGIN
Packit 022b05
Packit 022b05
  IMPORTS
Packit 022b05
      MODULE-IDENTITY, OBJECT-TYPE,
Packit 022b05
      Unsigned32, TimeTicks, Counter32, Gauge32
Packit 022b05
          FROM SNMPv2-SMI
Packit 022b05
      DateAndTime, TEXTUAL-CONVENTION
Packit 022b05
          FROM SNMPv2-TC
Packit 022b05
      MODULE-COMPLIANCE, OBJECT-GROUP
Packit 022b05
          FROM SNMPv2-CONF
Packit 022b05
      mib-2 FROM SNMPv2-SMI;
Packit 022b05
Packit 022b05
  -- System Application MIB
Packit 022b05
Packit 022b05
  sysApplMIB MODULE-IDENTITY
Packit 022b05
      LAST-UPDATED "9710200000Z"
Packit 022b05
      ORGANIZATION "IETF Applications MIB Working Group"
Packit 022b05
      CONTACT-INFO
Packit 022b05
            "Cheryl Krupczak (Editor, WG Advisor)
Packit 022b05
             Postal: Empire Technologies, Inc.
Packit 022b05
             541 Tenth Street NW
Packit 022b05
             Suite 169
Packit 022b05
             Atlanta, GA 30318
Packit 022b05
             USA
Packit 022b05
             Phone: (770) 384-0184
Packit 022b05
             Email: cheryl@empiretech.com
Packit 022b05
Packit 022b05
             Jon Saperia (WG Chair)
Packit 022b05
             Postal:  BGS Systems, Inc.
Packit 022b05
             One First Avenue
Packit 022b05
             Waltham, MA 02254-9111
Packit 022b05
             USA
Packit 022b05
             Phone: (617) 891-0000
Packit 022b05
             Email: saperia@networks.bgs.com"
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The MIB module defines management objects that model
Packit 022b05
          applications as collections of executables and files
Packit 022b05
          installed and executing on a host system.  The MIB
Packit 022b05
          presents a system-level view of applications; i.e.,
Packit 022b05
          objects in this MIB are limited to those attributes
Packit 022b05
          that can typically be obtained from the system itself
Packit 022b05
          without adding special instrumentation to the applications."
Packit 022b05
      ::= { mib-2 54  }
Packit 022b05
Packit 022b05
Packit 022b05
  sysApplOBJ               OBJECT IDENTIFIER ::= { sysApplMIB 1 }
Packit 022b05
  sysApplInstalled         OBJECT IDENTIFIER ::= { sysApplOBJ 1 }
Packit 022b05
  sysApplRun               OBJECT IDENTIFIER ::= { sysApplOBJ 2 }
Packit 022b05
  sysApplMap               OBJECT IDENTIFIER ::= { sysApplOBJ 3 }
Packit 022b05
  sysApplNotifications     OBJECT IDENTIFIER ::= { sysApplMIB 2 }
Packit 022b05
  sysApplConformance       OBJECT IDENTIFIER ::= { sysApplMIB 3 }
Packit 022b05
Packit 022b05
  -- Textual Conventions
Packit 022b05
Packit 022b05
  RunState ::= TEXTUAL-CONVENTION
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "This TC describes the current execution state of
Packit 022b05
          a running application or process.  The possible
Packit 022b05
          values are:
Packit 022b05
            running(1),
Packit 022b05
            runnable(2),  - waiting for a resource (CPU, etc.)
Packit 022b05
            waiting(3),   - waiting for an event
Packit 022b05
            exiting(4),
Packit 022b05
            other(5)      - other invalid state"
Packit 022b05
      SYNTAX      INTEGER {
Packit 022b05
                  running (1),
Packit 022b05
                  runnable (2), -- waiting for resource (CPU, etc.)
Packit 022b05
                  waiting (3),  -- waiting for event
Packit 022b05
                  exiting (4),
Packit 022b05
                  other (5)     -- other invalid state
Packit 022b05
                  }
Packit 022b05
Packit 022b05
LongUtf8String ::= TEXTUAL-CONVENTION
Packit 022b05
        DISPLAY-HINT "1024a"
Packit 022b05
        STATUS  current
Packit 022b05
        DESCRIPTION
Packit 022b05
                "To facilitate internationalization, this TC
Packit 022b05
                 represents information taken from the ISO/IEC IS
Packit 022b05
                 10646-1 character set, encoded as an octet string
Packit 022b05
                 using the UTF-8 character encoding scheme described
Packit 022b05
                 in RFC 2044 [10].  For strings in 7-bit US-ASCII,
Packit 022b05
                 there is no impact since the UTF-8 representation
Packit 022b05
                 is identical to the US-ASCII encoding."
Packit 022b05
        SYNTAX  OCTET STRING (SIZE (0..1024))
Packit 022b05
Packit 022b05
Utf8String ::= TEXTUAL-CONVENTION
Packit 022b05
        DISPLAY-HINT "255a"
Packit 022b05
        STATUS  current
Packit 022b05
        DESCRIPTION
Packit 022b05
                "To facilitate internationalization, this TC
Packit 022b05
                 represents information taken from the ISO/IEC IS
Packit 022b05
                 10646-1 character set, encoded as an octet string
Packit 022b05
                 using the UTF-8 character encoding scheme described
Packit 022b05
                 in RFC 2044 [10].  For strings in 7-bit US-ASCII,
Packit 022b05
                 there is no impact since the UTF-8 representation
Packit 022b05
                 is identical to the US-ASCII encoding."
Packit 022b05
        SYNTAX  OCTET STRING (SIZE (0..255))
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
  -- sysApplInstalled Group
Packit 022b05
  -- This group provides information about application packages
Packit 022b05
  -- that have been installed on the host computer.  The group
Packit 022b05
  -- contains two tables.  The first, the sysApplInstallPkgTable,
Packit 022b05
  -- describes the application packages, the second, the
Packit 022b05
  -- sysApplInstallElmtTable, describes the constituent elements
Packit 022b05
  -- (files and executables) which compose an application package.
Packit 022b05
Packit 022b05
  --
Packit 022b05
  -- In order to appear in this group, an application and its
Packit 022b05
  -- component files must be discoverable by the system itself,
Packit 022b05
  -- possibly through some type of software installation mechanism
Packit 022b05
  -- or registry.
Packit 022b05
Packit 022b05
  -- sysApplInstallPkgTable
Packit 022b05
  -- The system installed application packages table provides
Packit 022b05
  -- information on the software packages installed on a system.
Packit 022b05
  -- These packages may consist of many different files including
Packit 022b05
  -- executable and non-executable files.
Packit 022b05
Packit 022b05
  sysApplInstallPkgTable OBJECT-TYPE
Packit 022b05
      SYNTAX      SEQUENCE OF SysApplInstallPkgEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The table listing the software application packages
Packit 022b05
          installed on a host computer. In order to appear in
Packit 022b05
          this table, it may be necessary for the application
Packit 022b05
          to be installed using some type of software
Packit 022b05
          installation mechanism or global registry so that its
Packit 022b05
          existence can be detected by the agent implementation."
Packit 022b05
Packit 022b05
      ::= { sysApplInstalled 1 }
Packit 022b05
Packit 022b05
  sysApplInstallPkgEntry OBJECT-TYPE
Packit 022b05
      SYNTAX      SysApplInstallPkgEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The logical row describing an installed application
Packit 022b05
          package."
Packit 022b05
      INDEX    { sysApplInstallPkgIndex }
Packit 022b05
      ::= { sysApplInstallPkgTable 1 }
Packit 022b05
Packit 022b05
  SysApplInstallPkgEntry ::= SEQUENCE {
Packit 022b05
      sysApplInstallPkgIndex               Unsigned32,
Packit 022b05
      sysApplInstallPkgManufacturer        Utf8String,
Packit 022b05
      sysApplInstallPkgProductName         Utf8String,
Packit 022b05
      sysApplInstallPkgVersion             Utf8String,
Packit 022b05
      sysApplInstallPkgSerialNumber        Utf8String,
Packit 022b05
      sysApplInstallPkgDate                DateAndTime,
Packit 022b05
      sysApplInstallPkgLocation            LongUtf8String
Packit 022b05
  }
Packit 022b05
Packit 022b05
  sysApplInstallPkgIndex OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (1..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "An integer used only for indexing purposes.
Packit 022b05
          Generally monotonically increasing from 1 as new
Packit 022b05
          applications are installed.
Packit 022b05
Packit 022b05
          The value for each installed application must
Packit 022b05
          remain constant at least from one re-initialization of
Packit 022b05
          the network management entity which implements this
Packit 022b05
          MIB module to the next re-initialization.
Packit 022b05
Packit 022b05
          The specific value is meaningful only within a given SNMP
Packit 022b05
          entity. A sysApplInstallPkgIndex value must not be re-used
Packit 022b05
          until the next agent entity restart in the event the
Packit 022b05
          installed application entry is deleted."
Packit 022b05
      ::= { sysApplInstallPkgEntry 1 }
Packit 022b05
Packit 022b05
  sysApplInstallPkgManufacturer OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The Manufacturer of the software application package."
Packit 022b05
      ::= { sysApplInstallPkgEntry 2 }
Packit 022b05
Packit 022b05
  sysApplInstallPkgProductName OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The name assigned to the software application package
Packit 022b05
          by the Manufacturer."
Packit 022b05
      ::= { sysApplInstallPkgEntry 3 }
Packit 022b05
Packit 022b05
  sysApplInstallPkgVersion OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The version number assigned to the application package
Packit 022b05
          by the manufacturer of the software."
Packit 022b05
      ::= { sysApplInstallPkgEntry 4 }
Packit 022b05
Packit 022b05
  sysApplInstallPkgSerialNumber OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The serial number of the software assigned by the
Packit 022b05
          manufacturer."
Packit 022b05
      ::= { sysApplInstallPkgEntry 5 }
Packit 022b05
Packit 022b05
  sysApplInstallPkgDate OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The date and time this software application was installed
Packit 022b05
          on the host."
Packit 022b05
      ::= { sysApplInstallPkgEntry 6 }
Packit 022b05
Packit 022b05
  sysApplInstallPkgLocation OBJECT-TYPE
Packit 022b05
      SYNTAX      LongUtf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The complete path name where the application package
Packit 022b05
          is installed.  For example, the value would be
Packit 022b05
          '/opt/MyapplDir' if the application package was installed
Packit 022b05
          in the /opt/MyapplDir directory."
Packit 022b05
      ::= { sysApplInstallPkgEntry 7 }
Packit 022b05
Packit 022b05
Packit 022b05
  -- sysApplInstallElmtTable
Packit 022b05
  -- The table describing the individual application package
Packit 022b05
  -- elements (files and executables) installed on the host computer.
Packit 022b05
Packit 022b05
  sysApplInstallElmtTable OBJECT-TYPE
Packit 022b05
      SYNTAX      SEQUENCE OF SysApplInstallElmtEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "This table details the individual application package
Packit 022b05
          elements (files and executables) which comprise the
Packit 022b05
          applications defined in the sysApplInstallPkg Table.
Packit 022b05
          Each entry in this table has an index to the
Packit 022b05
          sysApplInstallPkg table to identify the application
Packit 022b05
          package of which it is a part. As a result, there may
Packit 022b05
          be many entries in this table for each instance in the
Packit 022b05
          sysApplInstallPkg Table.
Packit 022b05
Packit 022b05
          Table entries are indexed by sysApplInstallPkgIndex,
Packit 022b05
          sysApplInstallElmtIndex to facilitate retrieval of
Packit 022b05
          all elements associated with a particular installed
Packit 022b05
          application package."
Packit 022b05
      ::= { sysApplInstalled 2 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtEntry OBJECT-TYPE
Packit 022b05
      SYNTAX      SysApplInstallElmtEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The logical row describing an element of an installed
Packit 022b05
          application.  The element may be an executable or
Packit 022b05
          non-executable file."
Packit 022b05
      INDEX    {sysApplInstallPkgIndex, sysApplInstallElmtIndex}
Packit 022b05
      ::= { sysApplInstallElmtTable 1 }
Packit 022b05
Packit 022b05
  SysApplInstallElmtEntry ::= SEQUENCE {
Packit 022b05
      sysApplInstallElmtIndex                 Unsigned32,
Packit 022b05
      sysApplInstallElmtName                  Utf8String,
Packit 022b05
      sysApplInstallElmtType                  INTEGER,
Packit 022b05
      sysApplInstallElmtDate                  DateAndTime,
Packit 022b05
      sysApplInstallElmtPath                  LongUtf8String,
Packit 022b05
      sysApplInstallElmtSizeHigh              Unsigned32,
Packit 022b05
      sysApplInstallElmtSizeLow               Unsigned32,
Packit 022b05
      sysApplInstallElmtRole                  BITS,
Packit 022b05
      sysApplInstallElmtModifyDate            DateAndTime,
Packit 022b05
      sysApplInstallElmtCurSizeHigh           Unsigned32,
Packit 022b05
      sysApplInstallElmtCurSizeLow            Unsigned32
Packit 022b05
Packit 022b05
  }
Packit 022b05
Packit 022b05
  sysApplInstallElmtIndex OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (1..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "An arbitrary integer used for indexing.  The value
Packit 022b05
          of this index is unique among all rows in this table
Packit 022b05
          that exist or have existed since the last agent restart."
Packit 022b05
      ::= { sysApplInstallElmtEntry 1 }
Packit 022b05
Packit 022b05
Packit 022b05
  sysApplInstallElmtName OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The name of this element which is contained in the
Packit 022b05
          application."
Packit 022b05
      ::= { sysApplInstallElmtEntry 2 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtType OBJECT-TYPE
Packit 022b05
      SYNTAX      INTEGER {
Packit 022b05
                  unknown(1),
Packit 022b05
                  nonexecutable(2),
Packit 022b05
                  operatingSystem(3),  -- executable
Packit 022b05
                  deviceDriver(4),     -- executable
Packit 022b05
                  application(5)       -- executable
Packit 022b05
                  }
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The type of element that is part of the installed
Packit 022b05
          application."
Packit 022b05
      ::= { sysApplInstallElmtEntry 3 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtDate OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The date and time that this component was installed on
Packit 022b05
          the system."
Packit 022b05
      ::= { sysApplInstallElmtEntry 4 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtPath OBJECT-TYPE
Packit 022b05
      SYNTAX      LongUtf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The full directory path where this element is installed.
Packit 022b05
          For example, the value would be '/opt/EMPuma/bin' for an
Packit 022b05
          element installed in the directory '/opt/EMPuma/bin'.
Packit 022b05
          Most application packages include information about the
Packit 022b05
          elements contained in the package. In addition, elements
Packit 022b05
          are typically installed in sub-directories under the
Packit 022b05
          package installation directory.  In cases where the
Packit 022b05
          element path names are not included in the package
Packit 022b05
          information itself, the path can usually be determined
Packit 022b05
          by a simple search of the sub-directories.  If the
Packit 022b05
          element is not installed in that location and there is
Packit 022b05
          no other information available to the agent implementation,
Packit 022b05
          then the path is unknown and null is returned."
Packit 022b05
      ::= { sysApplInstallElmtEntry 5}
Packit 022b05
Packit 022b05
  sysApplInstallElmtSizeHigh OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The installed file size in 2^32 byte blocks. This is
Packit 022b05
          the size of the file on disk immediately after installation.
Packit 022b05
Packit 022b05
          For example, for a file with a total size of 4,294,967,296
Packit 022b05
          bytes, this variable would have a value of 1; for a file
Packit 022b05
          with a total size of 4,294,967,295 bytes this variable
Packit 022b05
          would be 0."
Packit 022b05
      ::= { sysApplInstallElmtEntry 6 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtSizeLow OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The installed file size modulo 2^32 bytes.  This is
Packit 022b05
          the size of the file on disk immediately after installation.
Packit 022b05
Packit 022b05
          For example, for a file with a total size of 4,294,967,296
Packit 022b05
          bytes this variable would have a value of 0; for a file with
Packit 022b05
          a total size of 4,294,967,295 bytes this variable would be
Packit 022b05
          4,294,967,295."
Packit 022b05
      ::= { sysApplInstallElmtEntry 7 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtRole  OBJECT-TYPE
Packit 022b05
      SYNTAX      BITS {
Packit 022b05
                  executable(0),
Packit 022b05
                     -- An application may have one or
Packit 022b05
                     -- more executable elements.  The rest of the
Packit 022b05
                     -- bits have no meaning if the element is not
Packit 022b05
                     -- executable.
Packit 022b05
                  exclusive(1),
Packit 022b05
                     -- Only one copy of an exclusive element may be
Packit 022b05
                     -- running per invocation of the running
Packit 022b05
                     -- application.
Packit 022b05
                  primary(2),
Packit 022b05
                     -- The primary executable.  An application can
Packit 022b05
                     -- have one, and only one element that is designated
Packit 022b05
                     -- as the primary executable.  The execution of
Packit 022b05
                     -- this element constitutes an invocation of
Packit 022b05
                     -- the application.  This is used by the agent
Packit 022b05
                     -- implementation to determine the initiation of
Packit 022b05
                     -- an application.  The primary executable must
Packit 022b05
                     -- remain running long enough for the agent
Packit 022b05
                     -- implementation to detect its presence.
Packit 022b05
                  required(3),
Packit 022b05
                     -- An application may have zero or more required
Packit 022b05
                     -- elements. All required elements must be running
Packit 022b05
Packit 022b05
                     -- in order for the application to be judged to be
Packit 022b05
                     -- running and healthy.
Packit 022b05
                  dependent(4),
Packit 022b05
                     -- An application may have zero or more
Packit 022b05
                     -- dependent elements. Dependent elements may
Packit 022b05
                     -- not be running unless required elements are.
Packit 022b05
                  unknown(5)
Packit 022b05
                     -- Default value for the case when an operator
Packit 022b05
                     -- has not yet assigned one of the other values.
Packit 022b05
                     -- When set, bits 1, 2, 3, and 4 have no meaning.
Packit 022b05
                  }
Packit 022b05
      MAX-ACCESS  read-write
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "An operator assigned value used in the determination of
Packit 022b05
          application status. This value is used by the agent to
Packit 022b05
          determine both the mapping of started processes to the
Packit 022b05
          initiation of an application, as well as to allow for a
Packit 022b05
          determination of application health. The default value,
Packit 022b05
          unknown(5), is used when an operator has not yet assigned
Packit 022b05
          one of the other values.  If unknown(5) is set, bits
Packit 022b05
          1 - 4 have no meaning.  The possible values are:
Packit 022b05
Packit 022b05
                  executable(0),
Packit 022b05
                      An application may have one or
Packit 022b05
                      more executable elements.  The rest of the
Packit 022b05
                      bits have no meaning if the element is not
Packit 022b05
                      executable.
Packit 022b05
                  exclusive(1),
Packit 022b05
                      Only one copy of an exclusive element may be
Packit 022b05
                      running per invocation of the running
Packit 022b05
                      application.
Packit 022b05
                  primary(2),
Packit 022b05
                      The primary executable.  An application can
Packit 022b05
                      have one, and only one element that is designated
Packit 022b05
                      as the primary executable.  The execution of
Packit 022b05
                      this element constitutes an invocation of
Packit 022b05
                      the application.  This is used by the agent
Packit 022b05
                      implementation to determine the initiation of
Packit 022b05
                      an application.  The primary executable must
Packit 022b05
                      remain running long enough for the agent
Packit 022b05
                      implementation to detect its presence.
Packit 022b05
                  required(3),
Packit 022b05
                      An application may have zero or more required
Packit 022b05
                      elements. All required elements must be running
Packit 022b05
                      in order for the application to be judged to be
Packit 022b05
                      running and healthy.
Packit 022b05
                  dependent(4),
Packit 022b05
                      An application may have zero or more
Packit 022b05
                      dependent elements. Dependent elements may
Packit 022b05
                      not be running unless required elements are.
Packit 022b05
                  unknown(5)
Packit 022b05
                      Default value for the case when an operator
Packit 022b05
                      has not yet assigned one of the other values.
Packit 022b05
                      When set, bits 1, 2, 3, and 4 have no meaning.
Packit 022b05
Packit 022b05
           sysApplInstallElmtRole is used by the agent implementation
Packit 022b05
           in determining the initiation of an application, the
Packit 022b05
           current state of a running application (see
Packit 022b05
           sysApplRunCurrentState), when an application invocation is
Packit 022b05
           no longer running, and the exit status of a terminated
Packit 022b05
           application invocation (see sysApplPastRunExitState)."
Packit 022b05
Packit 022b05
      DEFVAL { { unknown } }
Packit 022b05
      ::= { sysApplInstallElmtEntry 8 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtModifyDate OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The date and time that this element was last modified.
Packit 022b05
          Modification of the sysApplInstallElmtRole columnar
Packit 022b05
          object does NOT constitute a modification of the element
Packit 022b05
          itself and should not affect the value of this object."
Packit 022b05
      ::= { sysApplInstallElmtEntry 9 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtCurSizeHigh OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The current file size in 2^32 byte blocks.
Packit 022b05
          For example, for a file with a total size of 4,294,967,296
Packit 022b05
          bytes, this variable would have a value of 1; for a file
Packit 022b05
          with a total size of 4,294,967,295 bytes this variable
Packit 022b05
          would be 0."
Packit 022b05
      ::= { sysApplInstallElmtEntry 10 }
Packit 022b05
Packit 022b05
  sysApplInstallElmtCurSizeLow OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The current file size modulo 2^32 bytes.
Packit 022b05
          For example, for a file with a total size of 4,294,967,296
Packit 022b05
          bytes this variable would have a value of 0; for a file with
Packit 022b05
          a total size of 4,294,967,295 bytes this variable would be
Packit 022b05
          4,294,967,295."
Packit 022b05
      ::= { sysApplInstallElmtEntry 11 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
  -- sysApplRun Group
Packit 022b05
  -- This group models activity information for applications
Packit 022b05
  -- that have been invoked and are either currently running,
Packit 022b05
  -- or have previously run on the host system.  Likewise,
Packit 022b05
  -- the individual elements of an invoked application are
Packit 022b05
  -- also modeled to show currently running processes, and
Packit 022b05
  -- processes that have run in the past.
Packit 022b05
Packit 022b05
  -- sysApplRunTable
Packit 022b05
  -- The sysApplRunTable contains the application instances
Packit 022b05
  -- which are currently running on the host.  Since a single
Packit 022b05
  -- application might be invoked multiple times, an entry is
Packit 022b05
  -- added to this table for each INVOCATION of an application.
Packit 022b05
  -- The table is indexed by sysApplInstallPkgIndex, sysApplRunIndex
Packit 022b05
  -- to enable managers to easily locate all invocations of
Packit 022b05
  -- a particular application package.
Packit 022b05
Packit 022b05
  sysApplRunTable OBJECT-TYPE
Packit 022b05
      SYNTAX      SEQUENCE OF SysApplRunEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The table describes the applications which are executing
Packit 022b05
          on the host.  Each time an application is invoked,
Packit 022b05
          an entry is created in this table. When an application ends,
Packit 022b05
          the entry is removed from this table and a corresponding
Packit 022b05
                  entry is created in the SysApplPastRunTable.
Packit 022b05
Packit 022b05
          A new entry is created in this table whenever the agent
Packit 022b05
          implementation detects a new running process that is an
Packit 022b05
          installed application element whose sysApplInstallElmtRole
Packit 022b05
          designates it as being the application's primary executable
Packit 022b05
          (sysApplInstallElmtRole = primary(2) ).
Packit 022b05
Packit 022b05
          The table is indexed by sysApplInstallPkgIndex,
Packit 022b05
          sysApplRunIndex to enable managers to easily locate all
Packit 022b05
          invocations of a particular application package."
Packit 022b05
      ::= { sysApplRun 1 }
Packit 022b05
Packit 022b05
  sysApplRunEntry OBJECT-TYPE
Packit 022b05
      SYNTAX      SysApplRunEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The logical row describing an application which is
Packit 022b05
          currently running on this host."
Packit 022b05
      INDEX    { sysApplInstallPkgIndex, sysApplRunIndex }
Packit 022b05
      ::= { sysApplRunTable   1 }
Packit 022b05
Packit 022b05
  SysApplRunEntry ::= SEQUENCE {
Packit 022b05
      sysApplRunIndex                         Unsigned32,
Packit 022b05
      sysApplRunStarted                       DateAndTime,
Packit 022b05
      sysApplRunCurrentState                  RunState
Packit 022b05
  }
Packit 022b05
Packit 022b05
  sysApplRunIndex OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (1..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "Part of the index for this table. An arbitrary
Packit 022b05
          integer used only for indexing purposes. Generally
Packit 022b05
          monotonically increasing from 1 as new applications are
Packit 022b05
          started on the host, it uniquely identifies application
Packit 022b05
          invocations.
Packit 022b05
Packit 022b05
          The numbering for this index increases by 1 for each
Packit 022b05
          INVOCATION of an application, regardless of which
Packit 022b05
          installed application package this entry represents a
Packit 022b05
          running instance of.
Packit 022b05
Packit 022b05
          An example of the indexing for a couple of entries is
Packit 022b05
          shown below.
Packit 022b05
Packit 022b05
                        :
Packit 022b05
                   sysApplRunStarted.17.14
Packit 022b05
                   sysApplRunStarted.17.63
Packit 022b05
                   sysApplRunStarted.18.13
Packit 022b05
                        :
Packit 022b05
Packit 022b05
          In this example, the agent has observed 12 application
Packit 022b05
          invocations when the application represented by entry 18
Packit 022b05
          in the sysApplInstallPkgTable is invoked.  The next
Packit 022b05
          invocation detected by the agent is an invocation of
Packit 022b05
          installed application package 17.  Some time later,
Packit 022b05
          installed application 17 is invoked a second time.
Packit 022b05
Packit 022b05
          NOTE: this index is not intended to reflect a real-time
Packit 022b05
          (wall clock time) ordering of application invocations;
Packit 022b05
          it is merely intended to uniquely identify running
Packit 022b05
          instances of applications.  Although the
Packit 022b05
          sysApplInstallPkgIndex is included in the INDEX clause
Packit 022b05
          for this table, it serves only to ease searching of
Packit 022b05
          this table by installed application and does not
Packit 022b05
          contribute to uniquely identifying table entries."
Packit 022b05
      ::= { sysApplRunEntry 1 }
Packit 022b05
Packit 022b05
  sysApplRunStarted OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The date and time that the application was started."
Packit 022b05
      ::= { sysApplRunEntry 2 }
Packit 022b05
Packit 022b05
  sysApplRunCurrentState OBJECT-TYPE
Packit 022b05
      SYNTAX      RunState
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The current state of the running application instance.
Packit 022b05
          The possible values are running(1), runnable(2) but waiting
Packit 022b05
          for a resource such as CPU, waiting(3) for an event,
Packit 022b05
          exiting(4), or other(5). This value is based on an evaluation
Packit 022b05
          of the running elements of this application instance (see
Packit 022b05
          sysApplElmRunState) and their Roles as defined by
Packit 022b05
          sysApplInstallElmtRole.  An agent implementation may
Packit 022b05
          detect that an application instance is in the process of
Packit 022b05
          exiting if one or more of its REQUIRED elements are no
Packit 022b05
          longer running.  Most agent implementations will wait until
Packit 022b05
          a second internal poll has been completed to give the
Packit 022b05
          system time to start REQUIRED elements before marking the
Packit 022b05
          application instance as exiting."
Packit 022b05
      ::= { sysApplRunEntry 3 }
Packit 022b05
Packit 022b05
Packit 022b05
  -- sysApplPastRunTable
Packit 022b05
  -- The sysApplPastRunTable provides a history of applications
Packit 022b05
  -- previously run on the host computer. Entries are removed from
Packit 022b05
  -- the sysApplRunTable and corresponding entries are added to this
Packit 022b05
  -- table when an application becomes inactive. Entries remain in
Packit 022b05
  -- this table until they are aged out when either the table size
Packit 022b05
  -- reaches a maximum as determined by the sysApplPastRunMaxRows,
Packit 022b05
  -- or when an entry has aged to exceed a time limit as set be
Packit 022b05
  -- sysApplPastRunTblTimeLimit.
Packit 022b05
  --
Packit 022b05
  -- When aging out entries, the oldest entry, as determined by
Packit 022b05
Packit 022b05
  -- the value of sysApplPastRunTimeEnded, will be removed first.
Packit 022b05
Packit 022b05
  sysApplPastRunTable OBJECT-TYPE
Packit 022b05
      SYNTAX      SEQUENCE OF SysApplPastRunEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "A history of the applications that have previously run
Packit 022b05
          on the host computer.  An entry's information is moved to
Packit 022b05
          this table from the sysApplRunTable when the invoked
Packit 022b05
          application represented by the entry ceases to be running.
Packit 022b05
Packit 022b05
          An agent implementation can determine that an application
Packit 022b05
          invocation is no longer running by evaluating the running
Packit 022b05
          elements of the application instance and their Roles as
Packit 022b05
          defined by sysApplInstallElmtRole.  Obviously, if there
Packit 022b05
          are no running elements for the application instance,
Packit 022b05
          then the application invocation is no longer running.
Packit 022b05
          If any one of the REQUIRED elements is not running,
Packit 022b05
          the application instance may be in the process of exiting.
Packit 022b05
          Most agent implementations will wait until a second internal
Packit 022b05
          poll has been completed to give the system time to either
Packit 022b05
          restart partial failures or to give all elements time to
Packit 022b05
          exit.  If, after the second poll, there are REQUIRED
Packit 022b05
          elements that are not running, then the application
Packit 022b05
          instance may be considered by the agent implementation
Packit 022b05
          to no longer be running.
Packit 022b05
Packit 022b05
          Entries remain in the sysApplPastRunTable until they
Packit 022b05
          are aged out when either the table size reaches a maximum
Packit 022b05
          as determined by the sysApplPastRunMaxRows, or when an entry
Packit 022b05
          has aged to exceed a time limit as set by
Packit 022b05
          sysApplPastRunTblTimeLimit.
Packit 022b05
Packit 022b05
          Entries in this table are indexed by sysApplInstallPkgIndex,
Packit 022b05
          sysApplPastRunIndex to facilitate retrieval of all past
Packit 022b05
          run invocations of a particular installed application."
Packit 022b05
      ::= { sysApplRun 2 }
Packit 022b05
Packit 022b05
  sysApplPastRunEntry OBJECT-TYPE
Packit 022b05
      SYNTAX      SysApplPastRunEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The logical row describing an invocation of an application
Packit 022b05
          which was previously run and has terminated.  The entry
Packit 022b05
          is basically copied from the sysApplRunTable when the
Packit 022b05
          application instance terminates.  Hence, the entry's
Packit 022b05
          value for sysApplPastRunIndex is the same as its value was
Packit 022b05
          for sysApplRunIndex."
Packit 022b05
      INDEX    { sysApplInstallPkgIndex, sysApplPastRunIndex }
Packit 022b05
      ::= { sysApplPastRunTable   1 }
Packit 022b05
Packit 022b05
  SysApplPastRunEntry ::= SEQUENCE {
Packit 022b05
      sysApplPastRunIndex                     Unsigned32,
Packit 022b05
      sysApplPastRunStarted                   DateAndTime,
Packit 022b05
      sysApplPastRunExitState                 INTEGER,
Packit 022b05
      sysApplPastRunTimeEnded                 DateAndTime
Packit 022b05
  }
Packit 022b05
Packit 022b05
  sysApplPastRunIndex OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (1..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "Part of the index for this table. An integer
Packit 022b05
          matching the value of the removed sysApplRunIndex
Packit 022b05
          corresponding to this row."
Packit 022b05
      ::= { sysApplPastRunEntry 1 }
Packit 022b05
Packit 022b05
  sysApplPastRunStarted OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The date and time that the application was started."
Packit 022b05
      ::= { sysApplPastRunEntry 2 }
Packit 022b05
Packit 022b05
  sysApplPastRunExitState OBJECT-TYPE
Packit 022b05
      SYNTAX      INTEGER {
Packit 022b05
                  complete (1), -- normal exit at sysApplRunTimeEnded
Packit 022b05
                  failed (2),   -- abnormal exit
Packit 022b05
                  other (3)
Packit 022b05
                  }
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
        "The state of the application instance when it terminated.
Packit 022b05
         This value is based on an evaluation of the running elements
Packit 022b05
         of an application and their Roles as defined by
Packit 022b05
         sysApplInstallElmtRole.  An application instance is said to
Packit 022b05
         have exited in a COMPLETE state and its entry is removed
Packit 022b05
         from the sysApplRunTable and added to the sysApplPastRunTable
Packit 022b05
         when the agent detects that ALL elements of an application
Packit 022b05
         invocation are no longer running.  Most agent implementations
Packit 022b05
         will wait until a second internal poll has been completed to
Packit 022b05
         give the system time to either restart partial failures or
Packit 022b05
         to give all elements time to exit.  A failed state occurs if,
Packit 022b05
         after the second poll, any elements continue to run but
Packit 022b05
         one or more of the REQUIRED elements are no longer running.
Packit 022b05
         All other combinations MUST be defined as OTHER."
Packit 022b05
      ::= { sysApplPastRunEntry 3 }
Packit 022b05
Packit 022b05
  sysApplPastRunTimeEnded OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The DateAndTime the application instance was determined
Packit 022b05
          to be no longer running."
Packit 022b05
      ::= { sysApplPastRunEntry 4 }
Packit 022b05
Packit 022b05
  -- sysApplElmtRunTable
Packit 022b05
  -- The sysApplElmtRunTable contains an entry for each process that
Packit 022b05
  -- is currently running on the host.  An entry is created in
Packit 022b05
  -- this table for each process at the time it is started, and will
Packit 022b05
  -- remain in the table until the process terminates.
Packit 022b05
  --
Packit 022b05
  -- The table is indexed by sysApplElmtRunInstallPkg,
Packit 022b05
  -- sysApplElmtRunInvocID, and sysApplElmtRunIndex to make it easy
Packit 022b05
  -- to locate all running elements of a particular invoked application
Packit 022b05
  -- which has been installed on the system.
Packit 022b05
Packit 022b05
Packit 022b05
  sysApplElmtRunTable OBJECT-TYPE
Packit 022b05
      SYNTAX      SEQUENCE OF SysApplElmtRunEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The table describes the processes which are
Packit 022b05
          currently executing on the host system. Each entry
Packit 022b05
          represents a running process and is associated with
Packit 022b05
          the invoked application of which that process is a part, if
Packit 022b05
          possible.  This table contains an entry for every process
Packit 022b05
          currently running on the system, regardless of whether its
Packit 022b05
          'parent' application can be determined.  So, for example,
Packit 022b05
          processes like 'ps' and 'grep' will have entries though they
Packit 022b05
          are not associated with an installed application package.
Packit 022b05
Packit 022b05
          Because a running application may involve
Packit 022b05
          more than one executable, it is possible to have
Packit 022b05
          multiple entries in this table for each application.
Packit 022b05
          Entries are removed from this table when the process
Packit 022b05
          terminates.
Packit 022b05
          The table is indexed by sysApplElmtRunInstallPkg,
Packit 022b05
          sysApplElmtRunInvocID, and sysApplElmtRunIndex to
Packit 022b05
          facilitate the retrieval of all running elements of a
Packit 022b05
          particular invoked application which has been installed on
Packit 022b05
          the system."
Packit 022b05
      ::= { sysApplRun 3 }
Packit 022b05
Packit 022b05
  sysApplElmtRunEntry OBJECT-TYPE
Packit 022b05
      SYNTAX      SysApplElmtRunEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The logical row describing a process currently
Packit 022b05
          running on this host.  When possible, the entry is
Packit 022b05
          associated with the invoked application of which it
Packit 022b05
          is a part."
Packit 022b05
      INDEX    { sysApplElmtRunInstallPkg, sysApplElmtRunInvocID,
Packit 022b05
                 sysApplElmtRunIndex }
Packit 022b05
      ::= { sysApplElmtRunTable   1 }
Packit 022b05
Packit 022b05
  SysApplElmtRunEntry ::= SEQUENCE {
Packit 022b05
      sysApplElmtRunInstallPkg        Unsigned32,
Packit 022b05
      sysApplElmtRunInvocID           Unsigned32,
Packit 022b05
      sysApplElmtRunIndex             Unsigned32,
Packit 022b05
      sysApplElmtRunInstallID         Unsigned32,
Packit 022b05
      sysApplElmtRunTimeStarted       DateAndTime,
Packit 022b05
      sysApplElmtRunState             RunState,
Packit 022b05
      sysApplElmtRunName              LongUtf8String,
Packit 022b05
      sysApplElmtRunParameters        Utf8String,
Packit 022b05
      sysApplElmtRunCPU               TimeTicks,
Packit 022b05
      sysApplElmtRunMemory            Gauge32,
Packit 022b05
      sysApplElmtRunNumFiles          Gauge32,
Packit 022b05
      sysApplElmtRunUser              Utf8String
Packit 022b05
  }
Packit 022b05
Packit 022b05
  sysApplElmtRunInstallPkg OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "Part of the index for this table, this value
Packit 022b05
          identifies the installed software package for
Packit 022b05
          the application of which this process is a part.
Packit 022b05
          Provided that the process's 'parent' application can be
Packit 022b05
          determined, the value of this object is the same
Packit 022b05
          value as the sysApplInstallPkgIndex for the
Packit 022b05
          entry in the sysApplInstallPkgTable that corresponds
Packit 022b05
          to the installed application of which this process
Packit 022b05
          is a part.
Packit 022b05
Packit 022b05
          If, however, the 'parent' application cannot be
Packit 022b05
          determined, (for example the process is not part
Packit 022b05
          of a particular installed application), the value
Packit 022b05
          for this object is then '0', signifying that this
Packit 022b05
          process cannot be related back to an application,
Packit 022b05
          and in turn, an installed software package."
Packit 022b05
      ::= { sysApplElmtRunEntry 1 }
Packit 022b05
Packit 022b05
  sysApplElmtRunInvocID OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "Part of the index for this table, this value
Packit 022b05
          identifies the invocation of an application of which
Packit 022b05
          this process is a part.  Provided that the 'parent'
Packit 022b05
          application can be determined, the value of this object
Packit 022b05
          is the same value as the sysApplRunIndex for the
Packit 022b05
          corresponding application invocation in the
Packit 022b05
          sysApplRunTable.
Packit 022b05
Packit 022b05
          If, however, the 'parent' application cannot be
Packit 022b05
          determined, the value for this object is then '0',
Packit 022b05
          signifying that this process cannot be related back
Packit 022b05
          to an invocation of an application in the
Packit 022b05
          sysApplRunTable."
Packit 022b05
      ::= { sysApplElmtRunEntry 2 }
Packit 022b05
Packit 022b05
  sysApplElmtRunIndex OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "Part of the index for this table.  A unique value
Packit 022b05
          for each process running on the host.  Wherever
Packit 022b05
          possible, this should be the system's native, unique
Packit 022b05
          identification number."
Packit 022b05
      ::= { sysApplElmtRunEntry 3 }
Packit 022b05
Packit 022b05
Packit 022b05
  sysApplElmtRunInstallID OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The index into the sysApplInstallElmtTable. The
Packit 022b05
          value of this object is the same value as the
Packit 022b05
          sysApplInstallElmtIndex for the application element
Packit 022b05
          of which this entry represents a running instance.
Packit 022b05
          If this process cannot be associated with an installed
Packit 022b05
          executable, the value should be '0'."
Packit 022b05
      ::= { sysApplElmtRunEntry 4 }
Packit 022b05
Packit 022b05
  sysApplElmtRunTimeStarted OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The time the process was started."
Packit 022b05
      ::= { sysApplElmtRunEntry 5 }
Packit 022b05
Packit 022b05
  sysApplElmtRunState OBJECT-TYPE
Packit 022b05
      SYNTAX      RunState
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The current state of the running process. The
Packit 022b05
          possible values are running(1), runnable(2) but waiting
Packit 022b05
          for a resource such as CPU, waiting(3) for an event,
Packit 022b05
          exiting(4), or other(5)."
Packit 022b05
      ::= { sysApplElmtRunEntry 6 }
Packit 022b05
Packit 022b05
  sysApplElmtRunName OBJECT-TYPE
Packit 022b05
      SYNTAX      LongUtf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The full path and filename of the process.
Packit 022b05
          For example, '/opt/MYYpkg/bin/myyproc' would
Packit 022b05
          be returned for process 'myyproc' whose execution
Packit 022b05
          path is '/opt/MYYpkg/bin/myyproc'."
Packit 022b05
      ::= { sysApplElmtRunEntry 7 }
Packit 022b05
Packit 022b05
  sysApplElmtRunParameters OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The starting parameters for the process."
Packit 022b05
  ::= { sysApplElmtRunEntry 8 }
Packit 022b05
Packit 022b05
  sysApplElmtRunCPU OBJECT-TYPE
Packit 022b05
      SYNTAX      TimeTicks
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
           "The number of centi-seconds of the total system's
Packit 022b05
           CPU resources consumed by this process.  Note that
Packit 022b05
           on a multi-processor system, this value may
Packit 022b05
           have been incremented by more than one centi-second
Packit 022b05
           in one centi-second of real (wall clock) time."
Packit 022b05
      ::= { sysApplElmtRunEntry 9 }
Packit 022b05
Packit 022b05
  sysApplElmtRunMemory OBJECT-TYPE
Packit 022b05
      SYNTAX      Gauge32
Packit 022b05
      UNITS       "Kbytes"
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The total amount of real system memory measured in
Packit 022b05
          Kbytes currently allocated to this process."
Packit 022b05
Packit 022b05
      ::= { sysApplElmtRunEntry 10 }
Packit 022b05
Packit 022b05
  sysApplElmtRunNumFiles OBJECT-TYPE
Packit 022b05
      SYNTAX      Gauge32
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The number of regular files currently open by the
Packit 022b05
          process.  Transport connections (sockets)
Packit 022b05
          should NOT be included in the calculation of
Packit 022b05
          this value, nor should operating system specific
Packit 022b05
          special file types."
Packit 022b05
      ::= { sysApplElmtRunEntry 11 }
Packit 022b05
Packit 022b05
  sysApplElmtRunUser OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The process owner's login name (e.g. root)."
Packit 022b05
      ::= { sysApplElmtRunEntry 12 }
Packit 022b05
Packit 022b05
  -- sysApplElmtPastRunTable
Packit 022b05
  -- The sysApplElmtPastRunTable maintains a history of
Packit 022b05
  -- processes which have previously executed on
Packit 022b05
  -- the host as part of an application. Upon termination
Packit 022b05
  -- of a process, the entry representing the process is removed from
Packit 022b05
  -- the sysApplElmtRunTable and a corresponding entry is created in
Packit 022b05
  -- this table provided that the process was part of an
Packit 022b05
  -- identifiable application.  If the process could not be associated
Packit 022b05
Packit 022b05
  -- with an invoked application, no corresponding entry is created.
Packit 022b05
  -- Hence, whereas the sysApplElmtRunTable contains an entry for
Packit 022b05
  -- every process currently executing on the system, the
Packit 022b05
  -- sysApplElmtPastRunTable only contains entries for processes
Packit 022b05
  -- that previously executed as part of an invoked application.
Packit 022b05
  --
Packit 022b05
  -- Entries remain in this table until they are aged out when
Packit 022b05
  -- either the number of entries in the table reaches a
Packit 022b05
  -- maximum as determined by sysApplElmtPastRunMaxRows, or
Packit 022b05
  -- when an entry has aged to exceed a time limit as set by
Packit 022b05
  -- sysApplElmtPastRunTblTimeLimit.  When aging out entries,
Packit 022b05
  -- the oldest entry, as determined by the value of
Packit 022b05
  -- sysApplElmtPastRunTimeEnded, will be removed first.
Packit 022b05
  --
Packit 022b05
  -- The table is indexed by sysApplInstallPkgIndex (from the
Packit 022b05
  -- sysApplInstallPkgTable), sysApplElmtPastRunInvocID, and
Packit 022b05
  -- sysApplElmtPastRunIndex to make it easy to locate all
Packit 022b05
  -- previously executed processes of a particular invoked application
Packit 022b05
  -- that has been installed on the system.
Packit 022b05
Packit 022b05
Packit 022b05
  sysApplElmtPastRunTable OBJECT-TYPE
Packit 022b05
      SYNTAX      SEQUENCE OF SysApplElmtPastRunEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The table describes the processes which have previously
Packit 022b05
          executed on the host system as part of an application.
Packit 022b05
          Each entry represents a process which has previously
Packit 022b05
          executed and is associated with the invoked application
Packit 022b05
          of which it was a part.  Because an invoked application
Packit 022b05
          may involve more than one executable, it is possible
Packit 022b05
          to have multiple entries in this table for
Packit 022b05
          each application invocation. Entries are added
Packit 022b05
          to this table when the corresponding process in the
Packit 022b05
          sysApplElmtRun Table terminates.
Packit 022b05
Packit 022b05
          Entries remain in this table until they are aged out when
Packit 022b05
          either the number of entries in the table reaches a
Packit 022b05
          maximum as determined by sysApplElmtPastRunMaxRows, or
Packit 022b05
          when an entry has aged to exceed a time limit as set by
Packit 022b05
          sysApplElmtPastRunTblTimeLimit.  When aging out entries,
Packit 022b05
          the oldest entry, as determined by the value of
Packit 022b05
          sysApplElmtPastRunTimeEnded, will be removed first.
Packit 022b05
Packit 022b05
          The table is indexed by sysApplInstallPkgIndex (from the
Packit 022b05
          sysApplInstallPkgTable), sysApplElmtPastRunInvocID,
Packit 022b05
          and sysApplElmtPastRunIndex to make it easy to locate all
Packit 022b05
          previously executed processes of a particular invoked
Packit 022b05
          application that has been installed on the system."
Packit 022b05
      ::= { sysApplRun 4 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunEntry OBJECT-TYPE
Packit 022b05
      SYNTAX      SysApplElmtPastRunEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The logical row describing a process which was
Packit 022b05
          previously executed on this host as part of an
Packit 022b05
          installed application.  The entry is basically copied
Packit 022b05
          from the sysApplElmtRunTable when the process
Packit 022b05
          terminates.  Hence, the entry's value for
Packit 022b05
          sysApplElmtPastRunIndex is the same as its value
Packit 022b05
          was for sysApplElmtRunIndex.  Note carefully: only those
Packit 022b05
          processes which could be associated with an
Packit 022b05
          identified application are included in this table."
Packit 022b05
      INDEX    { sysApplInstallPkgIndex, sysApplElmtPastRunInvocID,
Packit 022b05
                 sysApplElmtPastRunIndex }
Packit 022b05
      ::= { sysApplElmtPastRunTable   1 }
Packit 022b05
Packit 022b05
  SysApplElmtPastRunEntry ::= SEQUENCE {
Packit 022b05
      sysApplElmtPastRunInvocID           Unsigned32,
Packit 022b05
      sysApplElmtPastRunIndex             Unsigned32,
Packit 022b05
      sysApplElmtPastRunInstallID         Unsigned32,
Packit 022b05
      sysApplElmtPastRunTimeStarted       DateAndTime,
Packit 022b05
      sysApplElmtPastRunTimeEnded         DateAndTime,
Packit 022b05
      sysApplElmtPastRunName              LongUtf8String,
Packit 022b05
      sysApplElmtPastRunParameters        Utf8String,
Packit 022b05
      sysApplElmtPastRunCPU               TimeTicks,
Packit 022b05
      sysApplElmtPastRunMemory            Unsigned32,
Packit 022b05
      sysApplElmtPastRunNumFiles          Unsigned32,
Packit 022b05
      sysApplElmtPastRunUser              Utf8String
Packit 022b05
  }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunInvocID OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (1..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "Part of the index for this table, this value
Packit 022b05
          identifies the invocation of an application of which
Packit 022b05
          the process represented by this entry was a part.
Packit 022b05
          The value of this object is the same value as the
Packit 022b05
          sysApplRunIndex for the corresponding application
Packit 022b05
          invocation in the sysApplRunTable.  If the invoked
Packit 022b05
          application as a whole has terminated, it will be the
Packit 022b05
          same as the sysApplPastRunIndex."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 1 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunIndex OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "Part of the index for this table. An integer
Packit 022b05
          assigned by the agent equal to the corresponding
Packit 022b05
          sysApplElmtRunIndex which was removed from the
Packit 022b05
          sysApplElmtRunTable and moved to this table
Packit 022b05
          when the element terminated.
Packit 022b05
Packit 022b05
          Note: entries in this table are indexed by
Packit 022b05
          sysApplElmtPastRunInvocID, sysApplElmtPastRunIndex.
Packit 022b05
          The possibility exists, though unlikely, of a
Packit 022b05
          collision occurring by a new entry which was run
Packit 022b05
          by the same invoked application (InvocID), and
Packit 022b05
          was assigned the same process identification number
Packit 022b05
          (ElmtRunIndex) as an element which was previously
Packit 022b05
          run by the same invoked application.
Packit 022b05
Packit 022b05
          Should this situation occur, the new entry replaces
Packit 022b05
          the old entry.
Packit 022b05
Packit 022b05
          See Section: 'Implementation Issues -
Packit 022b05
          sysApplElmtPastRunTable Entry Collisions' for the
Packit 022b05
          conditions that would have to occur in order for a
Packit 022b05
          collision to occur."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 2 }
Packit 022b05
Packit 022b05
Packit 022b05
  sysApplElmtPastRunInstallID OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (1..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The index into the installed element table. The
Packit 022b05
          value of this object is the same value as the
Packit 022b05
          sysApplInstallElmtIndex for the application element
Packit 022b05
          of which this entry represents a previously executed
Packit 022b05
          process."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 3 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunTimeStarted OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The time the process was started."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 4 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunTimeEnded OBJECT-TYPE
Packit 022b05
      SYNTAX      DateAndTime
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The time the process ended."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 5 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunName OBJECT-TYPE
Packit 022b05
      SYNTAX      LongUtf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The full path and filename of the process.
Packit 022b05
          For example, '/opt/MYYpkg/bin/myyproc' would
Packit 022b05
          be returned for process 'myyproc' whose execution
Packit 022b05
          path was '/opt/MYYpkg/bin/myyproc'."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 6 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunParameters OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The starting parameters for the process."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 7 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunCPU OBJECT-TYPE
Packit 022b05
      SYNTAX      TimeTicks
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
           "The last known number of centi-seconds of the total
Packit 022b05
           system's CPU resources consumed by this process.
Packit 022b05
           Note that on a multi-processor system, this value may
Packit 022b05
           increment by more than one centi-second in one
Packit 022b05
           centi-second of real (wall clock) time."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 8 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunMemory OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      UNITS       "Kbytes"
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The last known total amount of real system memory
Packit 022b05
          measured in Kbytes allocated to this process before it
Packit 022b05
          terminated."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 9 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunNumFiles OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The last known number of files open by the
Packit 022b05
          process before it terminated.  Transport
Packit 022b05
          connections (sockets) should NOT be included in
Packit 022b05
          the calculation of this value."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 10 }
Packit 022b05
Packit 022b05
  sysApplElmtPastRunUser OBJECT-TYPE
Packit 022b05
      SYNTAX      Utf8String
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The process owner's login name (e.g. root)."
Packit 022b05
      ::= { sysApplElmtPastRunEntry 11 }
Packit 022b05
Packit 022b05
Packit 022b05
  -- Additional Scalar objects to control table sizes
Packit 022b05
Packit 022b05
  sysApplPastRunMaxRows OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  read-write
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The maximum number of entries allowed in the
Packit 022b05
          sysApplPastRunTable.  Once the number of rows in
Packit 022b05
          the sysApplPastRunTable reaches this value, the
Packit 022b05
          management subsystem will remove the oldest entry
Packit 022b05
          in the table to make room for the new entry to be added.
Packit 022b05
          Entries will be removed on the basis of oldest
Packit 022b05
          sysApplPastRunTimeEnded value first.
Packit 022b05
Packit 022b05
          This object may be used to control the amount of
Packit 022b05
          system resources that can used for sysApplPastRunTable
Packit 022b05
          entries. A conforming implementation should attempt
Packit 022b05
          to support the default value, however, a lesser value
Packit 022b05
          may be necessary due to implementation-dependent issues
Packit 022b05
          and resource availability."
Packit 022b05
      DEFVAL      { 500 }
Packit 022b05
      ::= { sysApplRun 5 }
Packit 022b05
Packit 022b05
  sysApplPastRunTableRemItems OBJECT-TYPE
Packit 022b05
      SYNTAX      Counter32
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "A counter of the number of entries removed from
Packit 022b05
          the sysApplPastRunTable because of table size limitations
Packit 022b05
          as set in sysApplPastRunMaxRows.  This counter is the
Packit 022b05
          number of entries the management subsystem has had to
Packit 022b05
          remove in order to make room for new entries (so as not
Packit 022b05
          to exceed the limit set by sysApplPastRunMaxRows) since
Packit 022b05
          the last initialization of the management subsystem."
Packit 022b05
      ::= { sysApplRun 6 }
Packit 022b05
Packit 022b05
  sysApplPastRunTblTimeLimit OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      UNITS       "seconds"
Packit 022b05
      MAX-ACCESS  read-write
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The maximum time in seconds which an entry in the
Packit 022b05
           sysApplPastRunTable may exist before it is removed.
Packit 022b05
           Any entry that is older than this value will be
Packit 022b05
           removed (aged out) from the table.
Packit 022b05
Packit 022b05
           Note that an entry may be aged out prior to reaching
Packit 022b05
           this time limit if it is the oldest entry in the
Packit 022b05
           table and must be removed to make space for a new
Packit 022b05
           entry so as to not exceed sysApplPastRunMaxRows."
Packit 022b05
      DEFVAL      { 7200 }
Packit 022b05
      ::= { sysApplRun 7 }
Packit 022b05
Packit 022b05
  sysApplElemPastRunMaxRows OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  read-write
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The maximum number of entries allowed in the
Packit 022b05
          sysApplElmtPastRunTable.  Once the number of rows in
Packit 022b05
          the sysApplElmtPastRunTable reaches this value,
Packit 022b05
          the management subsystem will remove the oldest entry
Packit 022b05
          to make room for the new entry to be added.  Entries
Packit 022b05
          will be removed on the basis of oldest
Packit 022b05
          sysApplElmtPastRunTimeEnded value first.
Packit 022b05
          This object may be used to control the amount of
Packit 022b05
          system resources that can used for sysApplElemPastRunTable
Packit 022b05
          entries. A conforming implementation should attempt
Packit 022b05
          to support the default value, however, a lesser value
Packit 022b05
          may be necessary due to implementation-dependent issues
Packit 022b05
          and resource availability."
Packit 022b05
      DEFVAL      { 500 }
Packit 022b05
      ::= { sysApplRun 8 }
Packit 022b05
Packit 022b05
  sysApplElemPastRunTableRemItems OBJECT-TYPE
Packit 022b05
      SYNTAX      Counter32
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "A counter of the number of entries removed from the
Packit 022b05
          sysApplElemPastRunTable because of table size limitations
Packit 022b05
          as set in sysApplElemPastRunMaxRows.  This counter is the
Packit 022b05
          number of entries the management subsystem has had to
Packit 022b05
          remove in order to make room for new entries (so as not
Packit 022b05
          to exceed the limit set by sysApplElemPastRunMaxRows) since
Packit 022b05
          the last initialization of the management subsystem."
Packit 022b05
      ::= { sysApplRun 9 }
Packit 022b05
Packit 022b05
  sysApplElemPastRunTblTimeLimit OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      UNITS       "seconds"
Packit 022b05
      MAX-ACCESS  read-write
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The maximum time in seconds which an entry in the
Packit 022b05
           sysApplElemPastRunTable may exist before it is removed.
Packit 022b05
           Any entry that is older than this value will be
Packit 022b05
           removed (aged out) from the table.
Packit 022b05
Packit 022b05
           Note that an entry may be aged out prior to reaching
Packit 022b05
           this time limit if it is the oldest entry in the
Packit 022b05
           table and must be removed to make space for a new
Packit 022b05
           entry so as to not exceed sysApplElemPastRunMaxRows."
Packit 022b05
      DEFVAL      { 7200 }
Packit 022b05
      ::= { sysApplRun 10 }
Packit 022b05
Packit 022b05
  sysApplAgentPollInterval  OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      UNITS       "seconds"
Packit 022b05
      MAX-ACCESS  read-write
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The minimum interval in seconds that the management
Packit 022b05
          subsystem implementing this MIB will poll the status
Packit 022b05
          of the managed resources. Because of the non-trivial
Packit 022b05
          effort involved in polling the managed resources,
Packit 022b05
          and because the method for obtaining the status of
Packit 022b05
          the managed resources is implementation-dependent,
Packit 022b05
          a conformant implementation may chose a lower bound
Packit 022b05
          greater than 0.
Packit 022b05
Packit 022b05
          A value of 0 indicates that there is no delay
Packit 022b05
          in the passing of information from the managed
Packit 022b05
          resources to the agent."
Packit 022b05
      DEFVAL      { 60 }
Packit 022b05
      ::= { sysApplRun 11 }
Packit 022b05
Packit 022b05
Packit 022b05
  -- sysApplMap Group
Packit 022b05
  -- This group contains a table, the sysApplMapTable,
Packit 022b05
  -- whose sole purpose is to provide a 'backwards'
Packit 022b05
  -- mapping so that, given a known sysApplElmtRunIndex
Packit 022b05
  -- (process identification number), the corresponding invoked
Packit 022b05
  -- application (sysApplRunIndex), installed element
Packit 022b05
  -- (sysApplInstallElmtIndex), and installed application
Packit 022b05
  -- package (sysApplInstallPkgIndex) can be quickly determined.
Packit 022b05
  --
Packit 022b05
  -- The table will contain one entry for each process
Packit 022b05
  -- currently running on the system.
Packit 022b05
  --
Packit 022b05
  -- A backwards mapping is extremely useful since the tables
Packit 022b05
  -- in this MIB module are typically indexed with the
Packit 022b05
  -- installed application package (sysApplInstallPkgIndex)
Packit 022b05
  -- as the primary key, and on down as required by the
Packit 022b05
  -- specific table, with the process ID number (sysApplElmtRunIndex)
Packit 022b05
  -- being the least significant key.
Packit 022b05
  --
Packit 022b05
  -- It is expected that management applications will use
Packit 022b05
  -- this mapping table by doing a 'GetNext' operation with
Packit 022b05
  -- the known process ID number (sysApplElmtRunIndex) as the partial
Packit 022b05
  -- instance identifier.  Assuming that there is an entry for
Packit 022b05
  -- the process, the result should return a single columnar value,
Packit 022b05
  -- the sysApplMapInstallPkgIndex, with the sysApplElmtRunIndex,
Packit 022b05
  -- sysApplRunIndex, and sysApplInstallElmtIndex contained in the
Packit 022b05
  -- instance identifier for the returned MIB object value.
Packit 022b05
  --
Packit 022b05
  -- NOTE: if the process can not be associated back to an
Packit 022b05
  -- invoked application installed on the system, then the
Packit 022b05
  -- value returned for the columnar value sysApplMapInstallPkgIndex
Packit 022b05
  -- will be '0' and the instance portion of the object-identifier
Packit 022b05
  -- will be the process ID number (sysApplElmtRunIndex) followed
Packit 022b05
Packit 022b05
  -- by 0.0.
Packit 022b05
Packit 022b05
  sysApplMapTable OBJECT-TYPE
Packit 022b05
      SYNTAX      SEQUENCE OF SysApplMapEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The sole purpose of this table is to provide a
Packit 022b05
          'backwards' mapping so that, given a known
Packit 022b05
          sysApplElmtRunIndex (process identification number),
Packit 022b05
          the corresponding invoked application (sysApplRunIndex),
Packit 022b05
          installed element (sysApplInstallElmtIndex), and
Packit 022b05
          installed application package (sysApplInstallPkgIndex)
Packit 022b05
          can be quickly determined.
Packit 022b05
Packit 022b05
          This table will contain one entry for each process
Packit 022b05
          that is currently executing on the system.
Packit 022b05
Packit 022b05
          It is expected that management applications will use
Packit 022b05
          this mapping table by doing a 'GetNext' operation with
Packit 022b05
          the known process ID number (sysApplElmtRunIndex) as the
Packit 022b05
          partial instance identifier.  Assuming that there is an
Packit 022b05
          entry for the process, the result should return a single
Packit 022b05
          columnar value, the sysApplMapInstallPkgIndex, with the
Packit 022b05
          sysApplElmtRunIndex, sysApplRunIndex, and
Packit 022b05
          sysApplInstallElmtIndex contained in the instance identifier
Packit 022b05
          for the returned MIB object value.
Packit 022b05
Packit 022b05
          NOTE: if the process can not be associated back to an
Packit 022b05
          invoked application installed on the system, then the
Packit 022b05
          value returned for the columnar value
Packit 022b05
          sysApplMapInstallPkgIndex will be '0' and the instance
Packit 022b05
          portion of the object-identifier will be the process ID
Packit 022b05
          number (sysApplElmtRunIndex) followed by 0.0."
Packit 022b05
      ::= { sysApplMap 1 }
Packit 022b05
Packit 022b05
  sysApplMapEntry OBJECT-TYPE
Packit 022b05
      SYNTAX      SysApplMapEntry
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "A logical row representing a process currently running
Packit 022b05
           on the system.  This entry provides the index mapping from
Packit 022b05
           process identifier, back to the invoked application,
Packit 022b05
           installed element, and finally, the installed application
Packit 022b05
           package.  The entry includes only one accessible columnar
Packit 022b05
           object, the sysApplMapInstallPkgIndex, but the
Packit 022b05
           invoked application and installed element can be
Packit 022b05
           determined from the instance identifier since they form
Packit 022b05
           part of the index clause."
Packit 022b05
      INDEX  { sysApplElmtRunIndex, sysApplElmtRunInvocID,
Packit 022b05
               sysApplMapInstallElmtIndex }
Packit 022b05
      ::= { sysApplMapTable 1 }
Packit 022b05
Packit 022b05
  SysApplMapEntry ::= SEQUENCE {
Packit 022b05
      sysApplMapInstallElmtIndex    Unsigned32,
Packit 022b05
      sysApplMapInstallPkgIndex     Unsigned32
Packit 022b05
  }
Packit 022b05
Packit 022b05
  sysApplMapInstallElmtIndex OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  not-accessible
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The index into the sysApplInstallElmtTable. The
Packit 022b05
          value of this object is the same value as the
Packit 022b05
          sysApplInstallElmtIndex for the application element
Packit 022b05
          of which this entry represents a running instance.
Packit 022b05
          If this process cannot be associated to an installed
Packit 022b05
          executable, the value should be '0'."
Packit 022b05
      ::= { sysApplMapEntry 1 }
Packit 022b05
Packit 022b05
  sysApplMapInstallPkgIndex OBJECT-TYPE
Packit 022b05
      SYNTAX      Unsigned32 (0..'ffffffff'h)
Packit 022b05
      MAX-ACCESS  read-only
Packit 022b05
      STATUS      current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The value of this object identifies the installed
Packit 022b05
          software package for the application of which this
Packit 022b05
          process is a part.  Provided that the process's 'parent'
Packit 022b05
          application can be determined, the value of this object
Packit 022b05
          is the same value as the sysApplInstallPkgIndex for the
Packit 022b05
          entry in the sysApplInstallPkgTable that corresponds
Packit 022b05
          to the installed application of which this process
Packit 022b05
          is a part.
Packit 022b05
Packit 022b05
          If, however, the 'parent' application cannot be
Packit 022b05
          determined, (for example the process is not part
Packit 022b05
          of a particular installed application), the value
Packit 022b05
          for this object is then '0', signifying that this
Packit 022b05
          process cannot be related back to an application,
Packit 022b05
          and in turn, an installed software package."
Packit 022b05
      ::= { sysApplMapEntry 2 }
Packit 022b05
Packit 022b05
Packit 022b05
  -- Conformance Macros
Packit 022b05
  sysApplMIBCompliances  OBJECT IDENTIFIER ::= { sysApplConformance 1 }
Packit 022b05
  sysApplMIBGroups       OBJECT IDENTIFIER ::= { sysApplConformance 2 }
Packit 022b05
Packit 022b05
  sysApplMIBCompliance MODULE-COMPLIANCE
Packit 022b05
      STATUS  current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "Describes the requirements for conformance to
Packit 022b05
          the System Application MIB"
Packit 022b05
      MODULE  -- this module
Packit 022b05
          MANDATORY-GROUPS { sysApplInstalledGroup,
Packit 022b05
                             sysApplRunGroup, sysApplMapGroup }
Packit 022b05
      ::= { sysApplMIBCompliances 1 }
Packit 022b05
Packit 022b05
  sysApplInstalledGroup OBJECT-GROUP
Packit 022b05
      OBJECTS { sysApplInstallPkgManufacturer,
Packit 022b05
                sysApplInstallPkgProductName,
Packit 022b05
                sysApplInstallPkgVersion,
Packit 022b05
                sysApplInstallPkgSerialNumber,
Packit 022b05
                sysApplInstallPkgDate,
Packit 022b05
                sysApplInstallPkgLocation,
Packit 022b05
                sysApplInstallElmtName,
Packit 022b05
                sysApplInstallElmtType,
Packit 022b05
                sysApplInstallElmtDate,
Packit 022b05
                sysApplInstallElmtPath,
Packit 022b05
                sysApplInstallElmtSizeHigh,
Packit 022b05
                sysApplInstallElmtSizeLow,
Packit 022b05
                sysApplInstallElmtRole,
Packit 022b05
                sysApplInstallElmtModifyDate,
Packit 022b05
                sysApplInstallElmtCurSizeHigh,
Packit 022b05
                sysApplInstallElmtCurSizeLow }
Packit 022b05
      STATUS  current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The system application installed group contains
Packit 022b05
          information about applications and their constituent
Packit 022b05
          components which have been installed on the host system."
Packit 022b05
      ::= { sysApplMIBGroups 1 }
Packit 022b05
Packit 022b05
  sysApplRunGroup OBJECT-GROUP
Packit 022b05
      OBJECTS { sysApplRunStarted,
Packit 022b05
                sysApplRunCurrentState,
Packit 022b05
                sysApplPastRunStarted,
Packit 022b05
                sysApplPastRunExitState,
Packit 022b05
                sysApplPastRunTimeEnded,
Packit 022b05
                sysApplElmtRunInstallID,
Packit 022b05
                sysApplElmtRunTimeStarted,
Packit 022b05
                sysApplElmtRunState,
Packit 022b05
                sysApplElmtRunName,
Packit 022b05
                sysApplElmtRunParameters,
Packit 022b05
                sysApplElmtRunCPU,
Packit 022b05
                sysApplElmtRunMemory,
Packit 022b05
                sysApplElmtRunNumFiles,
Packit 022b05
                sysApplElmtRunUser,
Packit 022b05
                sysApplElmtPastRunInstallID,
Packit 022b05
                sysApplElmtPastRunTimeStarted,
Packit 022b05
                sysApplElmtPastRunTimeEnded,
Packit 022b05
                sysApplElmtPastRunName,
Packit 022b05
                sysApplElmtPastRunParameters,
Packit 022b05
                sysApplElmtPastRunCPU,
Packit 022b05
                sysApplElmtPastRunMemory,
Packit 022b05
                sysApplElmtPastRunNumFiles,
Packit 022b05
                sysApplElmtPastRunUser,
Packit 022b05
                sysApplPastRunMaxRows,
Packit 022b05
                sysApplPastRunTableRemItems,
Packit 022b05
                sysApplPastRunTblTimeLimit,
Packit 022b05
                sysApplElemPastRunMaxRows,
Packit 022b05
                sysApplElemPastRunTableRemItems,
Packit 022b05
                sysApplElemPastRunTblTimeLimit,
Packit 022b05
                sysApplAgentPollInterval }
Packit 022b05
      STATUS  current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The system application run group contains information
Packit 022b05
          about applications and associated elements which have
Packit 022b05
          run or are currently running on the host system."
Packit 022b05
      ::= { sysApplMIBGroups 2 }
Packit 022b05
Packit 022b05
  sysApplMapGroup OBJECT-GROUP
Packit 022b05
      OBJECTS { sysApplMapInstallPkgIndex }
Packit 022b05
      STATUS  current
Packit 022b05
      DESCRIPTION
Packit 022b05
          "The Map Group contains a single table, sysApplMapTable,
Packit 022b05
          that provides a backwards mapping for determining the
Packit 022b05
          invoked application, installed element, and installed
Packit 022b05
          application package given a known process identification
Packit 022b05
          number."
Packit 022b05
  ::= { sysApplMIBGroups 3 }
Packit 022b05
Packit 022b05
  END