Internet Draft System Application MIB April 30,1996 Definitions of Managed Objects for Applications April 30, 1996 Jonathan Saperia BGS Systems Inc. saperia@bgs.com Cheryl Krupczak Empire Technologies, Inc. cheryl@empiretech.com Rick Sturm Enterprise Management Professional Services, Inc. sturm@emi-summit.com Jonathan Weinstock Bellcore jonathan.weinstock@cc.bellcore.com Status of this Memo This document is an Internet-Draft. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet- Drafts as reference material or to cite them other than as ``work in progress.'' To learn the current status of any Internet-Draft, please check the ``1id-abstracts.txt'' listing contained in the Internet- Drafts Shadow Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim). Expires November 30, 1996 [Page 1] Internet Draft System Application MIB April 30,1996 1. Abstract This memo defines an experimental portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes a basic set of managed objects for fault, configuration and performance management of applications. This memo does not specify a standard for the Internet community. Expires November 30, 1996 [Page 2] Internet Draft System Application MIB April 30,1996 2. The SNMPv2 Network Management Framework The SNMPv2 Network Management Framework consists of four major components. They are: o STD 17, RFC 1213 [1] defines MIB-II, the core set of managed objects for the Internet suite of protocols. o RFC 1902 Structure of Management Information for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1903 Textual Conventions for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1904 Conformance Statements for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1905 Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1906 Transport Mappings for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1907 Management Information Base for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1908 Coexistence between Version 1 and Version 2 of the Internet-standard Network Management Framework The Framework permits new objects to be defined for the purpose of experimentation and evaluation. 2.1. Object Definitions Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI[1]. In particular, each object type is named by an OBJECT IDENTIFIER, an administratively assigned name. The object type together with an object instance serves to uniquely identify a specific instantiation of the object. For human convenience, we often use a textual string, termed the object descriptor, to refer to the object type. Expires November 30, 1996 [Page 3] Internet Draft System Application MIB April 30,1996 3. Overview The primary purpose of computing technologies is the execution of application software. These applications, typically specialized collections of executables, files and interprocess communications exist to solve business, scientific or other "problems". The fault, performance monitoring and control of application software across it's life on a host computer is of great economic importance. For the purposes of our work, we define applications as one or more units of executable code and other resources, installed on a single host system that a manager may think of as a single object for management purposes. The information described by the objects in the System Application MIB support configuration, fault and performance management of some of the basic attributes of application software. The information allows for the description of applications as a collection of executables, and files installed and executing on a host computer. This draft is concerned primarily with and models application information resident on a host computer which is discoverable in a rudimentary fashion by todays agent and operating systems technologies. This approach was taken to insure ease and speed of implementation, while allowing room for future growth. We believe that this work will be followed by the subsequent modeling and specification of management information accessible via application instrumentation. These new "appl MIB" objects will participate as multiple Generic Application MIB instances within each host platform. Expires November 30, 1996 [Page 4] Internet Draft System Application MIB April 30,1996 4. The Structure of the MIB The System Application MIB structure reflects the notion of applications which have been installed on a system and which may contain many components some of which are executables, others are not. The objects are arranged into the following groups: - System Application Installed Group - System Application Run Group The System Application Installed group consists of two tables. The first, the sysApplInstalledTable exists to capture what applications are installed on a particular host. The second, the sysApplCfgElmTable, provides information regarding the executables and non executable files which collectively compose the application. This information is discoverable provided that certain conventions are followed by administrators during the installation of host application software. Through these two tables administrators will be able to determine which applications have been installed on a system and what their constituent components are. The System Application Run Group: This group consists of two pairs of tables (four tales) and seven scalars. The first set of tables contains the sysApplRunTable and the SysApplPastRun Table. The sysApplRunTable contains the application instances which are currently running on the host. An entry is created in this table for each instance on an application when is it started. The sysApplPastRunTable contains table rows corresponding to instances of applications which have previously executed on the host. Entries to this table are made when an application has terminated. Coincident with this, the table entry which represents the application is removed from the SysApplRunTable. Table rows are removed from the SysApplPastRunTable according to values set in two scalars, sysApplPastRunTableSizeLimit and sysApplPastRunTableTimeLimit. These objects specify the maximum table size of the sysApplPastRunTable as well as the maximum age of its table entries. A parallel structure exists for the running processes associated with an application. The sysApplElmtRunTable contains the process instances which are currently running on the host. An entry is created in this table for each instance on a process at the time it is started. The sysApplElmtPastRunTable contains table rows corresponding to instances of processes which have previously executed on the host. Entries to this table are made when the process has terminated. Expires November 30, 1996 [Page 5] Internet Draft System Application MIB April 30,1996 Coincident with this, the table entry which represents the process is removed from the SysApplElmtRunTable. Table rows are removed from the SysApplElmtPastRunTable according to values set in two scalars, sysApplElmtPastRunTableSizeLimit and sysApplElmtPastRunTableTimeLimit. These objects specify the maximum table size of the sysApplElmtPastRunTable as well as the maximum age of its table entries. Expires November 30, 1996 [Page 6] Internet Draft System Application MIB April 30,1996 5. Definitions SYSAPPL-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Integer32, TimeTicks, Counter32 FROM SNMPv2-SMI DisplayString, DateAndTime FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF mib-2 FROM RFC1213-MIB; -- System Application MIB sysApplMIB MODULE-IDENTITY LAST-UPDATED "9604300000Z" ORGANIZATION "IETF Applications MIB Working Group" CONTACT-INFO "Cheryl Krupczak (WG Advisor) Postal: Empire Technologies, Inc. 541 Tenth Street NW Suite 169 Atlanta, GA 30318 USA Phone: (770) 384-0184 Email: cheryl@empiretech.com Jon Saperia (WG Co-Chair) Postal: BGS Systems, Inc. 128 Technology Center Waltham, MA 02254-9111 USA Phone: (617) 891-0000 ext 340 Email: saperia@bgs.com Rick Sturm (WG Co-Chair) Postal: Enterprise Management Profession Services, Inc. 345 Norton Street Boulder, CO 80303 USA Phone:(303)543-7304 Email: sturm.emi-summit.com Jonathan A. Weinstock (WG Editor) Postal: Bellcore 444 Hoes Lane Piscataway, NJ 08855 USA Phone: (908) 699-5862 Expires November 30, 1996 [Page 7] Internet Draft System Application MIB April 30,1996 Email: jonathan.weinstock@cc.bellcore.com" DESCRIPTION "The MIB module defines an application on a system platform" ::= { mib-2 9999 } sysApplOBJ OBJECT IDENTIFIER ::= { sysApplMIB 1 } sysApplInstalled OBJECT IDENTIFIER ::= { sysApplOBJ 1 } sysApplRun OBJECT IDENTIFIER ::= { sysApplOBJ 2 } sysApplNotifications OBJECT IDENTIFIER ::= { sysApplMIB 2 } sysApplConformance OBJECT IDENTIFIER ::= { sysApplMIB 3 } -- textual conventions Kbytes ::= Integer32 -- -- This data type is intended as a shorthand for the representation -- of kilobytes -- The system installed applications group provides information -- about packages and all of their constituent elements such as -- executable and configuration files found on a system. -- The system installed applications table provides information -- software packages loaded on a system. These packages can be -- a combination of many different files. Agents should provide -- index to entry consistency across agent reboots. sysApplInstalledTable OBJECT-TYPE SYNTAX SEQUENCE OF SysApplInstalledEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table describing the software installed on a platform." ::= { sysApplInstalled 1 } sysApplInstalledEntry OBJECT-TYPE SYNTAX SysApplInstalledEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The logical row describing installed software components." INDEX { sysApplInstalledIndex } ::= { sysApplInstalledTable 1 } SysApplInstalledEntry ::= SEQUENCE { sysApplInstalledIndex Integer32, sysApplInstalledManufacturer DisplayString, Expires November 30, 1996 [Page 8] Internet Draft System Application MIB April 30,1996 sysApplInstalledProductName DisplayString, sysApplInstalledVersion DisplayString, sysApplInstalledSerialNumber DisplayString, sysApplInstalledDate DateAndTime, sysApplInstalledLocation DisplayString } sysApplInstalledIndex OBJECT-TYPE SYNTAX Integer32 (1..'7fffffff'h) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An arbitrary, small integer used only for indexing purposes. Generally monotonically increasing from 1 as new applications are installed." ::= { sysApplInstalledEntry 1 } sysApplInstalledManufacturer OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The Manufacturer of the software application." ::= { sysApplInstalledEntry 2 } sysApplInstalledProductName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The name provided to the software application by the Manufacturer." ::= { sysApplInstalledEntry 3 } sysApplInstalledVersion OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The version of the product assigned by the manufacturer of the software." ::= { sysApplInstalledEntry 4 } sysApplInstalledSerialNumber OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The serial number of the software assigned by the manufacturer." ::= { sysApplInstalledEntry 5 } sysApplInstalledDate OBJECT-TYPE Expires November 30, 1996 [Page 9] Internet Draft System Application MIB April 30,1996 SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The date and time this software application was installed on the host." ::= { sysApplInstalledEntry 6 } sysApplInstalledLocation OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The path name where the executables are stored for the application." ::= { sysApplInstalledEntry 7 } -- The sysApplCfgElem Table details the elements which comprise the -- application defined in the sysApplInstalled Table. Each entry in -- this table has an index to the sysApplInstalled table. As a result -- there may be many entries in this table for each instance in the -- sysApplInstalled Table. sysApplCfgElmtTable OBJECT-TYPE SYNTAX SEQUENCE OF SysApplCfgElmtEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table describing the application executables and non executables installed on a platform." ::= { sysApplInstalled 2 } sysApplCfgElmtEntry OBJECT-TYPE SYNTAX SysApplCfgElmtEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The logical row describing installed software executables and non executable components of an application." INDEX {sysApplInstalledIndex, sysApplCfgElmtIndex} ::= { sysApplCfgElmtTable 1 } SysApplCfgElmtEntry ::= SEQUENCE { sysApplCfgElmtIndex Integer32, sysApplCfgElmtName DisplayString, sysApplCfgElmtType INTEGER, sysApplCfgElmtDate DateAndTime, sysApplCfgElmtPath DisplayString, sysApplCfgElmtSize Kbytes, sysApplCfgElmtRole BIT STRING } Expires November 30, 1996 [Page 10] Internet Draft System Application MIB April 30,1996 sysApplCfgElmtIndex OBJECT-TYPE SYNTAX Integer32 (1..'7fffffff'h) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An arbitrary, small integer used for indexing purposes. Generally monotonically increasing from 1 as new elements are installed in the system." ::= { sysApplCfgElmtEntry 1 } sysApplCfgElmtName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The name of this element which is contained in the application." ::= { sysApplCfgElmtEntry 2 } sysApplCfgElmtType OBJECT-TYPE SYNTAX INTEGER { executable(1), nonexecutable(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The type of element that is part of the installed application." ::= { sysApplCfgElmtEntry 3 } sysApplCfgElmtDate OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The date and time that this component was installed on the system." ::= { sysApplCfgElmtEntry 4 } sysApplCfgElmtPath OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The full path name of this file." ::= { sysApplCfgElmtEntry 5} sysApplCfgElmtSize OBJECT-TYPE SYNTAX Kbytes MAX-ACCESS read-only STATUS current Expires November 30, 1996 [Page 11] Internet Draft System Application MIB April 30,1996 DESCRIPTION "The size of the file in Kbytes." ::= { sysApplCfgElmtEntry 6 } sysApplCfgElmtRole OBJECT-TYPE SYNTAX BIT STRING { executable(0), -- An application may have one or -- more executable elements. The rest of the bits -- have no meaning if the element is not executable. exclusive(1), -- Only one copy of an exclusive element -- may be running. interesting(2), -- An application may have zero or more -- interesting elements. Only tables, but all -- executable show in the running tables. required(3), -- An application may have zero or more -- required elements. At least one must be running -- to indicate that the application is running -- and healthy. dependent(4) } -- An application may have zero or more -- dependent elements. Dependent elements may -- not be running unless required elements -- are. MAX-ACCESS read-write STATUS current DESCRIPTION "An operator assigned value used in the determination of application status. This value is used by the agent to determine both the mapping of started processes to the initiation of an application, as well as to allow for a determination of application health." ::= { sysApplCfgElmtEntry 7 } -- The sysApplRun Group contains information about applications -- are currently running or have run on the host. -- The sysApplRunTable contains entries for applications currently -- executing on the platform. sysApplRunTable OBJECT-TYPE SYNTAX SEQUENCE OF SysApplRunEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table describes the applications which are executing on the host. Each time an application is run an entry is created in this table. When an application ends, the entry is removed from this table and placed in the SysApplPastRunTable." ::= { sysApplRun 1 } sysApplRunEntry OBJECT-TYPE SYNTAX SysApplRunEntry MAX-ACCESS not-accessible Expires November 30, 1996 [Page 12] Internet Draft System Application MIB April 30,1996 STATUS current DESCRIPTION "The logical row describing the applications which are currently running on this host. Entries remain in this table until the applications end and are then added to the sysApplPastRunTable." INDEX { sysApplRunIndex } ::= { sysApplRunTable 1 } SysApplRunEntry ::= SEQUENCE { sysApplRunIndex Integer32, sysApplRunInstalledIndex Integer32, sysApplRunLastStarted DateAndTime, sysApplRunCurrentState INTEGER, sysApplRunEnded DateAndTime } sysApplRunIndex OBJECT-TYPE SYNTAX Integer32 (1..'7fffffff'h) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index for this table. An arbitrary small integer used only for indexing purposes. Generally monotonically increasing from 1 as new applications are started on the host." ::= { sysApplRunEntry 1 } sysApplRunInstalledIndex OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The pointer to the installed application table. An arbitrary small integer used only for indexing purposes." ::= { sysApplRunEntry 2 } sysApplRunLastStarted OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The date and time that the application was last started." ::= { sysApplRunEntry 3 } sysApplRunCurrentState OBJECT-TYPE SYNTAX INTEGER { running (1), runnable (2), -- waiting for resource (CPU, etc.) waiting (3), -- waiting for event exiting (4), -- other invalid state other (5) } Expires November 30, 1996 [Page 13] Internet Draft System Application MIB April 30,1996 MAX-ACCESS read-only STATUS current DESCRIPTION "The current state of the running application." ::= { sysApplRunEntry 4 } sysApplRunEnded OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The DateAndTime the application exited." ::= { sysApplRunEntry 5 } -- The sysApplPastRunTable contains entries for applications -- previously run on the platform. Entries are added to this table -- when an application becomes inactive. Entries are remove for this -- table when either the table size reaches a maximum as determined by -- the sysApplRunTableSizeLimit or when an entry has aged to exceed a -- time limit as set be sysApplPastRunTimeLimit. When table size is exceeded -- the oldest entry as determined by the smallest sysApplPastRunIndex, -- will be removed. sysApplPastRunTable OBJECT-TYPE SYNTAX SEQUENCE OF SysApplPastRunEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table describes the applications have executed on the host. Each time an application is terminated an entry is created in this table. Table size is controlled by the sysApplPastRunTableSizeLimit object and the sysApplPastRunTimeLimit." ::= { sysApplRun 2 } sysApplPastRunEntry OBJECT-TYPE SYNTAX SysApplPastRunEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The logical row describing the applications which are have run on this host. Entries remain in this table until they are rolled out according to the sysApplPastRunTableSizeLimit object or the sysApplPastRunTimeLimit object." INDEX { sysApplPastRunIndex } ::= { sysApplPastRunTable 1 } SysApplPastRunEntry ::= SEQUENCE { sysApplPastRunIndex Integer32, sysApplPastRunInstalledIndex Integer32, sysApplPastRunLastStarted DateAndTime, Expires November 30, 1996 [Page 14] Internet Draft System Application MIB April 30,1996 sysApplPastRunCurrentState INTEGER, sysApplPastRunEnded DateAndTime } sysApplPastRunIndex OBJECT-TYPE SYNTAX Integer32 (1..'7fffffff'h) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index for this table. An arbitrary small integer matching the value of the removed sysApplRunIndex corresponding to this row." ::= { sysApplPastRunEntry 1 } sysApplPastRunInstalledIndex OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The pointer to the installed application table. An arbitrary small integer used only for indexing purposes." ::= { sysApplPastRunEntry 2 } sysApplPastRunLastStarted OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The date and time that the application was started." ::= { sysApplPastRunEntry 3 } sysApplPastRunCurrentState OBJECT-TYPE SYNTAX INTEGER { complete (1), -- normal exit at sysApplRunEnded failed (2), -- abnormal exit other (3) } MAX-ACCESS read-only STATUS current DESCRIPTION "The exit state." ::= { sysApplPastRunEntry 4 } sysApplPastRunEnded OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The DateAndTime the application exited." ::= { sysApplPastRunEntry 5 } Expires November 30, 1996 [Page 15] Internet Draft System Application MIB April 30,1996 -- The sysApplElmtRun Table consists of entries for elements of -- application which are running on the host -- system. sysApplElmtRunTable OBJECT-TYPE SYNTAX SEQUENCE OF SysApplElmtRunEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table describes the processes which are executing on the host as part of an application. It is possible to have multiple entries in this table for each application. Entries are removed from this table when the process terminates." ::= { sysApplRun 3 } sysApplElmtRunEntry OBJECT-TYPE SYNTAX SysApplElmtRunEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The logical row describing the processes which are currently running on this host as part of an application. Entries remain in this table until they are rolled out and moved to the sysAppElmtPastRunTable when the terminate." INDEX { sysApplRunIndex,sysApplElmtRunIndex } ::= { sysApplElmtRunTable 1 } SysApplElmtRunEntry ::= SEQUENCE { sysApplElmtRunIndex Integer32, sysApplElmtRunElemID Integer32, sysApplElmtRunHRID Integer32, sysApplElmtRunTimeStarted DateAndTime, sysApplElmtRunTimeEnded DateAndTime, sysApplElmtRunState INTEGER, sysApplElmtRunName DisplayString, sysApplElmtRunParameters DisplayString, sysApplElmtRunType INTEGER, sysApplElmtRunCPU TimeTicks, sysApplElmtRunMemory Integer32, sysApplElmtRunNumTCon Integer32, sysApplElmtRunNumFiles Integer32 } sysApplElmtRunIndex OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index for this table. An arbitrary, small integer used only for indexing purposes. Generally monotonically increasing from 1 as new processes start as part of an application." Expires November 30, 1996 [Page 16] Internet Draft System Application MIB April 30,1996 ::= { sysApplElmtRunEntry 1 } sysApplElmtRunElemID OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The index into the installed element table. An arbitrary, small integer used only for indexing purposes." ::= { sysApplElmtRunEntry 2 } sysApplElmtRunHRID OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The index into the Host Resources running software table." ::= { sysApplElmtRunEntry 3 } sysApplElmtRunTimeStarted OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The time the process was started." ::= { sysApplElmtRunEntry 4 } sysApplElmtRunTimeEnded OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The time the process ended." ::= { sysApplElmtRunEntry 5 } sysApplElmtRunState OBJECT-TYPE SYNTAX INTEGER { running (1), runnable (2), -- waiting for resource (CPU, etc.) waiting (3), -- waiting for event exiting (4), -- other invalid state other (5) } MAX-ACCESS read-only STATUS current DESCRIPTION "The state of the running process." ::= { sysApplElmtRunEntry 6 } sysApplElmtRunName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current Expires November 30, 1996 [Page 17] Internet Draft System Application MIB April 30,1996 DESCRIPTION "The full path name of the process." ::= { sysApplElmtRunEntry 7 } sysApplElmtRunParameters OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The starting parameters for the process." ::= { sysApplElmtRunEntry 8 } sysApplElmtRunType OBJECT-TYPE SYNTAX INTEGER { unknown (1), operatingSystem (2), deviceDriver (3), application (4) } MAX-ACCESS read-only STATUS current DESCRIPTION "The type of the executable." ::= { sysApplElmtRunEntry 9 } sysApplElmtRunCPU OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The total CPU time of the running process." ::= { sysApplElmtRunEntry 10 } sysApplElmtRunMemory OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The average memory measured in Kbytes used by this element." ::= { sysApplElmtRunEntry 11 } sysApplElmtRunNumTCon OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of transport connections used by the process." ::= { sysApplElmtRunEntry 12 } sysApplElmtRunNumFiles OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only Expires November 30, 1996 [Page 18] Internet Draft System Application MIB April 30,1996 STATUS current DESCRIPTION "The number of files open by the element." ::= { sysApplElmtRunEntry 13 } -- The sysApplElmtPastRunTable consists of entries for elements of -- application have previously executed on the host -- system. sysApplElmtPastRunTable OBJECT-TYPE SYNTAX SEQUENCE OF SysApplElmtPastRunEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table describes the processes which have previously executed on the host as part of an application. It is possible to have multiple entries in this table for each application. Entries are added to this table when the corresponding process terminates." ::= { sysApplRun 4 } sysApplElmtPastRunEntry OBJECT-TYPE SYNTAX SysApplElmtPastRunEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The logical row describing the processes which have run on this host as part of an application. Entries are added in this table when an application process terminates. They are rolled out either when a table limit size is reached, as set in sysApplElmtPastRunSizeLimit or until they age past a time limit as set by sysApplElmtPastRunTimeLimit." INDEX { sysApplPastRunIndex,sysApplElmtPastRunIndex } ::= { sysApplElmtPastRunTable 1 } SysApplElmtPastRunEntry ::= SEQUENCE { sysApplElmtPastRunIndex Integer32, sysApplElmtPastRunElemID Integer32, sysApplElmtPastRunHRID Integer32, sysApplElmtPastRunTimeStarted DateAndTime, sysApplElmtPastRunTimeEnded DateAndTime, sysApplElmtPastRunState INTEGER, sysApplElmtPastRunName DisplayString, sysApplElmtPastRunParameters DisplayString, sysApplElmtPastRunType INTEGER, sysApplElmtPastRunCPU TimeTicks, sysApplElmtPastRunMemory Integer32, sysApplElmtPastRunNumTCon Integer32, sysApplElmtPastRunNumFiles Integer32 } Expires November 30, 1996 [Page 19] Internet Draft System Application MIB April 30,1996 sysApplElmtPastRunIndex OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index for this table. An arbitrary, small integer assigned by the agent equal to the corresponding sysApplElmtRunIndex which was removed from the sysApplElmtRunTable." ::= { sysApplElmtPastRunEntry 1 } sysApplElmtPastRunElemID OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The index into the installed element table. An arbitrary, small integer used only for indexing purposes." ::= { sysApplElmtPastRunEntry 2 } sysApplElmtPastRunHRID OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The index into the Host Resources running software table." ::= { sysApplElmtPastRunEntry 3 } sysApplElmtPastRunTimeStarted OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The time the process was started." ::= { sysApplElmtPastRunEntry 4 } sysApplElmtPastRunTimeEnded OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The time the process ended." ::= { sysApplElmtPastRunEntry 5 } sysApplElmtPastRunState OBJECT-TYPE SYNTAX INTEGER { completed (1), failed (2), -- other (3) } MAX-ACCESS read-only STATUS current DESCRIPTION "The state of ending." Expires November 30, 1996 [Page 20] Internet Draft System Application MIB April 30,1996 ::= { sysApplElmtPastRunEntry 6 } sysApplElmtPastRunName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The full path name of the process." ::= { sysApplElmtPastRunEntry 7 } sysApplElmtPastRunParameters OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The starting parameters for the process." ::= { sysApplElmtPastRunEntry 8 } sysApplElmtPastRunType OBJECT-TYPE SYNTAX INTEGER { unknown (1), operatingSystem (2), deviceDriver (3), application (4) } MAX-ACCESS read-only STATUS current DESCRIPTION "The type of the executable." ::= { sysApplElmtPastRunEntry 9 } sysApplElmtPastRunCPU OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The total CPU time of the running process." ::= { sysApplElmtPastRunEntry 10 } sysApplElmtPastRunMemory OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The average memory measured in Kbytes used by this element." ::= { sysApplElmtPastRunEntry 11 } sysApplElmtPastRunNumTCon OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION Expires November 30, 1996 [Page 21] Internet Draft System Application MIB April 30,1996 "The number of transport connections used by the process." ::= { sysApplElmtPastRunEntry 12 } sysApplElmtPastRunNumFiles OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of files open by the element." ::= { sysApplElmtPastRunEntry 13 } -- Additional Scalar objects to control table sizes sysApplPastRunTableSizeLimit OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-write STATUS current DESCRIPTION "The maximum size to allow the sysApplPastRunTable to grow before entries are removed, as viewed by the agent. Entries will be removed on the basis of oldest sysApplPastRunEnded value first." DEFVAL { 500 } ::= { sysApplRun 5 } sysApplPastRunTableItemsRem OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION " A counter of entries removed by the agent during its lifetime from the sysApplPastRunTable because of table size limitations as set in sysApplPastRunTableSizeLimit." ::= { sysApplRun 6 } sysApplPastRunTableTimeLimit OBJECT-TYPE SYNTAX Integer32 UNITS "seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The minimum time in seconds which an entry in the sysApplPastRunTable may exist before it is removed." DEFVAL { 3600 } ::= { sysApplRun 7 } sysApplElemPastRunSizeLimit OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-write Expires November 30, 1996 [Page 22] Internet Draft System Application MIB April 30,1996 STATUS current DESCRIPTION "The maximum size to allow the sysApplElmtPastRun table to grow before entries are removed as viewed by the agent. Entries will be removed on the basis of oldest sysApplElmtPastRunTimeEnded value first." DEFVAL { 500 } ::= { sysApplRun 8 } sysApplElemPastRunTableItemsRem OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of entries removed by the agent during its lifetime from the sysApplElemPastRunTable because of table size limitations as set in sysApplElemPastRunTableSizeLimit." ::= { sysApplRun 9 } sysApplElemPastRunTimeLimit OBJECT-TYPE SYNTAX Integer32 UNITS "seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The minimum time in seconds which an entry in the sysApplElemPastRunTable may exist before it is removed." DEFVAL { 500 } ::= { sysApplRun 10 } sysApplAgentPollInterval OBJECT-TYPE SYNTAX Integer32 UNITS "seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The minimum time in seconds that an agent will poll the status of the managed resources. A value of 0 indicates that their is no delay in the passing of information from the managed resources to the agent." DEFVAL { 60 } ::= { sysApplRun 11 } Expires November 30, 1996 [Page 23] Internet Draft System Application MIB April 30,1996 -- Conformance Macros sysApplMIBCompliances OBJECT IDENTIFIER ::= { sysApplConformance 1 } sysApplMIBGroups OBJECT IDENTIFIER ::= { sysApplConformance 2 } sysApplMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "Describes the requirements for conformance to the System Application MIB" MODULE -- this module MANDATORY-GROUPS { sysApplInstalledGroup, sysApplRunGroup } ::= { sysApplMIBCompliances 1 } sysApplInstalledGroup OBJECT-GROUP OBJECTS { sysApplInstalledManufacturer, sysApplInstalledProductName, sysApplInstalledVersion, sysApplInstalledSerialNumber, sysApplInstalledDate, sysApplInstalledLocation, sysApplCfgElmtName, sysApplCfgElmtType, sysApplCfgElmtDate, sysApplCfgElmtPath, sysApplCfgElmtSize, sysApplCfgElmtRole } STATUS current DESCRIPTION "The system application installed group contains information about applications which have been installed on the host system." ::= { sysApplMIBGroups 1 } sysApplRunGroup OBJECT-GROUP OBJECTS { sysApplRunInstalledIndex, sysApplRunLastStarted, sysApplRunCurrentState, sysApplRunEnded, sysApplPastRunInstalledIndex, sysApplPastRunLastStarted, sysApplPastRunCurrentState, sysApplPastRunEnded, sysApplElmtRunElemID, sysApplElmtRunHRID, sysApplElmtRunTimeStarted, sysApplElmtRunTimeEnded, sysApplElmtRunState, sysApplElmtRunName, sysApplElmtRunParameters, sysApplElmtRunType, sysApplElmtRunCPU, Expires November 30, 1996 [Page 24] Internet Draft System Application MIB April 30,1996 sysApplElmtRunMemory, sysApplElmtRunNumTCon, sysApplElmtRunNumFiles, sysApplElmtPastRunElemID, sysApplElmtPastRunHRID, sysApplElmtPastRunTimeStarted, sysApplElmtPastRunTimeEnded, sysApplElmtPastRunState, sysApplElmtPastRunName, sysApplElmtPastRunParameters, sysApplElmtPastRunType, sysApplElmtPastRunCPU, sysApplElmtPastRunMemory, sysApplElmtPastRunNumTCon, sysApplElmtPastRunNumFiles, sysApplPastRunTableSizeLimit, sysApplPastRunTableTimeLimit, sysApplElemPastRunSizeLimit , sysApplElemPastRunTimeLimit , sysApplAgentPollInterval, sysApplPastRunTableItemsRem, sysApplElemPastRunTableItemsRem } STATUS current DESCRIPTION "The system application run group contains information about applications and associated elements which have run or are currently running on the host system." ::= { sysApplMIBGroups 2 } END 6. Acknowledgements This document was produced by the Application MIB working group. Expires November 30, 1996 [Page 25] Internet Draft System Application MIB April 30,1996 7. References [1] McCloghrie, K., and M. Rose, Editors, "Management Information Base for Network Management of TCP/IP-based internets: MIB- II", STD 17, RFC 1213, Hughes LAN Systems, Performance Systems International, March 1991. Expires November 30, 1996 [Page 26] Internet Draft System Application MIB April 30,1996 8. Security Considerations Security issues are not discussed in this memo. Expires November 30, 1996 [Page 27] Internet Draft System Application MIB April 30,1996 Table of Contents 1 Abstract .................................................. 2 2 The SNMPv2 Network Management Framework ................... 3 2.1 Object Definitions ...................................... 3 3 Overview .................................................. 4 4 The Structure of the MIB .................................. 5 5 Definitions ............................................... 7 6 Acknowledgements .......................................... 25 7 References ................................................ 26 8 Security Considerations ................................... 27 Expires November 30, 1996 [Page 28]