home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_a_c / draft-ietf-applmib-sysapplmib-08.txt < prev    next >
Text File  |  1997-04-21  |  90KB  |  2,827 lines
  1.  
  2.   Definitions of System-Level Managed Objects for Applications
  3.  
  4.                          April 15, 1997
  5.  
  6.  
  7.              <draft-ietf-applmib-sysapplmib-08.txt>
  8.  
  9.  
  10.                         Cheryl Krupczak
  11.                    Empire Technologies, Inc.
  12.                      cheryl@empiretech.com
  13.  
  14.                         Jonathan Saperia
  15.                         BGS Systems Inc.
  16.                     saperia@networks.bgs.com
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                       Status of this Memo
  24.  
  25.  This document is an Internet-Draft.  Internet-Drafts are
  26.  working documents of the Internet Engineering Task Force
  27.  (IETF), its areas, and its working groups.  Note that other
  28.  groups may also distribute working documents as Internet-
  29.  Drafts.
  30.  
  31.  Internet-Drafts are draft documents valid for a maximum of six
  32.  months and may be updated, replaced, or obsoleted by other
  33.  documents at any time.  It is inappropriate to use Internet-
  34.  Drafts as reference material or to cite them other than as
  35.  ``work in progress.''
  36.  
  37.  To learn the current status of any Internet-Draft, please
  38.  check the ``1id-abstracts.txt'' listing contained in the
  39.  Internet- Drafts Shadow Directories on ds.internic.net (US
  40.  East Coast), nic.nordu.net (Europe), ftp.isi.edu (US West
  41.  Coast), or munnari.oz.au (Pacific Rim).
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  Internet Draft      System Application MIB      April 15, 1997
  59.  
  60.  
  61.  Table of Contents
  62.  
  63.  1 Abstract ..............................................    3
  64.  2 The SNMPv2 Network Management Framework ...............    3
  65.  2.1 Object Definitions ..................................    4
  66.  3 Overview ..............................................    5
  67.  4 Architecture for Application Management ...............    6
  68.  5 The Structure of the MIB ..............................    7
  69.  5.1 System Application Installed Group ..................    7
  70.  5.2 System Application Run Group ........................    8
  71.  5.2.1 sysApplRunTable and sysApplPastRunTable ...........    8
  72.  5.2.2 sysApplElmtRunTable and  sysApplElmtPastRunTable
  73.       ....................................................    9
  74.  5.3 System Application Map Group ........................   10
  75.  6 Definitions ...........................................   11
  76.  7 Implementation Issues .................................   43
  77.  7.1 Implementation with Polling Agents ..................   43
  78.  7.2 sysApplElmtPastRunTable Entry Collisions ............   44
  79.  8 Security Considerations ...............................   45
  80.  9 Acknowledgements ......................................   46
  81.  10 Editor's Address .....................................   46
  82.  11 References ...........................................   46
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  Expires October 15, 1997                              [Page 2]
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  Internet Draft      System Application MIB      April 15, 1997
  118.  
  119.  
  120.  1.  Abstract
  121.  
  122.  This memo defines a portion of the Management Information Base
  123.  (MIB) for use with network management protocols in the
  124.  Internet community. In particular, it describes a basic set of
  125.  managed objects for fault, configuration and performance
  126.  management of applications from a systems perspective.  More
  127.  specifically, the managed objects are restricted to
  128.  information that can be determined from the system itself and
  129.  which does not require special instrumentation within the
  130.  applications to make the information available.
  131.  
  132.  This memo does not specify a standard for the Internet
  133.  community.
  134.  
  135.  
  136.  
  137.  2.  The SNMPv2 Network Management Framework
  138.  
  139.  The SNMPv2 Network Management Framework consists of the
  140.  following major components:
  141.  
  142.  o    RFC 1902 Structure of Management Information for Version
  143.       2 of the Simple Network Management Protocol (SNMPv2) [2]
  144.  
  145.  o    RFC 1903 Textual Conventions for Version 2 of the Simple
  146.       Network Management Protocol (SNMPv2) [3]
  147.  
  148.  o    RFC 1904 Conformance Statements for Version 2 of the
  149.       Simple Network Management Protocol (SNMPv2) [4]
  150.  
  151.  o    RFC 1905 Protocol Operations for Version 2 of the Simple
  152.       Network Management Protocol (SNMPv2) [5]
  153.  
  154.  o    RFC 1906 Transport Mappings for Version 2 of the Simple
  155.       Network Management Protocol (SNMPv2) [6]
  156.  
  157.  o    RFC 1907 Management Information Base for Version 2 of the
  158.       Simple Network Management Protocol (SNMPv2) [7]
  159.  
  160.  o    RFC 1908 Coexistence between Version 1 and Version 2 of
  161.       the Internet-standard Network Management Framework [8]
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  Expires October 15, 1997                              [Page 3]
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  Internet Draft      System Application MIB      April 15, 1997
  177.  
  178.  
  179.  The Framework permits new objects to be defined for the
  180.  purpose of experimentation and evaluation.
  181.  
  182.  
  183.  2.1.  Object Definitions
  184.  
  185.  Managed objects are accessed via a virtual information store,
  186.  termed the Management Information Base or MIB. Objects in the
  187.  MIB are defined using the subset of Abstract Syntax Notation
  188.  One (ASN.1) [1], defined in the Structure of Management
  189.  Information (SMI)  (See RFC 1902 [2]). In particular, each
  190.  object type is named by an OBJECT IDENTIFIER, an
  191.  administratively assigned name. The object type together with
  192.  an object instance serves to uniquely identify a specific
  193.  instantiation of the object. For human convenience, we often
  194.  use a textual string, termed the object descriptor, to refer
  195.  to the object type.
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  Expires October 15, 1997                              [Page 4]
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  Internet Draft      System Application MIB      April 15, 1997
  236.  
  237.  
  238.  3.  Overview
  239.  
  240.  The primary purpose of computing technologies is the execution
  241.  of application software. These applications, typically
  242.  specialized collections of executables, files, and
  243.  interprocess communications, exist to solve business,
  244.  scientific or other "problems". The configuration, fault
  245.  detection, performance monitoring and control of application
  246.  software across its life on a host computer is of great
  247.  economic importance. For the purposes of our work, we define
  248.  applications as one or more units of executable code and other
  249.  resources, installed on a single host system that a manager
  250.  may think of as a single object for management purposes.
  251.  
  252.  
  253.  The information described by the objects in the System
  254.  Application MIB support configuration, fault, and performance
  255.  management; they represent some of the basic attributes of
  256.  application software from a systems (non-application specific)
  257.  perspective.  The information allows for the description of
  258.  applications as collections of executables and files installed
  259.  and executing on a host computer.
  260.  
  261.  This draft is concerned primarily with, and defines a model
  262.  for, application information resident on a host computer which
  263.  can be determined from the system itself, and not from the
  264.  individual applications.  This system-level view of
  265.  applications is designed to provide information about software
  266.  applications installed and running on the host system without
  267.  requiring modifications and code additions to the applications
  268.  themselves.  This approach was taken to insure ease and speed
  269.  of implementation, while allowing room for future growth.
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  Expires October 15, 1997                              [Page 5]
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  Internet Draft      System Application MIB      April 15, 1997
  295.  
  296.  
  297.  4.  Architecture for Application Management
  298.  
  299.  In the area of application management it is fully acknowledged
  300.  and even expected that additional MIB modules will be defined
  301.  over time to provide an even greater level of detail regarding
  302.  applications. This MIB module presents the most general case:
  303.  a set of management objects for providing generic information
  304.  about applications and whose object values can be determined
  305.  from the computer system itself without requiring
  306.  instrumentation within the application.
  307.  
  308.  A finer-grained level of detail is planned for the future
  309.  "appl MIB" which will be a common set of management objects
  310.  relating to generic applications, but which require some type
  311.  of instrumentation in the application in order to be
  312.  determined.  Since the applmib MIB module will provide a finer
  313.  level of detail, any connection to the sysAppl MIB should be
  314.  made by having references from the more detailed appl MIB back
  315.  to the more generic sysAppl MIB.  Likewise, as application-
  316.  specific MIB modules such as the WWW MIB, etc., are developed
  317.  over time, these more specific MIBs should reference back to
  318.  the more generic MIBs.
  319.  
  320.  While this MIB module does not attempt to provide every
  321.  detailed piece of information for managing applications, it
  322.  does provide a basic systems-level view of the applications
  323.  and their components on a single host system.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  Expires October 15, 1997                              [Page 6]
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  Internet Draft      System Application MIB      April 15, 1997
  354.  
  355.  
  356.  5.  The Structure of the MIB
  357.  
  358.  The System Application MIB structure models application
  359.  packages as a whole, and also models the individual elements
  360.  (files and executables) which collectively form an
  361.  application.  The MIB is structured to model information
  362.  regarding installed application packages and the elements
  363.  which make up each application package. The MIB also models
  364.  activity information on applications (and in turn, their
  365.  components) that are running or have previously run on the
  366.  host system.  In modeling applications and their elements,
  367.  this MIB module provides the necessary link for associating
  368.  executing processes with the applications of which they are a
  369.  part.
  370.  
  371.  The objects are arranged into the following groups:
  372.  
  373.      -  System Application Installed Group
  374.             - sysApplInstallPkgTable
  375.             - sysApplInstallElmtTable
  376.  
  377.      -  System Application Run Group
  378.             - sysApplRunTable
  379.             - sysApplPastRunTable
  380.             - sysApplElmtRunTable
  381.             - sysApplElmtPastRunTable
  382.             - (scalars for restricting table sizes)
  383.  
  384.      -  System Application Map Group
  385.             - sysApplMapTable
  386.  
  387.  As can be seen by the arrangement above, for each category,
  388.  the MIB first treats an application package as a whole, and
  389.  then breaks down the package to provide information about each
  390.  of the elements (executable and non-executable files) of the
  391.  package.
  392.  
  393.  
  394.  5.1.  System Application Installed Group
  395.  
  396.  The System Application Installed group consists of two tables.
  397.  Through these two tables, administrators will be able to
  398.  determine which applications have been installed on a system
  399.  and what their constituent components are.  The first table,
  400.  the sysApplInstallPkgTable, lists the application packages
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  Expires October 15, 1997                              [Page 7]
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  Internet Draft      System Application MIB      April 15, 1997
  413.  
  414.  
  415.  installed on a particular host. The second, the
  416.  sysApplInstallElmtTable, provides information regarding the
  417.  executables and non-executable files, or elements, which
  418.  collectively compose an application.
  419.  
  420.  NOTE: This MIB is intended to work with applications that have
  421.  been installed on a particular host, where "installed" means
  422.  that the existence of the application and the association
  423.  between an application and its component files can be
  424.  discovered without requiring additional instrumentation of the
  425.  application itself.  This may require that certain conventions
  426.  be used, such as using a central software installation
  427.  mechanism or registry, when installing application packages.
  428.  For example, many UNIX systems utilize a "pkgadd" utility to
  429.  track installed application packages, while many PC systems
  430.  utilize a global registry.
  431.  
  432.  
  433.  5.2.  System Application Run Group
  434.  
  435.  This group models activity information for applications that
  436.  have been invoked and are either currently running, or have
  437.  previously run, on the host system.  Likewise, the individual
  438.  elements of an invoked application are also modeled to show
  439.  currently running processes, and processes that have run in
  440.  the past.  This information is modeled using two pairs of
  441.  tables: a pair of tables for currently running applications
  442.  and past run applications, and a pair of tables for the
  443.  currently running elements and the past run elements.  Seven
  444.  scalars are also defined to control the size of the past run
  445.  tables.
  446.  
  447.  
  448.  
  449.  5.2.1.  sysApplRunTable and sysApplPastRunTable
  450.  
  451.  The sysApplRunTable and the sysApplPastRunTable make up the
  452.  first pair of tables.  The sysApplRunTable contains the
  453.  application instances which are currently running on the host.
  454.  Each time an application is invoked, a new entry is created in
  455.  the sysApplRunTable to provide information about that
  456.  particular invocation of the application.  An entry will
  457.  remain in this table until the application instance
  458.  terminates, at which time the entry will be deleted from the
  459.  sysApplRunTable and placed in the sysApplPastRunTable.
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  Expires October 15, 1997                              [Page 8]
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  Internet Draft      System Application MIB      April 15, 1997
  472.  
  473.  
  474.  The sysApplPastRunTable maintains a history of instances of
  475.  applications which have previously executed on the host.
  476.  Entries to this table are made when an invoked application
  477.  from the sysApplRunTable terminates; the table entry which
  478.  represents the application instance is removed from the
  479.  SysApplRunTable and a corresponding entry is added to the
  480.  sysApplPastRunTable.
  481.  
  482.  Because the sysApplPastRunTable will continuously grow as
  483.  applications are executed and terminate, two scalars are
  484.  defined to control the aging-out of table entries. The value
  485.  of sysApplPastRunMaxRows specifies the maximum number of
  486.  entries the table may contain, while the
  487.  sysApplPastRunTblTimeLimit specifies the maximum age of the
  488.  table entries.  Oldest entries are removed first.
  489.  
  490.  It is important to note that the sysApplRunTable and
  491.  sysApplPastRunTable contain entries for each INVOCATION of an
  492.  application. A single application package might be invoked
  493.  multiple times; each invocation is properly recorded by a
  494.  separate entry in the sysApplRunTable.
  495.  
  496.  In order to implement this group, the agent must be able to
  497.  recognize that an application has been invoked, and be able to
  498.  determine when that invocation terminates.  This poses a
  499.  complex problem since a single application invocation may
  500.  involve numerous processes, some of which may be required to
  501.  remain running throughout the duration of the application,
  502.  others which might come and go.  The sysApplInstallElmtRole
  503.  columnar object in the sysApplInstallElmtTable is meant to
  504.  assist in this task by indicating which elements must be
  505.  running in order for the application to be running, which
  506.  elements are dependent on required elements, etc.  See the
  507.  description of sysApplInstallElmtRole for more details.
  508.  
  509.  
  510.  
  511.  5.2.2.  sysApplElmtRunTable and sysApplElmtPastRunTable
  512.  
  513.  While the sysApplRunTable and sysApplPastRunTable focus on
  514.  applications as a whole, the sysApplElmtRunTable and
  515.  sysApplElmtPastRunTable provide information regarding an
  516.  application's executable elements, (processes), which are
  517.  either currently executing or have executed in the past.
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  Expires October 15, 1997                              [Page 9]
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  Internet Draft      System Application MIB      April 15, 1997
  531.  
  532.  
  533.  The sysApplElmtRunTable contains an entry for every process
  534.  currently running on the host.  An entry is created in this
  535.  table for each process at the time it is started, and will
  536.  remain in the table until the process terminates.  Note that
  537.  in order to provide complete information on the load on the
  538.  system, this table lists EVERY running process, not just those
  539.  processes that are running as part of an identified
  540.  application.  However, when processes terminate, only
  541.  information from entries corresponding to elements of an
  542.  identified application are moved to the
  543.  sysApplElmtPastRunTable.
  544.  
  545.  
  546.  The sysApplElmtPastRunTable maintains a history of instances
  547.  of processes which have previously executed on the host as
  548.  part of an application. When a process from the
  549.  sysApplElmtRunTable terminates, the entry's information is
  550.  moved to this sysApplElmtPastRunTable provided that the
  551.  process was part of an identified application.  If the process
  552.  cannot be associated with any 'parent' application, than it is
  553.  simply removed from the sysApplElmtRunTable.  This allows for
  554.  processes like 'ps' or 'grep' to show up in the
  555.  sysApplElmtRunTable, (where they are consuming resources and
  556.  are thus, "interesting"), but not in the
  557.  sysApplElmtPastRunTable.
  558.  
  559.  Because the sysApplElmtPastRunTable will continuously grow as
  560.  processes are executed and terminate, two scalars are defined
  561.  to control the aging-out of table entries.  The value of
  562.  sysApplElmtPastRunMaxRows specifies the maximum number of
  563.  entries the table may contain, while the
  564.  sysApplElmtPastRunTblTimeLimit specifies the maximum age of
  565.  the table entries.  Oldest entries are removed first.
  566.  
  567.  
  568.  
  569.  5.3.  System Application Map Group
  570.  
  571.  The Map group contains a single table, the sysApplMapTable,
  572.  whose sole purpose is to provide a backwards mapping for
  573.  determining the invoked application, installed element, and
  574.  installed application package given a known process
  575.  identification number.
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  Expires October 15, 1997                             [Page 10]
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  Internet Draft      System Application MIB      April 15, 1997
  590.  
  591.  
  592.  6.  Definitions
  593.  
  594.    SYSAPPL-MIB DEFINITIONS ::= BEGIN
  595.  
  596.    IMPORTS
  597.        MODULE-IDENTITY, OBJECT-TYPE,
  598.        Unsigned32, TimeTicks, Counter32, Gauge32
  599.            FROM SNMPv2-SMI
  600.        DateAndTime, TEXTUAL-CONVENTION
  601.            FROM SNMPv2-TC
  602.        MODULE-COMPLIANCE, OBJECT-GROUP
  603.            FROM SNMPv2-CONF
  604.        mib-2 FROM RFC1213-MIB;
  605.  
  606.  
  607.  
  608.    -- System Application MIB
  609.  
  610.    sysApplMIB MODULE-IDENTITY
  611.        LAST-UPDATED "9704150000Z"
  612.        ORGANIZATION "IETF Applications MIB Working Group"
  613.        CONTACT-INFO
  614.              "Cheryl Krupczak (Editor, WG Advisor)
  615.               Postal: Empire Technologies, Inc.
  616.               541 Tenth Street NW
  617.               Suite 169
  618.               Atlanta, GA 30318
  619.               USA
  620.               Phone: (770) 384-0184
  621.               Email: cheryl@empiretech.com
  622.  
  623.               Jon Saperia (WG Chair)
  624.               Postal:  BGS Systems, Inc.
  625.               One First Avenue
  626.               Waltham, MA 02254-9111
  627.               USA
  628.               Phone: (617) 891-0000
  629.               Email: saperia@networks.bgs.com"
  630.        DESCRIPTION
  631.            "The MIB module defines management objects that model
  632.            applications as collections of executables and files
  633.            installed and executing on a host system.  The MIB
  634.            presents a system-level view of applications; i.e.,
  635.            objects in this MIB are limited to those attributes
  636.            that can typically be obtained from the system itself
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  Expires October 15, 1997                             [Page 11]
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  Internet Draft      System Application MIB      April 15, 1997
  649.  
  650.  
  651.            without adding special instrumentation to the applications."
  652.        ::= { mib-2 9999  }
  653.  
  654.  
  655.    sysApplOBJ               OBJECT IDENTIFIER ::= { sysApplMIB 1 }
  656.    sysApplInstalled         OBJECT IDENTIFIER ::= { sysApplOBJ 1 }
  657.    sysApplRun               OBJECT IDENTIFIER ::= { sysApplOBJ 2 }
  658.    sysApplMap               OBJECT IDENTIFIER ::= { sysApplOBJ 3 }
  659.    sysApplNotifications     OBJECT IDENTIFIER ::= { sysApplMIB 2 }
  660.    sysApplConformance       OBJECT IDENTIFIER ::= { sysApplMIB 3 }
  661.  
  662.    -- Textual Conventions
  663.  
  664.    RunState ::= TEXTUAL-CONVENTION
  665.        STATUS      current
  666.        DESCRIPTION
  667.            "This TC describes the current execution state of
  668.            a running application or process."
  669.        SYNTAX      INTEGER {
  670.                    running (1),
  671.                    runnable (2), -- waiting for resource (CPU, etc.)
  672.                    waiting (3),  -- waiting for event
  673.                    exiting (4),
  674.                    other (5)     -- other invalid state
  675.                    }
  676.  
  677.  LongUtf8String ::= TEXTUAL-CONVENTION
  678.          DISPLAY-HINT "1024a"
  679.          STATUS  current
  680.          DESCRIPTION
  681.                  "To facilitate internationalization, this TC
  682.                   represents information taken from the ISO/IEC IS
  683.                   10646-1 character set, encoded as an octet string
  684.                   using the UTF-8 character encoding scheme described
  685.                   in RFC 2044 [10].  For strings in 7-bit US-ASCII,
  686.                   there is no impact since the UTF-8 representation
  687.                   is identical to the US-ASCII encoding."
  688.          SYNTAX  OCTET STRING (SIZE (0..1024))
  689.  
  690.  Utf8String ::= TEXTUAL-CONVENTION
  691.          DISPLAY-HINT "255a"
  692.          STATUS  current
  693.          DESCRIPTION
  694.                  "To facilitate internationalization, this TC
  695.                   represents information taken from the ISO/IEC IS
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  Expires October 15, 1997                             [Page 12]
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  Internet Draft      System Application MIB      April 15, 1997
  708.  
  709.  
  710.                   10646-1 character set, encoded as an octet string
  711.                   using the UTF-8 character encoding scheme described
  712.                   in RFC 2044 [10].  For strings in 7-bit US-ASCII,
  713.                   there is no impact since the UTF-8 representation
  714.                   is identical to the US-ASCII encoding."
  715.          SYNTAX  OCTET STRING (SIZE (0..255))
  716.  
  717.  
  718.  
  719.    -- sysApplInstalled Group
  720.    -- This group provides information about application packages
  721.    -- that have been installed on the host computer.  The group
  722.    -- contains two tables.  The first, the sysApplInstallPkgTable,
  723.    -- describes the application packages, the second, the
  724.    -- sysApplInstallElmtTable, describes the constituent elements
  725.    -- (files and executables) which compose an application package.
  726.    --
  727.    -- In order to appear in this group, an application and its
  728.    -- component files must be discoverable by the system itself,
  729.    -- possibly through some type of software installation mechanism
  730.    -- or registry.
  731.  
  732.    -- sysApplInstallPkgTable
  733.    -- The system installed application packages table provides
  734.    -- information on the software packages installed on a system.
  735.    -- These packages may consist of many different files including
  736.    -- executable and non-executable files.
  737.  
  738.    sysApplInstallPkgTable OBJECT-TYPE
  739.        SYNTAX      SEQUENCE OF SysApplInstallPkgEntry
  740.        MAX-ACCESS  not-accessible
  741.        STATUS      current
  742.        DESCRIPTION
  743.            "The table listing the software application packages
  744.            installed on a host computer. In order to appear in
  745.            this table, it may be necessary for the application
  746.            to be installed using some type of software
  747.            installation mechanism or global registry so that its
  748.            existence can be detected by the agent implementation."
  749.        ::= { sysApplInstalled 1 }
  750.  
  751.    sysApplInstallPkgEntry OBJECT-TYPE
  752.        SYNTAX      SysApplInstallPkgEntry
  753.        MAX-ACCESS  not-accessible
  754.        STATUS      current
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  Expires October 15, 1997                             [Page 13]
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  Internet Draft      System Application MIB      April 15, 1997
  767.  
  768.  
  769.        DESCRIPTION
  770.            "The logical row describing an installed application
  771.            package."
  772.        INDEX    { sysApplInstallPkgIndex }
  773.        ::= { sysApplInstallPkgTable 1 }
  774.  
  775.    SysApplInstallPkgEntry ::= SEQUENCE {
  776.        sysApplInstallPkgIndex               Unsigned32,
  777.        sysApplInstallPkgManufacturer        Utf8String,
  778.        sysApplInstallPkgProductName         Utf8String,
  779.        sysApplInstallPkgVersion             Utf8String,
  780.        sysApplInstallPkgSerialNumber        Utf8String,
  781.        sysApplInstallPkgDate                DateAndTime,
  782.        sysApplInstallPkgLocation            LongUtf8String
  783.    }
  784.  
  785.    sysApplInstallPkgIndex OBJECT-TYPE
  786.        SYNTAX      Unsigned32 (1..'ffffffff'h)
  787.        MAX-ACCESS  not-accessible
  788.        STATUS      current
  789.        DESCRIPTION
  790.            "An integer used only for indexing purposes.
  791.            Generally monotonically increasing from 1 as new
  792.            applications are installed.
  793.  
  794.            The value for each installed application must
  795.            remain constant at least from one re-initialization of
  796.            the network management entity which implements this
  797.            MIB module to the next re-initialization.
  798.  
  799.            The specific value is meaningful only within a given SNMP
  800.            entity. A sysApplInstallPkgIndex value must not be re-used
  801.            until the next agent entity restart in the event the
  802.            installed application entry is deleted."
  803.        ::= { sysApplInstallPkgEntry 1 }
  804.  
  805.    sysApplInstallPkgManufacturer OBJECT-TYPE
  806.        SYNTAX      Utf8String
  807.        MAX-ACCESS  read-only
  808.        STATUS      current
  809.        DESCRIPTION
  810.            "The Manufacturer of the software application package."
  811.        ::= { sysApplInstallPkgEntry 2 }
  812.  
  813.    sysApplInstallPkgProductName OBJECT-TYPE
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  Expires October 15, 1997                             [Page 14]
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  Internet Draft      System Application MIB      April 15, 1997
  826.  
  827.  
  828.        SYNTAX      Utf8String
  829.        MAX-ACCESS  read-only
  830.        STATUS      current
  831.        DESCRIPTION
  832.            "The name provided to the software application package
  833.            by the Manufacturer."
  834.        ::= { sysApplInstallPkgEntry 3 }
  835.  
  836.    sysApplInstallPkgVersion OBJECT-TYPE
  837.        SYNTAX      Utf8String
  838.        MAX-ACCESS  read-only
  839.        STATUS      current
  840.        DESCRIPTION
  841.            "The version number assigned to the application package
  842.            by the manufacturer of the software."
  843.        ::= { sysApplInstallPkgEntry 4 }
  844.  
  845.    sysApplInstallPkgSerialNumber OBJECT-TYPE
  846.        SYNTAX      Utf8String
  847.        MAX-ACCESS  read-only
  848.        STATUS      current
  849.        DESCRIPTION
  850.            "The serial number of the software assigned by the
  851.            manufacturer."
  852.        ::= { sysApplInstallPkgEntry 5 }
  853.  
  854.    sysApplInstallPkgDate OBJECT-TYPE
  855.        SYNTAX      DateAndTime
  856.        MAX-ACCESS  read-only
  857.        STATUS      current
  858.        DESCRIPTION
  859.            "The date and time this software application was installed
  860.            on the host."
  861.        ::= { sysApplInstallPkgEntry 6 }
  862.  
  863.    sysApplInstallPkgLocation OBJECT-TYPE
  864.        SYNTAX      LongUtf8String
  865.        MAX-ACCESS  read-only
  866.        STATUS      current
  867.        DESCRIPTION
  868.            "The complete path name where the application package
  869.            is installed.  For example, the value would be
  870.            '/opt/MyapplDir' if the application package was installed
  871.            in the /opt/MyapplDir directory."
  872.        ::= { sysApplInstallPkgEntry 7 }
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  Expires October 15, 1997                             [Page 15]
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  Internet Draft      System Application MIB      April 15, 1997
  885.  
  886.  
  887.  
  888.  
  889.    -- sysApplInstallElmtTable
  890.    -- The table describing the individual application package
  891.    -- elements (files and executables) installed on the host computer.
  892.  
  893.    sysApplInstallElmtTable OBJECT-TYPE
  894.        SYNTAX      SEQUENCE OF SysApplInstallElmtEntry
  895.        MAX-ACCESS  not-accessible
  896.        STATUS      current
  897.        DESCRIPTION
  898.            "This table details the individual application package
  899.            elements (files and executables) which comprise the
  900.            applications defined in the sysApplInstallPkg Table.
  901.            Each entry in this table has an index to the
  902.            sysApplInstallPkg table to identify the application
  903.            package of which it is a part. As a result, there may
  904.            be many entries in this table for each instance in the
  905.            sysApplInstallPkg Table.
  906.  
  907.            Table entries are indexed by sysApplInstallPkgIndex,
  908.            sysApplInstallElmtIndex to facilitate retrieval of
  909.            all elements associated with a particular installed
  910.            application package."
  911.        ::= { sysApplInstalled 2 }
  912.  
  913.    sysApplInstallElmtEntry OBJECT-TYPE
  914.        SYNTAX      SysApplInstallElmtEntry
  915.        MAX-ACCESS  not-accessible
  916.        STATUS      current
  917.        DESCRIPTION
  918.            "The logical row describing an element of an installed
  919.            application.  The element may be an executable or
  920.            non-executable file."
  921.        INDEX    {sysApplInstallPkgIndex, sysApplInstallElmtIndex}
  922.        ::= { sysApplInstallElmtTable 1 }
  923.  
  924.    SysApplInstallElmtEntry ::= SEQUENCE {
  925.        sysApplInstallElmtIndex                 Unsigned32,
  926.        sysApplInstallElmtName                  Utf8String,
  927.        sysApplInstallElmtType                  INTEGER,
  928.        sysApplInstallElmtDate                  DateAndTime,
  929.        sysApplInstallElmtPath                  LongUtf8String,
  930.        sysApplInstallElmtSizeHigh              Unsigned32,
  931.        sysApplInstallElmtSizeLow               Unsigned32,
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  Expires October 15, 1997                             [Page 16]
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  Internet Draft      System Application MIB      April 15, 1997
  944.  
  945.  
  946.        sysApplInstallElmtRole                  BITS,
  947.        sysApplInstallElmtModifyDate            DateAndTime,
  948.        sysApplInstallElmtCurSizeHigh           Unsigned32,
  949.        sysApplInstallElmtCurSizeLow            Unsigned32
  950.  
  951.    }
  952.  
  953.    sysApplInstallElmtIndex OBJECT-TYPE
  954.        SYNTAX      Unsigned32 (1..'ffffffff'h)
  955.        MAX-ACCESS  not-accessible
  956.        STATUS      current
  957.        DESCRIPTION
  958.            "An arbitrary integer used for indexing.  The value
  959.            of this index is unique among all rows in this table
  960.            that exist or have existed since the last agent restart."
  961.        ::= { sysApplInstallElmtEntry 1 }
  962.  
  963.  
  964.    sysApplInstallElmtName OBJECT-TYPE
  965.        SYNTAX      Utf8String
  966.        MAX-ACCESS  read-only
  967.        STATUS      current
  968.        DESCRIPTION
  969.            "The name of this element which is contained in the
  970.            application."
  971.        ::= { sysApplInstallElmtEntry 2 }
  972.  
  973.    sysApplInstallElmtType OBJECT-TYPE
  974.        SYNTAX      INTEGER {
  975.                    unknown(1),
  976.                    nonexecutable(2),
  977.                    operatingSystem(3),  -- executable
  978.                    deviceDriver(4),     -- executable
  979.                    application(5)       -- executable
  980.                    }
  981.        MAX-ACCESS  read-only
  982.        STATUS      current
  983.        DESCRIPTION
  984.            "The type of element that is part of the installed
  985.            application."
  986.        ::= { sysApplInstallElmtEntry 3 }
  987.  
  988.    sysApplInstallElmtDate OBJECT-TYPE
  989.        SYNTAX      DateAndTime
  990.        MAX-ACCESS  read-only
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  Expires October 15, 1997                             [Page 17]
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  Internet Draft      System Application MIB      April 15, 1997
  1003.  
  1004.  
  1005.        STATUS      current
  1006.        DESCRIPTION
  1007.            "The date and time that this component was installed on
  1008.            the system."
  1009.        ::= { sysApplInstallElmtEntry 4 }
  1010.  
  1011.    sysApplInstallElmtPath OBJECT-TYPE
  1012.        SYNTAX      LongUtf8String
  1013.        MAX-ACCESS  read-only
  1014.        STATUS      current
  1015.        DESCRIPTION
  1016.            "The full directory path where this element is installed.
  1017.            For example, the value would be '/opt/EMPuma/bin' for an
  1018.            element installed in the directory '/opt/EMPuma/bin'."
  1019.        ::= { sysApplInstallElmtEntry 5}
  1020.  
  1021.    sysApplInstallElmtSizeHigh OBJECT-TYPE
  1022.        SYNTAX      Unsigned32
  1023.        MAX-ACCESS  read-only
  1024.        STATUS      current
  1025.        DESCRIPTION
  1026.            "The installed file size in 2^32 byte blocks. This is
  1027.            the size of the file on disk immediately after installation.
  1028.  
  1029.            For example, for a file with a total size of 4,294,967,296
  1030.            bytes, this variable would have a value of 1; for a file
  1031.            with a total size of 4,294,967,295 bytes this variable
  1032.            would be 0."
  1033.        ::= { sysApplInstallElmtEntry 6 }
  1034.  
  1035.    sysApplInstallElmtSizeLow OBJECT-TYPE
  1036.        SYNTAX      Unsigned32
  1037.        MAX-ACCESS  read-only
  1038.        STATUS      current
  1039.        DESCRIPTION
  1040.            "The installed file size modulo 2^32 bytes.  This is
  1041.            the size of the file on disk immediately after installation.
  1042.  
  1043.            For example, for a file with a total size of 4,294,967,296
  1044.            bytes this variable would have a value of 0; for a file with
  1045.            a total size of 4,294,967,295 bytes this variable would be
  1046.            4,294,967,295."
  1047.        ::= { sysApplInstallElmtEntry 7 }
  1048.  
  1049.    sysApplInstallElmtRole  OBJECT-TYPE
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  Expires October 15, 1997                             [Page 18]
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  Internet Draft      System Application MIB      April 15, 1997
  1062.  
  1063.  
  1064.        SYNTAX      BITS {
  1065.                    executable(0),
  1066.                       -- An application may have one or
  1067.                       -- more executable elements.  The rest of the
  1068.                       -- bits have no meaning if the element is not
  1069.                       -- executable.
  1070.                    exclusive(1),
  1071.                       -- Only one copy of an exclusive element may be
  1072.                       -- running per invocation of the running
  1073.                       -- application.
  1074.                    primary(2),
  1075.                       -- The primary executable.  The execution of
  1076.                       -- this element constitutes an invocation of
  1077.                       -- the application.  This is used by the agent
  1078.                       -- implementation to determine the initiation of
  1079.                       -- an application.
  1080.                    required(3),
  1081.                       -- An application may have zero or more required
  1082.                       -- elements. All required elements must be running
  1083.                       -- in order for the application to be judged to be
  1084.                       -- running and healthy.
  1085.                    dependent(4),
  1086.                       -- An application may have zero or more
  1087.                       -- dependent elements. Dependent elements may
  1088.                       -- not be running unless required elements are.
  1089.                    unknown(5)
  1090.                       -- Default value for the case when an operator
  1091.                       -- has not yet assigned one of the other values.
  1092.                       -- When set, bits 1, 2, 3, and 4 have no meaning.
  1093.                    }
  1094.        MAX-ACCESS  read-write
  1095.        STATUS      current
  1096.        DESCRIPTION
  1097.            "An operator assigned value used in the determination of
  1098.            application status. This value is used by the agent to
  1099.            determine both the mapping of started processes to the
  1100.            initiation of an application, as well as to allow for a
  1101.            determination of application health. The default value,
  1102.            unknown(5), is used when an operator has not yet assigned
  1103.            one of the other values.  If unknown(5) is set, bits
  1104.            1 - 4 have no meaning."
  1105.        DEFVAL { { unknown } }
  1106.        ::= { sysApplInstallElmtEntry 8 }
  1107.  
  1108.    sysApplInstallElmtModifyDate OBJECT-TYPE
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  Expires October 15, 1997                             [Page 19]
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  Internet Draft      System Application MIB      April 15, 1997
  1121.  
  1122.  
  1123.        SYNTAX      DateAndTime
  1124.        MAX-ACCESS  read-only
  1125.        STATUS      current
  1126.        DESCRIPTION
  1127.            "The date and time that this element was last modified.
  1128.            Modification of the sysApplInstallElmtRole columnar
  1129.            object does NOT constitute a modification of the element
  1130.            itself and should not affect the value of this object."
  1131.        ::= { sysApplInstallElmtEntry 9 }
  1132.  
  1133.    sysApplInstallElmtCurSizeHigh OBJECT-TYPE
  1134.        SYNTAX      Unsigned32
  1135.        MAX-ACCESS  read-only
  1136.        STATUS      current
  1137.        DESCRIPTION
  1138.            "The current file size in 2^32 byte blocks.
  1139.            For example, for a file with a total size of 4,294,967,296
  1140.            bytes, this variable would have a value of 1; for a file
  1141.            with a total size of 4,294,967,295 bytes this variable
  1142.            would be 0."
  1143.        ::= { sysApplInstallElmtEntry 10 }
  1144.  
  1145.    sysApplInstallElmtCurSizeLow OBJECT-TYPE
  1146.        SYNTAX      Unsigned32
  1147.        MAX-ACCESS  read-only
  1148.        STATUS      current
  1149.        DESCRIPTION
  1150.            "The current file size modulo 2^32 bytes.
  1151.            For example, for a file with a total size of 4,294,967,296
  1152.            bytes this variable would have a value of 0; for a file with
  1153.            a total size of 4,294,967,295 bytes this variable would be
  1154.            4,294,967,295."
  1155.        ::= { sysApplInstallElmtEntry 11 }
  1156.  
  1157.  
  1158.  
  1159.    -- sysApplRun Group
  1160.    -- This group models activity information for applications
  1161.    -- that have been invoked and are either currently running,
  1162.    -- or have previously run on the host system.  Likewise,
  1163.    -- the individual elements of an invoked application are
  1164.    -- also modeled to show currently running processes, and
  1165.    -- processes that have run in the past.
  1166.  
  1167.    -- sysApplRunTable
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  Expires October 15, 1997                             [Page 20]
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  Internet Draft      System Application MIB      April 15, 1997
  1180.  
  1181.  
  1182.    -- The sysApplRunTable contains the application instances
  1183.    -- which are currently running on the host.  Since a single
  1184.    -- application might be invoked multiple times, an entry is
  1185.    -- added to this table for each INVOCATION of an application.
  1186.    -- The table is indexed by sysApplInstallPkgIndex, sysApplRunIndex
  1187.    -- to enable managers to easily locate all invocations of
  1188.    -- a particular application package.
  1189.  
  1190.    sysApplRunTable OBJECT-TYPE
  1191.        SYNTAX      SEQUENCE OF SysApplRunEntry
  1192.        MAX-ACCESS  not-accessible
  1193.        STATUS      current
  1194.        DESCRIPTION
  1195.            "The table describes the applications which are executing
  1196.            on the host.  Each time an application is invoked,
  1197.            an entry is created in this table. When an application ends,
  1198.            the entry is removed from this table and a corresponding
  1199.                    entry is created in the SysApplPastRunTable.
  1200.  
  1201.            The table is indexed by sysApplInstallPkgIndex,
  1202.            sysApplRunIndex to enable managers to easily locate all
  1203.            invocations of a particular application package."
  1204.        ::= { sysApplRun 1 }
  1205.  
  1206.    sysApplRunEntry OBJECT-TYPE
  1207.        SYNTAX      SysApplRunEntry
  1208.        MAX-ACCESS  not-accessible
  1209.        STATUS      current
  1210.        DESCRIPTION
  1211.            "The logical row describing an application which is
  1212.            currently running on this host."
  1213.        INDEX    { sysApplInstallPkgIndex, sysApplRunIndex }
  1214.        ::= { sysApplRunTable   1 }
  1215.  
  1216.    SysApplRunEntry ::= SEQUENCE {
  1217.        sysApplRunIndex                         Unsigned32,
  1218.        sysApplRunStarted                       DateAndTime,
  1219.        sysApplRunCurrentState                  RunState
  1220.    }
  1221.  
  1222.    sysApplRunIndex OBJECT-TYPE
  1223.        SYNTAX      Unsigned32 (1..'ffffffff'h)
  1224.        MAX-ACCESS  not-accessible
  1225.        STATUS      current
  1226.        DESCRIPTION
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  Expires October 15, 1997                             [Page 21]
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  Internet Draft      System Application MIB      April 15, 1997
  1239.  
  1240.  
  1241.            "Part of the index for this table. An arbitrary
  1242.            integer used only for indexing purposes. Generally
  1243.            monotonically increasing from 1 as new applications are
  1244.            started on the host, it uniquely identifies application
  1245.            invocations.
  1246.  
  1247.            The numbering for this index increases by 1 for each
  1248.            INVOCATION of an application, regardless of which
  1249.            installed application package this entry represents a
  1250.            running instance of.
  1251.  
  1252.            An example of the indexing for a couple of entries is
  1253.            shown below.
  1254.  
  1255.                          :
  1256.                     sysApplRunStarted.17.14
  1257.                     sysApplRunStarted.17.63
  1258.                     sysApplRunStarted.18.13
  1259.                          :
  1260.  
  1261.            In this example, the agent has observed 12 application
  1262.            invocations when the application represented by entry 18
  1263.            in the sysApplInstallPkgTable is invoked.  The next
  1264.            invocation detected by the agent is an invocation of
  1265.            installed application package 17.  Some time later,
  1266.            installed application 17 is invoked a second time.
  1267.  
  1268.            NOTE: this index is not intended to reflect a real-time
  1269.            (wall clock time) ordering of application invocations;
  1270.            it is merely intended to uniquely identify running
  1271.            instances of applications.  Although the
  1272.            sysApplInstallPkgIndex is included in the INDEX clause
  1273.            for this table, it serves only to ease searching of
  1274.            this table by installed application and does not
  1275.            contribute to uniquely identifying table entries."
  1276.        ::= { sysApplRunEntry 1 }
  1277.  
  1278.    sysApplRunStarted OBJECT-TYPE
  1279.        SYNTAX      DateAndTime
  1280.        MAX-ACCESS  read-only
  1281.        STATUS      current
  1282.        DESCRIPTION
  1283.            "The date and time that the application was started."
  1284.        ::= { sysApplRunEntry 2 }
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  Expires October 15, 1997                             [Page 22]
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  Internet Draft      System Application MIB      April 15, 1997
  1298.  
  1299.  
  1300.    sysApplRunCurrentState OBJECT-TYPE
  1301.        SYNTAX      RunState
  1302.        MAX-ACCESS  read-only
  1303.        STATUS      current
  1304.        DESCRIPTION
  1305.            "The current state of the running application. The
  1306.            possible values are running(1), runnable(2) but waiting
  1307.            for a resource such as CPU, waiting(3) for an event,
  1308.            exiting(4), or other(5)."
  1309.        ::= { sysApplRunEntry 3 }
  1310.  
  1311.  
  1312.    -- sysApplPastRunTable
  1313.    -- The sysApplPastRunTable provides a history of applications
  1314.    -- previously run on the host computer. Entries are removed from
  1315.    -- the sysApplRunTable and corresponding entries are added to this
  1316.    -- table when an application becomes inactive. Entries remain in
  1317.    -- this table until they are aged out when either the table size
  1318.    -- reaches a maximum as determined by the sysApplPastRunMaxRows,
  1319.    -- or when an entry has aged to exceed a time limit as set be
  1320.    -- sysApplPastRunTblTimeLimit.
  1321.    --
  1322.    -- When aging out entries, the oldest entry, as determined by
  1323.    -- the value of sysApplPastRunTimeEnded, will be removed first.
  1324.  
  1325.    sysApplPastRunTable OBJECT-TYPE
  1326.        SYNTAX      SEQUENCE OF SysApplPastRunEntry
  1327.        MAX-ACCESS  not-accessible
  1328.        STATUS      current
  1329.        DESCRIPTION
  1330.            "A history of the applications that have previously run
  1331.            on the host computer.  An entry's information is moved to
  1332.            this table from the sysApplRunTable when the invoked
  1333.            application represented by the entry ceases to be running.
  1334.  
  1335.            Entries remain in this table until they are aged out when
  1336.            either the table size reaches a maximum as determined by
  1337.            the sysApplPastRunMaxRows, or when an entry has aged to
  1338.            exceed a time limit as set by sysApplPastRunTblTimeLimit.
  1339.  
  1340.            Entries in this table are indexed by sysApplInstallPkgIndex,
  1341.            sysApplPastRunIndex to facilitate retrieval of all past
  1342.            run invocations of a particular installed application."
  1343.        ::= { sysApplRun 2 }
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  Expires October 15, 1997                             [Page 23]
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  Internet Draft      System Application MIB      April 15, 1997
  1357.  
  1358.  
  1359.    sysApplPastRunEntry OBJECT-TYPE
  1360.        SYNTAX      SysApplPastRunEntry
  1361.        MAX-ACCESS  not-accessible
  1362.        STATUS      current
  1363.        DESCRIPTION
  1364.            "The logical row describing an invocation of an application
  1365.            which was previously run and has terminated.  The entry
  1366.            is basically copied from the sysApplRunTable when the
  1367.            application instance terminates.  Hence, the entry's
  1368.            value for sysApplPastRunIndex is the same as its value was
  1369.            for sysApplRunIndex."
  1370.        INDEX    { sysApplInstallPkgIndex, sysApplPastRunIndex }
  1371.        ::= { sysApplPastRunTable   1 }
  1372.  
  1373.    SysApplPastRunEntry ::= SEQUENCE {
  1374.        sysApplPastRunIndex                     Unsigned32,
  1375.        sysApplPastRunStarted                   DateAndTime,
  1376.        sysApplPastRunExitState                 INTEGER,
  1377.        sysApplPastRunTimeEnded                 DateAndTime
  1378.    }
  1379.  
  1380.    sysApplPastRunIndex OBJECT-TYPE
  1381.        SYNTAX      Unsigned32 (1..'ffffffff'h)
  1382.        MAX-ACCESS  not-accessible
  1383.        STATUS      current
  1384.        DESCRIPTION
  1385.            "Part of the index for this table. An integer
  1386.            matching the value of the removed sysApplRunIndex
  1387.            corresponding to this row."
  1388.        ::= { sysApplPastRunEntry 1 }
  1389.  
  1390.    sysApplPastRunStarted OBJECT-TYPE
  1391.        SYNTAX      DateAndTime
  1392.        MAX-ACCESS  read-only
  1393.        STATUS      current
  1394.        DESCRIPTION
  1395.            "The date and time that the application was started."
  1396.        ::= { sysApplPastRunEntry 2 }
  1397.  
  1398.    sysApplPastRunExitState OBJECT-TYPE
  1399.        SYNTAX      INTEGER {
  1400.                    complete (1), -- normal exit at sysApplRunTimeEnded
  1401.                    failed (2),   -- abnormal exit
  1402.                    other (3)
  1403.                    }
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  Expires October 15, 1997                             [Page 24]
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  Internet Draft      System Application MIB      April 15, 1997
  1416.  
  1417.  
  1418.        MAX-ACCESS  read-only
  1419.        STATUS      current
  1420.        DESCRIPTION
  1421.          "The state of the application instance when it terminated."
  1422.        ::= { sysApplPastRunEntry 3 }
  1423.  
  1424.    sysApplPastRunTimeEnded OBJECT-TYPE
  1425.        SYNTAX      DateAndTime
  1426.        MAX-ACCESS  read-only
  1427.        STATUS      current
  1428.        DESCRIPTION
  1429.            "The DateAndTime the application instance was determined
  1430.            to be no longer running."
  1431.        ::= { sysApplPastRunEntry 4 }
  1432.  
  1433.    -- sysApplElmtRunTable
  1434.    -- The sysApplElmtRunTable contains an entry for each process that
  1435.    -- is currently running on the host.  An entry is created in
  1436.    -- this table for each process at the time it is started, and will
  1437.    -- remain in the table until the process terminates.
  1438.    --
  1439.    -- The table is indexed by sysApplElmtRunInstallPkg,
  1440.    -- sysApplElmtRunInvocID, and sysApplElmtRunIndex to make it easy
  1441.    -- to locate all running elements of a particular invoked application
  1442.    -- which has been installed on the system.
  1443.  
  1444.  
  1445.    sysApplElmtRunTable OBJECT-TYPE
  1446.        SYNTAX      SEQUENCE OF SysApplElmtRunEntry
  1447.        MAX-ACCESS  not-accessible
  1448.        STATUS      current
  1449.        DESCRIPTION
  1450.            "The table describes the processes which are
  1451.            currently executing on the host system. Each entry
  1452.            represents a running process and is associated with
  1453.            the invoked application of which that process is a part, if
  1454.            possible.  This table contains an entry for every process
  1455.            currently running on the system, regardless of whether its
  1456.            'parent' application can be determined.  So, for example,
  1457.            processes like 'ps' and 'grep' will have entries though they
  1458.            are not associated with an installed application package.
  1459.  
  1460.            Because a running application may involve
  1461.            more than one executable, it is possible to have
  1462.            multiple entries in this table for each application.
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  Expires October 15, 1997                             [Page 25]
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  Internet Draft      System Application MIB      April 15, 1997
  1475.  
  1476.  
  1477.            Entries are removed from this table when the process
  1478.            terminates.
  1479.  
  1480.            The table is indexed by sysApplElmtRunInstallPkg,
  1481.            sysApplElmtRunInvocID, and sysApplElmtRunIndex to
  1482.            facilitate the retrieval of all running elements of a
  1483.            particular invoked application which has been installed on
  1484.            the system."
  1485.        ::= { sysApplRun 3 }
  1486.  
  1487.    sysApplElmtRunEntry OBJECT-TYPE
  1488.        SYNTAX      SysApplElmtRunEntry
  1489.        MAX-ACCESS  not-accessible
  1490.        STATUS      current
  1491.        DESCRIPTION
  1492.            "The logical row describing a process currently
  1493.            running on this host.  When possible, the entry is
  1494.            associated with the invoked application of which it
  1495.            is a part."
  1496.        INDEX    { sysApplElmtRunInstallPkg, sysApplElmtRunInvocID,
  1497.                   sysApplElmtRunIndex }
  1498.        ::= { sysApplElmtRunTable   1 }
  1499.  
  1500.    SysApplElmtRunEntry ::= SEQUENCE {
  1501.        sysApplElmtRunInstallPkg        Unsigned32,
  1502.        sysApplElmtRunInvocID           Unsigned32,
  1503.        sysApplElmtRunIndex             Unsigned32,
  1504.        sysApplElmtRunInstallID         Unsigned32,
  1505.        sysApplElmtRunTimeStarted       DateAndTime,
  1506.        sysApplElmtRunState             RunState,
  1507.        sysApplElmtRunName              LongUtf8String,
  1508.        sysApplElmtRunParameters        Utf8String,
  1509.        sysApplElmtRunCPU               TimeTicks,
  1510.        sysApplElmtRunMemory            Gauge32,
  1511.        sysApplElmtRunNumFiles          Gauge32,
  1512.        sysApplElmtRunUser              Utf8String
  1513.    }
  1514.  
  1515.    sysApplElmtRunInstallPkg OBJECT-TYPE
  1516.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  1517.        MAX-ACCESS  not-accessible
  1518.        STATUS      current
  1519.        DESCRIPTION
  1520.            "Part of the index for this table, this value
  1521.            identifies the installed software package for
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  Expires October 15, 1997                             [Page 26]
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  Internet Draft      System Application MIB      April 15, 1997
  1534.  
  1535.  
  1536.            the application of which this process is a part.
  1537.            Provided that the process's 'parent' application can be
  1538.            determined, the value of this object is the same
  1539.            value as the sysApplInstallPkgIndex for the
  1540.            entry in the sysApplInstallPkgTable that corresponds
  1541.            to the installed application of which this process
  1542.            is a part.
  1543.  
  1544.            If, however, the 'parent' application cannot be
  1545.            determined, (for example the process is not part
  1546.            of a particular installed application), the value
  1547.            for this object is then '0', signifying that this
  1548.            process cannot be related back to an application,
  1549.            and in turn, an installed software package."
  1550.        ::= { sysApplElmtRunEntry 1 }
  1551.  
  1552.    sysApplElmtRunInvocID OBJECT-TYPE
  1553.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  1554.        MAX-ACCESS  not-accessible
  1555.        STATUS      current
  1556.        DESCRIPTION
  1557.            "Part of the index for this table, this value
  1558.            identifies the invocation of an application of which
  1559.            this process is a part.  Provided that the 'parent'
  1560.            application can be determined, the value of this object
  1561.            is the same value as the sysApplRunIndex for the
  1562.            corresponding application invocation in the
  1563.            sysApplRunTable.
  1564.  
  1565.            If, however, the 'parent' application cannot be
  1566.            determined, the value for this object is then '0',
  1567.            signifying that this process cannot be related back
  1568.            to an invocation of an application in the
  1569.            sysApplRunTable."
  1570.        ::= { sysApplElmtRunEntry 2 }
  1571.  
  1572.    sysApplElmtRunIndex OBJECT-TYPE
  1573.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  1574.        MAX-ACCESS  not-accessible
  1575.        STATUS      current
  1576.        DESCRIPTION
  1577.            "Part of the index for this table.  A unique value
  1578.            for each process running on the host.  Wherever
  1579.            possible, this should be the system's native, unique
  1580.            identification number."
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  Expires October 15, 1997                             [Page 27]
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  Internet Draft      System Application MIB      April 15, 1997
  1593.  
  1594.  
  1595.        ::= { sysApplElmtRunEntry 3 }
  1596.  
  1597.  
  1598.    sysApplElmtRunInstallID OBJECT-TYPE
  1599.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  1600.        MAX-ACCESS  read-only
  1601.        STATUS      current
  1602.        DESCRIPTION
  1603.            "The index into the sysApplInstallElmtTable. The
  1604.            value of this object is the same value as the
  1605.            sysApplInstallElmtIndex for the application element
  1606.            of which this entry represents a running instance.
  1607.            If this process cannot be associated to an installed
  1608.            executable, the value should be '0'."
  1609.        ::= { sysApplElmtRunEntry 4 }
  1610.  
  1611.    sysApplElmtRunTimeStarted OBJECT-TYPE
  1612.        SYNTAX      DateAndTime
  1613.        MAX-ACCESS  read-only
  1614.        STATUS      current
  1615.        DESCRIPTION
  1616.            "The time the process was started."
  1617.        ::= { sysApplElmtRunEntry 5 }
  1618.  
  1619.    sysApplElmtRunState OBJECT-TYPE
  1620.        SYNTAX      RunState
  1621.        MAX-ACCESS  read-only
  1622.        STATUS      current
  1623.        DESCRIPTION
  1624.            "The current state of the running process. The
  1625.            possible values are running(1), runnable(2) but waiting
  1626.            for a resource such as CPU, waiting(3) for an event,
  1627.            exiting(4), or other(5)."
  1628.        ::= { sysApplElmtRunEntry 6 }
  1629.  
  1630.    sysApplElmtRunName OBJECT-TYPE
  1631.        SYNTAX      LongUtf8String
  1632.        MAX-ACCESS  read-only
  1633.        STATUS      current
  1634.        DESCRIPTION
  1635.            "The full path and filename of the process.
  1636.            For example, '/opt/MYYpkg/bin/myyproc' would
  1637.            be returned for process 'myyproc' whose execution
  1638.            path is '/opt/MYYpkg/bin/myyproc'."
  1639.        ::= { sysApplElmtRunEntry 7 }
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  Expires October 15, 1997                             [Page 28]
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  Internet Draft      System Application MIB      April 15, 1997
  1652.  
  1653.  
  1654.  
  1655.    sysApplElmtRunParameters OBJECT-TYPE
  1656.        SYNTAX      Utf8String
  1657.        MAX-ACCESS  read-only
  1658.        STATUS      current
  1659.        DESCRIPTION
  1660.            "The starting parameters for the process."
  1661.    ::= { sysApplElmtRunEntry 8 }
  1662.  
  1663.    sysApplElmtRunCPU OBJECT-TYPE
  1664.        SYNTAX      TimeTicks
  1665.        MAX-ACCESS  read-only
  1666.        STATUS      current
  1667.        DESCRIPTION
  1668.             "The number of centi-seconds of the total system's
  1669.             CPU resources consumed by this process.  Note that
  1670.             on a multi-processor system, this value may
  1671.             have been incremented by more than one centi-second
  1672.             in one centi-second of real (wall clock) time."
  1673.        ::= { sysApplElmtRunEntry 9 }
  1674.  
  1675.    sysApplElmtRunMemory OBJECT-TYPE
  1676.        SYNTAX      Gauge32
  1677.        UNITS       "Kbytes"
  1678.        MAX-ACCESS  read-only
  1679.        STATUS      current
  1680.        DESCRIPTION
  1681.            "The total amount of real system memory measured in
  1682.            Kbytes currently allocated to this process."
  1683.        ::= { sysApplElmtRunEntry 10 }
  1684.  
  1685.    sysApplElmtRunNumFiles OBJECT-TYPE
  1686.        SYNTAX      Gauge32
  1687.        MAX-ACCESS  read-only
  1688.        STATUS      current
  1689.        DESCRIPTION
  1690.            "The number of files currently open by the
  1691.            process.  Transport connections (sockets)
  1692.            should NOT be included in the calculation of
  1693.            this value."
  1694.        ::= { sysApplElmtRunEntry 11 }
  1695.  
  1696.    sysApplElmtRunUser OBJECT-TYPE
  1697.        SYNTAX      Utf8String
  1698.        MAX-ACCESS  read-only
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  Expires October 15, 1997                             [Page 29]
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  Internet Draft      System Application MIB      April 15, 1997
  1711.  
  1712.  
  1713.        STATUS      current
  1714.        DESCRIPTION
  1715.            "The process owner's login name (e.g. root)."
  1716.        ::= { sysApplElmtRunEntry 12 }
  1717.  
  1718.    -- sysApplElmtPastRunTable
  1719.    -- The sysApplElmtPastRunTable maintains a history of
  1720.    -- processes which have previously executed on
  1721.    -- the host as part of an application. Upon termination
  1722.    -- of a process, the entry representing the process is removed from
  1723.    -- the sysApplElmtRunTable and a corresponding entry is created in
  1724.    -- this table provided that the process was part of an
  1725.    -- identifiable application.  If the process could not be associated
  1726.    -- with an invoked application, no corresponding entry is created.
  1727.    -- Hence, whereas the sysApplElmtRunTable contains an entry for
  1728.    -- every process currently executing on the system, the
  1729.    -- sysApplElmtPastRunTable only contains entries for processes
  1730.    -- that previously executed as part of an invoked application.
  1731.    --
  1732.    -- Entries remain in this table until they are aged out when
  1733.    -- either the number of entries in the table reaches a
  1734.    -- maximum as determined by sysApplElmtPastRunMaxRows, or
  1735.    -- when an entry has aged to exceed a time limit as set by
  1736.    -- sysApplElmtPastRunTblTimeLimit.  When aging out entries,
  1737.    -- the oldest entry, as determined by the value of
  1738.    -- sysApplElmtPastRunTimeEnded, will be removed first.
  1739.    --
  1740.    -- The table is indexed by sysApplInstallPkgIndex (from the
  1741.    -- sysApplInstallPkgTable), sysApplElmtPastRunInvocID, and
  1742.    -- sysApplElmtPastRunIndex to make it easy to locate all
  1743.    -- previously executed processes of a particular invoked application
  1744.    -- that has been installed on the system.
  1745.  
  1746.  
  1747.    sysApplElmtPastRunTable OBJECT-TYPE
  1748.        SYNTAX      SEQUENCE OF SysApplElmtPastRunEntry
  1749.        MAX-ACCESS  not-accessible
  1750.        STATUS      current
  1751.        DESCRIPTION
  1752.            "The table describes the processes which have previously
  1753.            executed on the host system as part of an application.
  1754.            Each entry represents a process which has previously
  1755.            executed and is associated with the invoked application
  1756.            of which it was a part.  Because an invoked application
  1757.            may involve more than one executable, it is possible
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  Expires October 15, 1997                             [Page 30]
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  Internet Draft      System Application MIB      April 15, 1997
  1770.  
  1771.  
  1772.            to have multiple entries in this table for
  1773.            each application invocation. Entries are added
  1774.            to this table when the corresponding process in the
  1775.            sysApplElmtRun Table terminates.
  1776.  
  1777.            Entries remain in this table until they are aged out when
  1778.            either the number of entries in the table reaches a
  1779.            maximum as determined by sysApplElmtPastRunMaxRows, or
  1780.            when an entry has aged to exceed a time limit as set by
  1781.            sysApplElmtPastRunTblTimeLimit.  When aging out entries,
  1782.            the oldest entry, as determined by the value of
  1783.            sysApplElmtPastRunTimeEnded, will be removed first.
  1784.  
  1785.            The table is indexed by sysApplInstallPkgIndex (from the
  1786.            sysApplInstallPkgTable), sysApplElmtPastRunInvocID,
  1787.            and sysApplElmtPastRunIndex to make it easy to locate all
  1788.            previously executed processes of a particular invoked
  1789.            application that has been installed on the system."
  1790.        ::= { sysApplRun 4 }
  1791.  
  1792.    sysApplElmtPastRunEntry OBJECT-TYPE
  1793.        SYNTAX      SysApplElmtPastRunEntry
  1794.        MAX-ACCESS  not-accessible
  1795.        STATUS      current
  1796.        DESCRIPTION
  1797.            "The logical row describing a process which was
  1798.            previously executed on this host as part of an
  1799.            installed application.  The entry is basically copied
  1800.            from the sysApplElmtRunTable when the process
  1801.            terminates.  Hence, the entry's value for
  1802.            sysApplElmtPastRunIndex is the same as its value
  1803.            was for sysApplElmtRunIndex.  Note carefully: only those
  1804.            processes which could be associated with an
  1805.            identified application are included in this table."
  1806.        INDEX    { sysApplInstallPkgIndex, sysApplElmtPastRunInvocID,
  1807.                   sysApplElmtPastRunIndex }
  1808.        ::= { sysApplElmtPastRunTable   1 }
  1809.  
  1810.    SysApplElmtPastRunEntry ::= SEQUENCE {
  1811.        sysApplElmtPastRunInvocID           Unsigned32,
  1812.        sysApplElmtPastRunIndex             Unsigned32,
  1813.        sysApplElmtPastRunInstallID         Unsigned32,
  1814.        sysApplElmtPastRunTimeStarted       DateAndTime,
  1815.        sysApplElmtPastRunTimeEnded         DateAndTime,
  1816.        sysApplElmtPastRunExitState         INTEGER,
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  Expires October 15, 1997                             [Page 31]
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  Internet Draft      System Application MIB      April 15, 1997
  1829.  
  1830.  
  1831.        sysApplElmtPastRunName              LongUtf8String,
  1832.        sysApplElmtPastRunParameters        Utf8String,
  1833.        sysApplElmtPastRunCPU               TimeTicks,
  1834.        sysApplElmtPastRunMemory            Unsigned32,
  1835.        sysApplElmtPastRunNumFiles          Unsigned32,
  1836.        sysApplElmtPastRunUser              Utf8String
  1837.    }
  1838.  
  1839.    sysApplElmtPastRunInvocID OBJECT-TYPE
  1840.        SYNTAX      Unsigned32 (1..'ffffffff'h)
  1841.        MAX-ACCESS  not-accessible
  1842.        STATUS      current
  1843.        DESCRIPTION
  1844.            "Part of the index for this table, this value
  1845.            identifies the invocation of an application of which
  1846.            the process represented by this entry was a part.
  1847.            The value of this object is the same value as the
  1848.            sysApplRunIndex for the corresponding application
  1849.            invocation in the sysApplRunTable.  If the invoked
  1850.            application as a whole has terminated, it will be the
  1851.            same as the sysApplPastRunIndex."
  1852.        ::= { sysApplElmtPastRunEntry 1 }
  1853.  
  1854.    sysApplElmtPastRunIndex OBJECT-TYPE
  1855.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  1856.        MAX-ACCESS  not-accessible
  1857.        STATUS      current
  1858.        DESCRIPTION
  1859.            "Part of the index for this table. An integer
  1860.            assigned by the agent equal to the corresponding
  1861.            sysApplElmtRunIndex which was removed from the
  1862.            sysApplElmtRunTable and moved to this table
  1863.            when the element terminated.
  1864.  
  1865.            Note: entries in this table are indexed by
  1866.            sysApplElmtPastRunInvocID, sysApplElmtPastRunIndex.
  1867.            The possibility exists, though unlikely, of a
  1868.            collision occurring by a new entry which was run
  1869.            by the same invoked application (InvocID), and
  1870.            was assigned the same process identification number
  1871.            (ElmtRunIndex) as an element which was previously
  1872.            run by the same invoked application.
  1873.  
  1874.            Should this situation occur, the new entry replaces
  1875.            the old entry.
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  Expires October 15, 1997                             [Page 32]
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  Internet Draft      System Application MIB      April 15, 1997
  1888.  
  1889.  
  1890.  
  1891.            See Section: 'Implementation Issues - sysApplElmtPastRunTable
  1892.            Entry Collisions' for the conditions that would have to occur
  1893.            in order for a collision to occur."
  1894.        ::= { sysApplElmtPastRunEntry 2 }
  1895.  
  1896.  
  1897.    sysApplElmtPastRunInstallID OBJECT-TYPE
  1898.        SYNTAX      Unsigned32 (1..'ffffffff'h)
  1899.        MAX-ACCESS  read-only
  1900.        STATUS      current
  1901.        DESCRIPTION
  1902.            "The index into the installed element table. The
  1903.            value of this object is the same value as the
  1904.            sysApplInstallElmtIndex for the application element
  1905.            of which this entry represents a previously executed
  1906.            process."
  1907.        ::= { sysApplElmtPastRunEntry 3 }
  1908.  
  1909.    sysApplElmtPastRunTimeStarted OBJECT-TYPE
  1910.        SYNTAX      DateAndTime
  1911.        MAX-ACCESS  read-only
  1912.        STATUS      current
  1913.        DESCRIPTION
  1914.            "The time the process was started."
  1915.        ::= { sysApplElmtPastRunEntry 4 }
  1916.  
  1917.    sysApplElmtPastRunTimeEnded OBJECT-TYPE
  1918.        SYNTAX      DateAndTime
  1919.        MAX-ACCESS  read-only
  1920.        STATUS      current
  1921.        DESCRIPTION
  1922.            "The time the process ended."
  1923.        ::= { sysApplElmtPastRunEntry 5 }
  1924.  
  1925.    sysApplElmtPastRunExitState OBJECT-TYPE
  1926.        SYNTAX      INTEGER {
  1927.                    completed (1),
  1928.                    failed (2),
  1929.                    other (3)
  1930.                    }
  1931.        MAX-ACCESS  read-only
  1932.        STATUS      current
  1933.        DESCRIPTION
  1934.            "The state of the process when it exited."
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  Expires October 15, 1997                             [Page 33]
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  Internet Draft      System Application MIB      April 15, 1997
  1947.  
  1948.  
  1949.        ::= { sysApplElmtPastRunEntry 6 }
  1950.  
  1951.    sysApplElmtPastRunName OBJECT-TYPE
  1952.        SYNTAX      LongUtf8String
  1953.        MAX-ACCESS  read-only
  1954.        STATUS      current
  1955.        DESCRIPTION
  1956.            "The full path and filename of the process.
  1957.            For example, '/opt/MYYpkg/bin/myyproc' would
  1958.            be returned for process 'myyproc' whose execution
  1959.            path was '/opt/MYYpkg/bin/myyproc'."
  1960.        ::= { sysApplElmtPastRunEntry 7 }
  1961.  
  1962.    sysApplElmtPastRunParameters OBJECT-TYPE
  1963.        SYNTAX      Utf8String
  1964.        MAX-ACCESS  read-only
  1965.        STATUS      current
  1966.        DESCRIPTION
  1967.            "The starting parameters for the process."
  1968.        ::= { sysApplElmtPastRunEntry 8 }
  1969.  
  1970.    sysApplElmtPastRunCPU OBJECT-TYPE
  1971.        SYNTAX      TimeTicks
  1972.        MAX-ACCESS  read-only
  1973.        STATUS      current
  1974.        DESCRIPTION
  1975.             "The last known number of centi-seconds of the total
  1976.             system's CPU resources consumed by this process.
  1977.             Note that on a multi-processor system, this value may
  1978.             increment by more than one centi-second in one
  1979.             centi-second of real (wall clock) time."
  1980.        ::= { sysApplElmtPastRunEntry 9 }
  1981.  
  1982.    sysApplElmtPastRunMemory OBJECT-TYPE
  1983.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  1984.        UNITS       "Kbytes"
  1985.        MAX-ACCESS  read-only
  1986.        STATUS      current
  1987.        DESCRIPTION
  1988.            "The last known total amount of real system memory
  1989.            measured in Kbytes allocated to this process before it
  1990.            terminated."
  1991.        ::= { sysApplElmtPastRunEntry 10 }
  1992.  
  1993.    sysApplElmtPastRunNumFiles OBJECT-TYPE
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  Expires October 15, 1997                             [Page 34]
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  Internet Draft      System Application MIB      April 15, 1997
  2006.  
  2007.  
  2008.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  2009.        MAX-ACCESS  read-only
  2010.        STATUS      current
  2011.        DESCRIPTION
  2012.            "The last known number of files open by the
  2013.            process before it terminated.  Transport
  2014.            connections (sockets) should NOT be included in
  2015.            the calculation of this value."
  2016.        ::= { sysApplElmtPastRunEntry 11 }
  2017.  
  2018.    sysApplElmtPastRunUser OBJECT-TYPE
  2019.        SYNTAX      Utf8String
  2020.        MAX-ACCESS  read-only
  2021.        STATUS      current
  2022.        DESCRIPTION
  2023.            "The process owner's login name (e.g. root)."
  2024.        ::= { sysApplElmtPastRunEntry 12 }
  2025.  
  2026.  
  2027.    -- Additional Scalar objects to control table sizes
  2028.  
  2029.    sysApplPastRunMaxRows OBJECT-TYPE
  2030.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  2031.        MAX-ACCESS  read-write
  2032.        STATUS      current
  2033.        DESCRIPTION
  2034.            "The maximum number of entries allowed in the
  2035.            sysApplPastRunTable.  Once the number of rows in
  2036.            the sysApplPastRunTable reaches this value, the
  2037.            management subsystem will remove the oldest entry
  2038.            in the table to make room for the new entry to be added.
  2039.            Entries will be removed on the basis of oldest
  2040.            sysApplPastRunTimeEnded value first.
  2041.  
  2042.            This object may be used to control the amount of
  2043.            system resources that can used for sysApplPastRunTable
  2044.            entries. A conforming implementation should attempt
  2045.            to support the default value, however, a lesser value
  2046.            may be necessary due to implementation-dependent issues
  2047.            and resource availability."
  2048.        DEFVAL      { 500 }
  2049.        ::= { sysApplRun 5 }
  2050.  
  2051.    sysApplPastRunTableRemItems OBJECT-TYPE
  2052.        SYNTAX      Counter32
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  Expires October 15, 1997                             [Page 35]
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  Internet Draft      System Application MIB      April 15, 1997
  2065.  
  2066.  
  2067.        MAX-ACCESS  read-only
  2068.        STATUS      current
  2069.        DESCRIPTION
  2070.            "A counter of the number of entries removed from
  2071.            the sysApplPastRunTable because of table size limitations
  2072.            as set in sysApplPastRunMaxRows.  This counter is the
  2073.            number of entries the management subsystem has had to
  2074.            remove in order to make room for new entries (so as not
  2075.            to exceed the limit set by sysApplPastRunMaxRows) since
  2076.            the last initialization of the management subsystem."
  2077.        ::= { sysApplRun 6 }
  2078.  
  2079.    sysApplPastRunTblTimeLimit OBJECT-TYPE
  2080.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  2081.        UNITS       "seconds"
  2082.        MAX-ACCESS  read-write
  2083.        STATUS      current
  2084.        DESCRIPTION
  2085.            "The maximum time in seconds which an entry in the
  2086.             sysApplPastRunTable may exist before it is removed.
  2087.             Any entry that is older than this value will be
  2088.             removed (aged out) from the table.
  2089.  
  2090.             Note that an entry may be aged out prior to reaching
  2091.             this time limit if it is the oldest entry in the
  2092.             table and must be removed to make space for a new
  2093.             entry so as to not exceed sysApplPastRunMaxRows."
  2094.        DEFVAL      { 7200 }
  2095.        ::= { sysApplRun 7 }
  2096.  
  2097.    sysApplElemPastRunMaxRows OBJECT-TYPE
  2098.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  2099.        MAX-ACCESS  read-write
  2100.        STATUS      current
  2101.        DESCRIPTION
  2102.            "The maximum number of entries allowed in the
  2103.            sysApplElmtPastRunTable.  Once the number of rows in
  2104.            the sysApplElmtPastRunTable reaches this value,
  2105.            the management subsystem will remove the oldest entry
  2106.            to make room for the new entry to be added.  Entries
  2107.            will be removed on the basis of oldest
  2108.            sysApplElmtPastRunTimeEnded value first.
  2109.  
  2110.            This object may be used to control the amount of
  2111.            system resources that can used for sysApplElemPastRunTable
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  Expires October 15, 1997                             [Page 36]
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  Internet Draft      System Application MIB      April 15, 1997
  2124.  
  2125.  
  2126.            entries. A conforming implementation should attempt
  2127.            to support the default value, however, a lesser value
  2128.            may be necessary due to implementation-dependent issues
  2129.            and resource availability."
  2130.        DEFVAL      { 500 }
  2131.        ::= { sysApplRun 8 }
  2132.  
  2133.    sysApplElemPastRunTableRemItems OBJECT-TYPE
  2134.        SYNTAX      Counter32
  2135.        MAX-ACCESS  read-only
  2136.        STATUS      current
  2137.        DESCRIPTION
  2138.            "A counter of the number of entries removed from the
  2139.            sysApplElemPastRunTable because of table size limitations
  2140.            as set in sysApplElemPastRunMaxRows.  This counter is the
  2141.            number of entries the management subsystem has had to
  2142.            remove in order to make room for new entries (so as not
  2143.            to exceed the limit set by sysApplElemPastRunMaxRows) since
  2144.            the last initialization of the management subsystem."
  2145.        ::= { sysApplRun 9 }
  2146.  
  2147.    sysApplElemPastRunTblTimeLimit OBJECT-TYPE
  2148.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  2149.        UNITS       "seconds"
  2150.        MAX-ACCESS  read-write
  2151.        STATUS      current
  2152.        DESCRIPTION
  2153.            "The maximum time in seconds which an entry in the
  2154.             sysApplElemPastRunTable may exist before it is removed.
  2155.             Any entry that is older than this value will be
  2156.             removed (aged out) from the table.
  2157.  
  2158.             Note that an entry may be aged out prior to reaching
  2159.             this time limit if it is the oldest entry in the
  2160.             table and must be removed to make space for a new
  2161.             entry so as to not exceed sysApplElemPastRunMaxRows."
  2162.        DEFVAL      { 7200 }
  2163.        ::= { sysApplRun 10 }
  2164.  
  2165.    sysApplAgentPollInterval  OBJECT-TYPE
  2166.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  2167.        UNITS       "seconds"
  2168.        MAX-ACCESS  read-write
  2169.        STATUS      current
  2170.        DESCRIPTION
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  Expires October 15, 1997                             [Page 37]
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  Internet Draft      System Application MIB      April 15, 1997
  2183.  
  2184.  
  2185.            "The minimum interval in seconds that the management
  2186.            subsystem implementing this MIB will poll the status
  2187.            of the managed resources. Because of the non-trivial
  2188.            effort involved in polling the managed resources,
  2189.            and because the method for obtaining the status of
  2190.            the managed resources is implementation-dependent,
  2191.            a conformant implementation may chose a lower bound
  2192.            greater than 0.
  2193.  
  2194.            A value of 0 indicates that there is no delay
  2195.            in the passing of information from the managed
  2196.            resources to the agent."
  2197.        DEFVAL      { 60 }
  2198.        ::= { sysApplRun 11 }
  2199.  
  2200.  
  2201.    -- sysApplMap Group
  2202.    -- This group contains a table, the sysApplMapTable,
  2203.    -- whose sole purpose is to provide a 'backwards'
  2204.    -- mapping so that, given a known sysApplElmtRunIndex
  2205.    -- (process identification number), the corresponding invoked
  2206.    -- application (sysApplRunIndex), installed element
  2207.    -- (sysApplInstallElmtIndex), and installed application
  2208.    -- package (sysApplInstallPkgIndex) can be quickly determined.
  2209.    --
  2210.    -- The table will contain one entry for each process
  2211.    -- currently running on the system.
  2212.    --
  2213.    -- A backwards mapping is extremely useful since the tables
  2214.    -- in this MIB module are typically indexed with the
  2215.    -- installed application package (sysApplInstallPkgIndex)
  2216.    -- as the primary key, and on down as required by the
  2217.    -- specific table, with the process ID number (sysApplElmtRunIndex)
  2218.    -- being the least significant key.
  2219.    --
  2220.    -- It is expected that management applications will use
  2221.    -- this mapping table by doing a 'GetNext' operation with
  2222.    -- the known process ID number (sysApplElmtRunIndex) as the partial
  2223.    -- instance identifier.  Assuming that there is an entry for
  2224.    -- the process, the result should return a single columnar value,
  2225.    -- the sysApplMapInstallPkgIndex, with the sysApplElmtRunIndex,
  2226.    -- sysApplRunIndex, and sysApplInstallElmtIndex contained in the
  2227.    -- instance identifier for the returned MIB object value.
  2228.    --
  2229.    -- NOTE: if the process can not be associated back to an
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  Expires October 15, 1997                             [Page 38]
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  Internet Draft      System Application MIB      April 15, 1997
  2242.  
  2243.  
  2244.    -- invoked application installed on the system, than the
  2245.    -- value returned for the columnar value sysApplMapInstallPkgIndex
  2246.    -- will be '0' and the instance portion of the object-identifier
  2247.    -- will be the process ID number (sysApplElmtRunIndex) followed
  2248.    -- by 0.0.
  2249.  
  2250.    sysApplMapTable OBJECT-TYPE
  2251.        SYNTAX      SEQUENCE OF SysApplMapEntry
  2252.        MAX-ACCESS  not-accessible
  2253.        STATUS      current
  2254.        DESCRIPTION
  2255.            "The sole purpose of this table is to provide a
  2256.            'backwards' mapping so that, given a known
  2257.            sysApplElmtRunIndex (process identification number),
  2258.            the corresponding invoked application (sysApplRunIndex),
  2259.            installed element (sysApplInstallElmtIndex), and
  2260.            installed application package (sysApplInstallPkgIndex)
  2261.            can be quickly determined.
  2262.  
  2263.            This table will contain one entry for each process
  2264.            that is currently executing on the system.
  2265.  
  2266.            It is expected that management applications will use
  2267.            this mapping table by doing a 'GetNext' operation with
  2268.            the known process ID number (sysApplElmtRunIndex) as the
  2269.            partial instance identifier.  Assuming that there is an
  2270.            entry for the process, the result should return a single
  2271.            columnar value, the sysApplMapInstallPkgIndex, with the
  2272.            sysApplElmtRunIndex, sysApplRunIndex, and
  2273.            sysApplInstallElmtIndex contained in the instance identifier
  2274.            for the returned MIB object value.
  2275.  
  2276.            NOTE: if the process can not be associated back to an
  2277.            invoked application installed on the system, than the
  2278.            value returned for the columnar value
  2279.            sysApplMapInstallPkgIndex will be '0' and the instance
  2280.            portion of the object-identifier will be the process ID
  2281.            number (sysApplElmtRunIndex) followed by 0.0."
  2282.        ::= { sysApplMap 1 }
  2283.  
  2284.    sysApplMapEntry OBJECT-TYPE
  2285.        SYNTAX      SysApplMapEntry
  2286.        MAX-ACCESS  not-accessible
  2287.        STATUS      current
  2288.        DESCRIPTION
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  Expires October 15, 1997                             [Page 39]
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  Internet Draft      System Application MIB      April 15, 1997
  2301.  
  2302.  
  2303.            "A logical row representing a process currently running
  2304.             on the system.  This entry provides the index mapping from
  2305.             process identifier, back to the invoked application,
  2306.             installed element, and finally, the installed application
  2307.             package.  The entry includes only one accessible columnar
  2308.             object, the sysApplMapInstallPkgIndex, but the
  2309.             invoked application and installed element can be
  2310.             determined from the instance identifier since they form
  2311.             part of the index clause."
  2312.        INDEX  { sysApplElmtRunIndex, sysApplElmtRunInvocID,
  2313.                 sysApplMapInstallElmtIndex }
  2314.        ::= { sysApplMapTable 1 }
  2315.  
  2316.    SysApplMapEntry ::= SEQUENCE {
  2317.        sysApplMapInstallElmtIndex    Unsigned32,
  2318.        sysApplMapInstallPkgIndex     Unsigned32
  2319.    }
  2320.  
  2321.    sysApplMapInstallElmtIndex OBJECT-TYPE
  2322.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  2323.        MAX-ACCESS  not-accessible
  2324.        STATUS      current
  2325.        DESCRIPTION
  2326.            "The index into the sysApplInstallElmtTable. The
  2327.            value of this object is the same value as the
  2328.            sysApplInstallElmtIndex for the application element
  2329.            of which this entry represents a running instance.
  2330.            If this process cannot be associated to an installed
  2331.            executable, the value should be '0'."
  2332.        ::= { sysApplMapEntry 1 }
  2333.  
  2334.    sysApplMapInstallPkgIndex OBJECT-TYPE
  2335.        SYNTAX      Unsigned32 (0..'ffffffff'h)
  2336.        MAX-ACCESS  read-only
  2337.        STATUS      current
  2338.        DESCRIPTION
  2339.            "The value of this object identifies the installed
  2340.            software package for the application of which this
  2341.            process is a part.  Provided that the process's 'parent'
  2342.            application can be determined, the value of this object
  2343.            is the same value as the sysApplInstallPkgIndex for the
  2344.            entry in the sysApplInstallPkgTable that corresponds
  2345.            to the installed application of which this process
  2346.            is a part.
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  Expires October 15, 1997                             [Page 40]
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  Internet Draft      System Application MIB      April 15, 1997
  2360.  
  2361.  
  2362.            If, however, the 'parent' application cannot be
  2363.            determined, (for example the process is not part
  2364.            of a particular installed application), the value
  2365.            for this object is then '0', signifying that this
  2366.            process cannot be related back to an application,
  2367.            and in turn, an installed software package."
  2368.        ::= { sysApplMapEntry 2 }
  2369.  
  2370.  
  2371.    -- Conformance Macros
  2372.  
  2373.    sysApplMIBCompliances  OBJECT IDENTIFIER ::= { sysApplConformance 1 }
  2374.    sysApplMIBGroups       OBJECT IDENTIFIER ::= { sysApplConformance 2 }
  2375.  
  2376.    sysApplMIBCompliance MODULE-COMPLIANCE
  2377.        STATUS  current
  2378.        DESCRIPTION
  2379.            "Describes the requirements for conformance to
  2380.            the System Application MIB"
  2381.        MODULE  -- this module
  2382.            MANDATORY-GROUPS { sysApplInstalledGroup,
  2383.                               sysApplRunGroup, sysApplMapGroup }
  2384.        ::= { sysApplMIBCompliances 1 }
  2385.  
  2386.    sysApplInstalledGroup OBJECT-GROUP
  2387.        OBJECTS { sysApplInstallPkgManufacturer,
  2388.                  sysApplInstallPkgProductName,
  2389.                  sysApplInstallPkgVersion,
  2390.                  sysApplInstallPkgSerialNumber,
  2391.                  sysApplInstallPkgDate,
  2392.                  sysApplInstallPkgLocation,
  2393.                  sysApplInstallElmtName,
  2394.                  sysApplInstallElmtType,
  2395.                  sysApplInstallElmtDate,
  2396.                  sysApplInstallElmtPath,
  2397.                  sysApplInstallElmtSizeHigh,
  2398.                  sysApplInstallElmtSizeLow,
  2399.                  sysApplInstallElmtRole,
  2400.                  sysApplInstallElmtModifyDate,
  2401.                  sysApplInstallElmtCurSizeHigh,
  2402.                  sysApplInstallElmtCurSizeLow }
  2403.        STATUS  current
  2404.        DESCRIPTION
  2405.            "The system application installed group contains
  2406.            information about applications and their constituent
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  Expires October 15, 1997                             [Page 41]
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  Internet Draft      System Application MIB      April 15, 1997
  2419.  
  2420.  
  2421.            components which have been installed on the host system."
  2422.        ::= { sysApplMIBGroups 1 }
  2423.  
  2424.    sysApplRunGroup OBJECT-GROUP
  2425.        OBJECTS { sysApplRunStarted,
  2426.                  sysApplRunCurrentState,
  2427.                  sysApplPastRunStarted,
  2428.                  sysApplPastRunExitState,
  2429.                  sysApplPastRunTimeEnded,
  2430.                  sysApplElmtRunInstallID,
  2431.                  sysApplElmtRunTimeStarted,
  2432.                  sysApplElmtRunState,
  2433.                  sysApplElmtRunName,
  2434.                  sysApplElmtRunParameters,
  2435.                  sysApplElmtRunCPU,
  2436.                  sysApplElmtRunMemory,
  2437.                  sysApplElmtRunNumFiles,
  2438.                  sysApplElmtRunUser,
  2439.                  sysApplElmtPastRunInstallID,
  2440.                  sysApplElmtPastRunTimeStarted,
  2441.                  sysApplElmtPastRunTimeEnded,
  2442.                  sysApplElmtPastRunExitState,
  2443.                  sysApplElmtPastRunName,
  2444.                  sysApplElmtPastRunParameters,
  2445.                  sysApplElmtPastRunCPU,
  2446.                  sysApplElmtPastRunMemory,
  2447.                  sysApplElmtPastRunNumFiles,
  2448.                  sysApplElmtPastRunUser,
  2449.                  sysApplPastRunMaxRows,
  2450.                  sysApplPastRunTableRemItems,
  2451.                  sysApplPastRunTblTimeLimit,
  2452.                  sysApplElemPastRunMaxRows,
  2453.                  sysApplElemPastRunTableRemItems,
  2454.                  sysApplElemPastRunTblTimeLimit,
  2455.                  sysApplAgentPollInterval }
  2456.        STATUS  current
  2457.        DESCRIPTION
  2458.            "The system application run group contains information
  2459.            about applications and associated elements which have
  2460.            run or are currently running on the host system."
  2461.        ::= { sysApplMIBGroups 2 }
  2462.  
  2463.    sysApplMapGroup OBJECT-GROUP
  2464.        OBJECTS { sysApplMapInstallPkgIndex }
  2465.        STATUS  current
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  Expires October 15, 1997                             [Page 42]
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  Internet Draft      System Application MIB      April 15, 1997
  2478.  
  2479.  
  2480.        DESCRIPTION
  2481.            "The Map Group contains a single table, sysApplMapTable,
  2482.            that provides a backwards mapping for determining the
  2483.            invoked application, installed element, and installed
  2484.            application package given a known process identification
  2485.            number."
  2486.    ::= { sysApplMIBGroups 3 }
  2487.  
  2488.    END
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  7.  Implementation Issues
  2495.  
  2496.  This section discusses implementation issues that are
  2497.  important for both an agent developer, and a management
  2498.  application developer or user to understand with regards to
  2499.  this MIB module.  Although this section does not attempt to
  2500.  prescribe a particular implementation strategy, it does
  2501.  attempt to recognize some of the real world limitations that
  2502.  could effect an implementation of this MIB module.
  2503.  
  2504.  
  2505.  7.1.  Implementation with Polling Agents
  2506.  
  2507.  Implementations of the System Application MIB on popular
  2508.  operating systems might require some considerable processing
  2509.  power to obtain status information from the managed resources.
  2510.  It might also be difficult to determine when an application or
  2511.  a process starts or finishes. Implementors of this MIB might
  2512.  therefore choose an implementation approach where the agent
  2513.  polls the managed resources at regular intervals. The
  2514.  information retrieved by every poll is used to update a cached
  2515.  version of this MIB maintained inside of the agent. SNMP
  2516.  request are processed based on the information found in this
  2517.  MIB cache.
  2518.  
  2519.  A scalar sysApplAgentPollInterval is defined to give the
  2520.  manager control over the polling frequency. There is a trade-
  2521.  off between the amount of resources consumed during every poll
  2522.  to update the MIB cache, and the accuracy of the information
  2523.  provided by the System Application MIB agent. A default value
  2524.  of 60 seconds is defined to keep the processing overhead low,
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  Expires October 15, 1997                             [Page 43]
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  Internet Draft      System Application MIB      April 15, 1997
  2537.  
  2538.  
  2539.  while providing usable information for long-lived processes. A
  2540.  manager is expected to adjust this value if more accurate
  2541.  information about short-lived applications or processes is
  2542.  needed, or if the amount of resources consumed by the agent is
  2543.  too high.
  2544.  
  2545.  
  2546.  7.2.  sysApplElmtPastRunTable Entry Collisions
  2547.  
  2548.  The sysApplElmtPastRunTable maintains a history of processes
  2549.  which have previously executed on the host as part of an
  2550.  application.  Information is moved from the
  2551.  sysApplElmtRunTable to this PastRun table when the process
  2552.  represented by the entry terminates.
  2553.  
  2554.  The sysApplElmtPastRunTable is indexed by the tuple,
  2555.  (sysApplElmtPastRunInvocID, sysApplElmtPastRunIndex), where
  2556.  the first part identifies the application invocation of which
  2557.  the process was a part, and the second part identifies the
  2558.  process itself.
  2559.  
  2560.  Recall that the sysApplElmtRunIndex represents the system's
  2561.  unique identification number assigned to a running process and
  2562.  that this value is mapped to sysApplElmtPastRunIndex when the
  2563.  process terminates and the entry's information is moved from
  2564.  the sysApplElmtRunTable to the sysApplElmtPastRunTable.  Many
  2565.  systems re-use process ID numbers which are no longer assigned
  2566.  to running processes; typically, the process numbers wrap and
  2567.  the next available process number is used.
  2568.  
  2569.  It is therefore possible for two entries in the
  2570.  sysApplElmtPastRun Table to have the same value for
  2571.  sysApplElmtPastRunIndex.  For this reason, entries in the
  2572.  ElmtPastRun table are indexed by the tuple
  2573.  sysApplElmtPastRunInvocID, sysApplElmtPastRunIndex to reduce
  2574.  the chance of a collision by two past run elements with the
  2575.  same sysApplElmtPastRunIndex.
  2576.  
  2577.  However, it is still possible, though unlikely, for a
  2578.  collision to occur if the following happens:
  2579.  
  2580.  
  2581.  1)   the invoked application (identified by InvocID), has an
  2582.       element which runs, terminates, and is moved into the
  2583.       sysApplElmtPastRun table (index: InvocID, RunIndex)
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  Expires October 15, 1997                             [Page 44]
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  Internet Draft      System Application MIB      April 15, 1997
  2596.  
  2597.  
  2598.  2)   the numbers used for the system's process identification
  2599.       numbering wrap
  2600.  
  2601.  
  2602.  3)   that same invoked application (same InvocID), has another
  2603.       element process run, AND that process is assigned the
  2604.       same identification number as one of the processes
  2605.       previously run by that invoked application (same
  2606.       RunIndex), and finally,
  2607.  
  2608.  
  2609.  4)   that element process terminates and is moved to the
  2610.       sysApplElmtPastRun table prior to the old, duplicate
  2611.       (InvocID, RunIndex) entry being aged out of the table by
  2612.       settings defined for sysApplElmtPastRunMaxRows and
  2613.       sysApplElmtPastRunTblTimeLimit.
  2614.  
  2615.  
  2616.  
  2617.  In the event that a collision occurs, the new entry will
  2618.  replace the old entry.
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  8.  Security Considerations
  2626.  
  2627.  In order to implement this MIB, an agent must make certain
  2628.  management information available about various logical and
  2629.  physical entities within a managed system which may be
  2630.  considered sensitive in some network environments.
  2631.  
  2632.  Therefore, a network administrator may wish to employ
  2633.  instance-level access control, and configure the access
  2634.  mechanism (i.e., community strings in SNMPv1 and SNMPv2C),
  2635.  such that certain instances within this MIB are excluded from
  2636.  particular MIB views.
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  Expires October 15, 1997                             [Page 45]
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  Internet Draft      System Application MIB      April 15, 1997
  2655.  
  2656.  
  2657.  9.  Acknowledgements
  2658.  
  2659.  This document was produced by the Application MIB working
  2660.  group.  Special acknowledgement is made to:
  2661.  
  2662.       Rick Sturm
  2663.       Enterprise Management Professional Services, Inc.
  2664.       sturm@emi-summit.com
  2665.       For hosting the working group mailing list, and for his
  2666.       participation in the development of the initial draft.
  2667.  
  2668.  
  2669.       Jon Weinstock
  2670.       General Instrument Corporation
  2671.       jweinstock@gic.gi.com
  2672.       For his participation in the development of the initial drafts
  2673.       and for serving as editor for drafts 1 and 2.
  2674.  
  2675.       The editor would like to extend special thanks to the
  2676.       following working group members for their contributions
  2677.       to this effort.
  2678.  
  2679.       Harald Alvestrand, George Best, Ian Hanson, Harrie
  2680.       Hazewinkel, Carl Kalbfleisch, Bobby Krupczak, Randy
  2681.       Presuhn, Jon Saperia, Juergen Schoenwaelder
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  10.  Editor's Address
  2687.  
  2688.       Cheryl Krupczak
  2689.       Empire Technologies, Inc.
  2690.       541 Tenth Street, NW Suite 169
  2691.       Atlanta, GA 30318
  2692.       Phone: 770.384.0184
  2693.       Email: cheryl@empiretech.com
  2694.  
  2695.  
  2696.  11.  References
  2697.  
  2698.  [1]  Information processing systems - Open Systems
  2699.       Interconnection - Specification of Abstract Syntax
  2700.       Notation Once (ASN.1), International Organization for
  2701.       Standardization.  International Standard 8824, (December,
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  Expires October 15, 1997                             [Page 46]
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  Internet Draft      System Application MIB      April 15, 1997
  2714.  
  2715.  
  2716.       1987).
  2717.  
  2718.  
  2719.  [2]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  2720.       and S. Waldbusser, "Structure of Management Information
  2721.       for Version 2 of the Simple Network Management Protocol
  2722.       (SNMPv2)", RFC 1902, January 1996.
  2723.  
  2724.  
  2725.  [3]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  2726.       and S. Waldbusser, "Textual Conventions for Version 2 of
  2727.       the Simple Network Management Protocol (SNMPv2)", RFC
  2728.       1903, January 1996.
  2729.  
  2730.  
  2731.  [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  2732.       and S. Waldbusser, "Conformance Statements for Version 2
  2733.       of the Simple Network Management Protocol (SNMPv2)", RFC
  2734.       1904, January 1996.
  2735.  
  2736.  
  2737.  [5]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  2738.       and S. Waldbusser, "Protocol Operations for Version 2 of
  2739.       the Simple Network Management Protocol (SNMPv2)", RFC
  2740.       1905, January 1996.
  2741.  
  2742.  
  2743.  [6]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  2744.       and S. Waldbusser, "Transport Mappings for SNMPv2", RFC
  2745.       1906, January 1996.
  2746.  
  2747.  
  2748.  [7]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  2749.       and S. Waldbusser, "Management Information Base for
  2750.       Version 2 of the Simple Network Management Protocol
  2751.       (SNMPv2)", RFC 1907, January 1996.
  2752.  
  2753.  
  2754.  [8]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  2755.       and S. Waldbusser, "Coexistence between Version 1 and
  2756.       Version 2 of the Internet-standard Network Management
  2757.       Framework", RFC 1908, January 1996.
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  Expires October 15, 1997                             [Page 47]
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  Internet Draft      System Application MIB      April 15, 1997
  2773.  
  2774.  
  2775.  [9]  P. Grillo, S. Waldbusser, "Host Resources MIB", RFC 1514,
  2776.       September 1993.
  2777.  
  2778.  
  2779.  [10] F. Yergeau, "UTF-8, a transformation format of Unicode
  2780.       and ISO 10646", RFC 2044, October 1996.
  2781.  
  2782.  
  2783.  [11] C. Krupczak, S. Waldbusser, "Applicability of Host
  2784.       Resources MIB to Application Management", Application MIB
  2785.       working group report, October 1995.
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  Expires October 15, 1997                             [Page 48]
  2826.  
  2827.