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-mib-03.txt < prev    next >
Text File  |  1997-07-11  |  114KB  |  3,184 lines
  1.  
  2. INTERNET-DRAFT                                            C. Kalbfleisch
  3.                                                              Verio, Inc.
  4.                                                              C. Krupczak
  5.                                                Empire Technologies, Inc.
  6.                                                               R. Presuhn
  7.                                                       BMC Software, Inc.
  8.                                                               J. Saperia
  9.                                                        BGS Systems, Inc.
  10.                                                             10 July 1997
  11.  
  12.  
  13.                        Application Management MIB
  14.                     <draft-ietf-applmib-mib-03.txt>
  15.  
  16. Status of this Memo
  17.  
  18.    This document is an Internet-Draft.  Internet-Drafts are working
  19.    documents of the Internet Engineering Task Force (IETF), its areas,
  20.    and its working groups.  Note that other groups may also distribute
  21.    working documents as Internet-Drafts.
  22.  
  23.    Internet-Drafts are draft documents valid for a maximum of six months
  24.    and may be updated, replaced, or obsoleted by other documents at any
  25.    time.  It is inappropriate to use Internet- Drafts as reference
  26.    material or to cite them other than as ``work in progress.''
  27.  
  28.    To learn the current status of any Internet-Draft, please check the
  29.    ``1id-abstracts.txt'' listing contained in the Internet- Drafts
  30.    Shadow Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe),
  31.    munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
  32.    ftp.isi.edu (US West Coast).
  33.  
  34. Abstract
  35.  
  36.    This memo defines an experimental portion of the Management
  37.    Information Base (MIB) for use with network management protocols in
  38.    the Internet Community.  In particular, it defines objects used for
  39.    the management of applications.  This MIB complements the System
  40.    Application MIB, providing for the management of applications' common
  41.    attributes which could not typically be observed without the
  42.    cooperation of the software being managed.
  43.  
  44.  
  45.  
  46. 1.  Introduction
  47.  
  48.    This draft furthers the work begun in the systems application mib
  49.    [11].  See the issues list at the end of this document for issues
  50.  
  51.  
  52.  
  53. Applmib Working Group     Expires December 1997                 [Page 1]
  54.  
  55. Internet Draft         Application Management MIB           10 July 1997
  56.  
  57.  
  58.    that remain to be worked out.
  59.  
  60.    The development of [1], [2], [3], [4], [8] and [9] provides us with a
  61.    base of experience in making a variety of applications visible to
  62.    management; this specification abstracts out the common aspects of
  63.    applications management and provides a generic base usable for the
  64.    management of almost any application.
  65.  
  66.  
  67. 2.  Overview
  68.  
  69.    Due to the design decision to not require application
  70.    instrumentation, many important topics were not handled in system
  71.    application MIB [11].  The following topics are within the scope of
  72.    the this document:
  73.  
  74.  
  75.       -  Support for generic application throughput measurements;
  76.  
  77.       -  Providing MIB definitions that allow managed entities to report
  78.          what they considered to be units of work;
  79.  
  80.       -  Providing support for generic application response time
  81.          monitoring capabilities;
  82.  
  83.       -  Provide explicit support for the management of applications
  84.          distributed within a single managed system ("local"
  85.          distribution);
  86.  
  87.       -  Address generic resource management issues, including:
  88.  
  89.          -  files in use;
  90.  
  91.          -  I/O statistics (from the application's perspective, not at
  92.             the operating system or device driver level);
  93.  
  94.          -  application-layer networking resource usage
  95.  
  96.          -  Providing access to dependency information, both in the form
  97.             of MIB objects to report dependencies on "mission critical"
  98.             processes, as well as the logging of failures due to
  99.             dependencies.
  100.  
  101.       -  Provide a generic logging (stderr) capability:
  102.  
  103.          -  Identify common log entries of use with multiple
  104.             applications;
  105.  
  106.  
  107.  
  108.  
  109. Applmib Working Group     Expires December 1997                 [Page 2]
  110.  
  111. Internet Draft         Application Management MIB           10 July 1997
  112.  
  113.  
  114.          -  Permit use of specialized log entries where appropriate;
  115.  
  116.          -  Provide generic facility for the management of this log;
  117.  
  118.          -  Provide generic facility to control notification generation
  119.             by the application;
  120.  
  121.       -  Facilities for the control of applications, including:
  122.  
  123.          -  Starting and stopping applications and their elements;
  124.  
  125.          -  Suspending and resuming applications and their elements;
  126.  
  127.          -  Configuration of application parameters;
  128.  
  129.          -  A "mission critical process" MIB to identify processes that
  130.             are of particular interest;
  131.  
  132.          -  Reconfiguration (e.g., SIGHUP) request capability.
  133.  
  134.       Note that these issues are addressed at least in part by other
  135.       (non-IETF) standards work, including [12] and [13].
  136.  
  137.       Some topics were identified as being of interest to the applmib
  138.       working group, but outside the scope of this document.
  139.  
  140.       -  Providing MIB definitions that allow management to define what
  141.          is to be considered an error.  This includes mechanisms for
  142.          filtering and selective forwarding of information from
  143.          notifications or log entries.
  144.  
  145.       Topics identified as specifically out of scope include:
  146.  
  147.  
  148.       -  Providing MIB definitions to allow dynamic control of the
  149.          definition of units of work;
  150.  
  151.       -  Explicit support for the management of applications distributed
  152.          across multiple systems; (The indexing structure and semantics
  153.          of the system application MIB [11] are not sufficient for this
  154.          task.)
  155.  
  156.       -  Issues of backup and recovery;
  157.  
  158.       -  Issues of software request, delivery, installation, activation,
  159.          patching, version update, reversion, and removal;
  160.  
  161.       -  Issues of software validation and integrity checks;
  162.  
  163.  
  164.  
  165. Applmib Working Group     Expires December 1997                 [Page 3]
  166.  
  167. Internet Draft         Application Management MIB           10 July 1997
  168.  
  169.  
  170.       -  Issues of software licensing.
  171.  
  172.  
  173. 3.  Architecture
  174.  
  175.    To emulate the object-oriented modeling techniques of subclassing and
  176.    multiple inheritance, the SNMP information model provides for the use
  177.    of tables with common indexes.  The challenge for the developer of
  178.    management applications is to recognize those situations in which
  179.    various aspects of a single logical resource are represented in
  180.    several different tables, possibly defined in different MIBs.
  181.  
  182.    Most of the management information defined here may pertain to any
  183.    number of applications in a managed system.  The simplest way of
  184.    supporting this requirement within the SNMP information model is to
  185.    use tables.  This means that the management information for a
  186.    particular resource may be found in one or more rows of one or more
  187.    tables; the fact that this information pertains to a single resource
  188.    may be deduced from the index values used, possibly with the support
  189.    of mapping tables.  This also means that a single table may contain
  190.    management information relevant to a number of applications.  This
  191.    has significant implementation implications; see the implementation
  192.    issues section below for more information.
  193.  
  194.  
  195. 3.1.  Relationships to other MIBs
  196.  
  197.    This section will outline the relationships of the components of this
  198.    MIB (usually in the form of common indexing structures) to:
  199.  
  200.       -  the systems applications MIB [11]
  201.  
  202.       -  the host resources MIB [1]
  203.  
  204.       -  the entity MIB [8]
  205.  
  206.       -  the network services monitoring MIB [2]
  207.  
  208.  
  209. 3.1.1.  Relationship to NSM
  210.  
  211.    The Network Services Monitoring MIB [2] is defined as the base set of
  212.    attributes for managing network applications.  The Application MIB
  213.    extends includes information normally obtainable only from the
  214.    managed resource itself, rather than the supporting system.  Due to
  215.    differences in index representation, the relationship between the
  216.    Network Services Monitoring MIB and the Application MIB is not
  217.    formally defined.
  218.  
  219.  
  220.  
  221. Applmib Working Group     Expires December 1997                 [Page 4]
  222.  
  223. Internet Draft         Application Management MIB           10 July 1997
  224.  
  225.  
  226. 3.1.2.  Relationship to the System Application MIB
  227.  
  228.    The system application MIB defines attributes for management of
  229.    applications which can be realized without instrumenting an
  230.    application.  This specification extends that framework to include
  231.    additional attributes which will typically require instrumentation
  232.    within the managed resource.  The sysApplRunElmtIndex is the key
  233.    connection between these two MIBs; it is essential that
  234.    implementations of this MIB and of the system applications MIB
  235.    running concurrently on a given platform employ a consistent policy
  236.    for assigning this value to running application elements.
  237.  
  238.  
  239. 4.  MIB Structure
  240.  
  241.    This MIB is organized into several tables.  Information for a
  242.    particular running managed application would appear in the form of
  243.    entries in the appropriate tables.  The tables are:
  244.  
  245.       -  the open files table
  246.  
  247.       -  the open files cross-reference table
  248.  
  249.       -  the open connections table
  250.  
  251.       -  the transaction statistics tables
  252.  
  253.       -  the running application element status table
  254.  
  255.       -  the running application element control table
  256.  
  257.       -  the application component details table
  258.  
  259.       In order to support SNMPv1, SNMPv2, and SNMPv3 environments, in
  260.       cases where counter objects may potentially advance very rapidly,
  261.       both a sixty-four bit counter and two thirty-two bit counters have
  262.       been defined.
  263.  
  264.  
  265. 4.1.  The open files table
  266.  
  267.    The open files table contains one entry for each file in use by a
  268.    manageable running application element.  (See [11] for a detailed
  269.    definition of a running application element.)  The purpose of this
  270.    table is to identify the files in use and to record I/O activity on
  271.    each file attributable to a particular running application element.
  272.  
  273.    If multiple running application elements open the same file, there
  274.  
  275.  
  276.  
  277. Applmib Working Group     Expires December 1997                 [Page 5]
  278.  
  279. Internet Draft         Application Management MIB           10 July 1997
  280.  
  281.  
  282.    will be an entry for each running application element opening that
  283.    file.  Similarly, if a running application element opens a file
  284.    multiple times, there will be an entry in this table for the file
  285.    corresponding to each open.
  286.  
  287.    The task of combining the information for file activity from this
  288.    table (organized by running application element) into per-application
  289.    statistics can be accomplished by a manager using the System
  290.    Application MIB's [11] sysApplInstallPkgTable to find the installed
  291.    application, the sysApplRunTable to find the running instances of
  292.    that application, and the sysApplElmtRunTable to find the relevant
  293.    values of sysApplElmtRunIndex.  The manager, armed with a set of
  294.    values for sysApplElmtRunIndex, is now able to retrieve the relevant
  295.    portions of the applOpenFileTable and other tables in this MIB.
  296.  
  297.    Entries in this table are indexed by the application run index and an
  298.    arbitrary integer, chosen so that taken together the application run
  299.    index and this integer yield a unique key for each open file.  The
  300.    following information is available in this table:
  301.  
  302.       -  file name
  303.  
  304.       -  number of read requests
  305.  
  306.       -  number of bytes read
  307.  
  308.       -  time at which most recent read operation was initiated
  309.  
  310.       -  number of write requests
  311.  
  312.       -  number of bytes written
  313.  
  314.       -  time at which most recnt write operation was initiated
  315.  
  316.       -  number of seek operations
  317.  
  318.       -  file size
  319.  
  320.       -  permissions with which file was opened
  321.  
  322.       Special cases to consider: stdin, stdout, stderr, etc. may require
  323.       some special handling.
  324.  
  325.  
  326. 4.2.  The open files cross-reference table
  327.  
  328.    This table provides a way to efficiently determine which processes
  329.    are currently holding a file open.  It introduces no new attributes
  330.  
  331.  
  332.  
  333. Applmib Working Group     Expires December 1997                 [Page 6]
  334.  
  335. Internet Draft         Application Management MIB           10 July 1997
  336.  
  337.  
  338.    of its own, and merely provides an alternative indexing to the open
  339.    file table.
  340.  
  341.  
  342. 4.3.  The open connections table
  343.  
  344.    This table extends the capabilities provided by the network services
  345.    monitoring MIB [2].  It includes:
  346.  
  347.       -  time at which the connection was opened
  348.  
  349.       -  identification of the transport protocol in use
  350.  
  351.       -  near-end address and port
  352.  
  353.       -  far-end address and port
  354.  
  355.       -  identification of the application layer protocol in use
  356.  
  357.       -  number of read requests
  358.  
  359.       -  number of bytes received
  360.  
  361.       -  time at which the most recent read request was initiated
  362.  
  363.       -  number of write requests
  364.  
  365.       -  number of bytes transmitted
  366.  
  367.       -  time at which most recent write request was initiated
  368.  
  369.  
  370. 4.4.  The transaction statistics tables
  371.  
  372.    Entries in the transaction statistics table are indexed by the
  373.    application element run index and an arbitrary integer, chosen so
  374.    that taken together the application run index and this integer yield
  375.    a unique key for each transaction stream associated with the running
  376.    application element.  A transaction stream may be a file or a
  377.    connection; a column in this table contains the OBJECT IDENTIFIER of
  378.    the instance of applOpenConnectionOpenTime or applOpenFileOpenTime,
  379.    in the open files table or open connections table respectively.  The
  380.    information recorded in the entries of this table includes:
  381.  
  382.       -  Number of requests issued
  383.  
  384.       -  Bytes of requests issued
  385.  
  386.  
  387.  
  388.  
  389. Applmib Working Group     Expires December 1997                 [Page 7]
  390.  
  391. Internet Draft         Application Management MIB           10 July 1997
  392.  
  393.  
  394.       -  Time at which most recent request was issued
  395.  
  396.       -  Number of responses issued
  397.  
  398.       -  Bytes of responses issued
  399.  
  400.       -  Time at which most recent response was issued
  401.  
  402.       -  Number of requests received
  403.  
  404.       -  Bytes of requests received
  405.  
  406.       -  Time at which most recent request was received
  407.  
  408.       -  Number of responses received
  409.  
  410.       -  Bytes of responses received
  411.  
  412.       -  Time at which most recent response was received
  413.  
  414.       -  Cumulative time between transmission of requests and receipt of
  415.          corresponding responses
  416.  
  417.       -  Cumulative time between receipt of requests and transmission of
  418.          corresponding responses
  419.  
  420.  
  421. 4.5.  The running application element status table
  422.  
  423.    This table provides information for a running application element.
  424.    Indexed by the sysApplElmtRunIndex, an entry in this table reports
  425.    useful information on that running element's resource usage.  Entries
  426.    in this table contain:
  427.  
  428.       -  current heap usage for this running application element
  429.  
  430.       -  current number of open network connections for this running
  431.          application element
  432.  
  433.       Note that other information, such as the current number of open
  434.       files for this running application element, is available from the
  435.       sysapplElmtRunTable in [11].
  436.  
  437.  
  438. 4.6.  The running application element control table
  439.  
  440.    This table provides rudimentary control over a running application
  441.    element.  Indexed by the sysApplElmtRunIndex, an entry in this table
  442.  
  443.  
  444.  
  445. Applmib Working Group     Expires December 1997                 [Page 8]
  446.  
  447. Internet Draft         Application Management MIB           10 July 1997
  448.  
  449.  
  450.    gives a manager with appropriate permissions the ability to suspend
  451.    and resume processing by this running element, the ability to request
  452.    reconfiguration, and the ability to terminate the running element.
  453.  
  454.    Variables in this table include:
  455.  
  456.       -  a suspend/resume control
  457.  
  458.       -  a reconfiguration request control
  459.  
  460.       -  a termination request control
  461.  
  462.  
  463. 4.7.  The application component details table
  464.  
  465.    This table provides time stamps, current size, ownership, and other
  466.    information as it extends the sysApplInstallElmt table.
  467.  
  468.  
  469. 5.  Definitions
  470.  
  471.  
  472.    APPLICATION-MIB DEFINITIONS ::= BEGIN
  473.  
  474.    IMPORTS
  475.        MODULE-IDENTITY, OBJECT-TYPE,
  476.            Counter64, Counter32, Gauge32, mib-2,
  477.            Unsigned32                      FROM SNMPv2-SMI
  478.  
  479.        DateAndTime, RowPointer,
  480.            TAddress, TestAndIncr, TDomain, TimeStamp,
  481.            TruthValue                      FROM SNMPv2-TC
  482.  
  483.        MODULE-COMPLIANCE, OBJECT-GROUP
  484.                                             FROM SNMPv2-CONF
  485.  
  486.        LongUtf8String,
  487.             sysApplElmtRunIndex,
  488.             Utf8String                      FROM SYSAPPL-MIB;
  489.  
  490.    applicationMib MODULE-IDENTITY
  491.        LAST-UPDATED "9707080910Z"
  492.        ORGANIZATION "Application MIB Working Group"
  493.        CONTACT-INFO
  494.            "Randy Presuhn
  495.             BMC Software, Inc.
  496.             1190 Saratoga Avenue, Suite 100
  497.             San Jose, CA 95129
  498.  
  499.  
  500.  
  501. Applmib Working Group     Expires December 1997                 [Page 9]
  502.  
  503. Internet Draft         Application Management MIB           10 July 1997
  504.  
  505.  
  506.             USA
  507.  
  508.             Telephone: +1 800 841-2031
  509.             Facsimile: +1 408 556-0735
  510.             Email: rpresuhn@bmc.com
  511.            "
  512.        DESCRIPTION
  513.            "This MIB defines objects representing generic
  514.             aspects of applications that are of interest to
  515.             management but typically require instrumentation
  516.             within the managed application element.
  517.            "
  518.        ::= { mib-2 3333333333 }
  519.    --ISSUE: need to get assignment for registration
  520.  
  521.    --
  522.    --      Registration hierarchy for this MIB
  523.    --
  524.    applicationMibObjects OBJECT IDENTIFIER ::=
  525.                             { applicationMib 1 }
  526.  
  527.    applicationMibTraps OBJECT IDENTIFIER ::=
  528.                             { applicationMib 2 }
  529.  
  530.    applicationMibConformance OBJECT IDENTIFIER ::=
  531.                             { applicationMib 3 }
  532.  
  533.  
  534.    --
  535.    --      Groups defined in this MIB
  536.    --
  537.    applFileGroup OBJECT IDENTIFIER ::=
  538.                             { applicationMibObjects 1 }
  539.  
  540.    applConnectionGroup OBJECT IDENTIFIER ::=
  541.                             { applicationMibObjects 2 }
  542.  
  543.    applExConnectionGroup OBJECT IDENTIFIER ::=
  544.                             { applicationMibObjects 3 }
  545.  
  546.    applTransactionGroup OBJECT IDENTIFIER ::=
  547.                             { applicationMibObjects 4 }
  548.  
  549.    applElmtRunControlGroup OBJECT IDENTIFIER ::=
  550.                             { applicationMibObjects 5 }
  551.  
  552.  
  553.    -- *************************************************************
  554.  
  555.  
  556.  
  557. Applmib Working Group     Expires December 1997                [Page 10]
  558.  
  559. Internet Draft         Application Management MIB           10 July 1997
  560.  
  561.  
  562.    --
  563.    --      applOpenFileTable - Table of Open Files
  564.    --
  565.    -- *************************************************************
  566.  
  567.    applOpenFileTable OBJECT-TYPE
  568.            SYNTAX          SEQUENCE OF ApplOpenFileEntry
  569.            MAX-ACCESS      not-accessible
  570.            STATUS          current
  571.            DESCRIPTION
  572.              "The applOpenFileTable reports information on open
  573.               files for running application elements.   This table
  574.               is indexed by sysApplElmtRunIndex [11], effectively
  575.               grouping all entries for a given running application
  576.               element together, and by applOpenFileId, uniquely
  577.               identifying an open file within the context of a
  578.               particular running application element.
  579.  
  580.               Several of this table's columnar objects appear in
  581.               sixty-four and thirty-two bit pairs.  The sixty-four
  582.               bit counters are not accessible in protocols that
  583.               do not support this data type."
  584.            ::= { applFileGroup 1 }
  585.  
  586.    ApplOpenFileEntry  ::= SEQUENCE
  587.            {
  588.                    applOpenFileId                  Unsigned32,
  589.                    applOpenFileOpenTime            TimeStamp,
  590.                    applOpenFileName                LongUtf8String,
  591.                    applOpenFileReadRequests        Counter64,
  592.                    applOpenFileReadRequestsLow     Counter32,
  593.                    applOpenFileBytesRead           Counter64,
  594.                    applOpenFileBytesReadLow        Counter32,
  595.                    applOpenFileLastReadTime        DateAndTime,
  596.                    applOpenFileWriteRequests       Counter64,
  597.                    applOpenFileWriteRequestsLow    Counter32,
  598.                    applOpenFileBytesWritten        Counter64,
  599.                    applOpenFileBytesWrittenLow     Counter32,
  600.                    applOpenFileLastWriteTime       DateAndTime,
  601.                    applOpenFileSeekRequests        Counter64,
  602.                    applOpenFileSeekRequestsLow     Counter32,
  603.                    applOpenFileSizeHigh            Unsigned32,
  604.                    applOpenFileSizeLow             Unsigned32,
  605.                    applOpenFileOpenMode            OCTET STRING
  606.            }
  607.  
  608.    applOpenFileEntry       OBJECT-TYPE
  609.            SYNTAX          ApplOpenFileEntry
  610.  
  611.  
  612.  
  613. Applmib Working Group     Expires December 1997                [Page 11]
  614.  
  615. Internet Draft         Application Management MIB           10 July 1997
  616.  
  617.  
  618.            MAX-ACCESS      not-accessible
  619.            STATUS          current
  620.            DESCRIPTION
  621.              "An applOpenFileEntry indicates that a file has been
  622.               opened by this running application element and is
  623.               still open.  Note that if a file has been opened
  624.               multiple times, even by the same process, it may
  625.               have multiple entries."
  626.            INDEX           { sysApplElmtRunIndex, applOpenFileId }
  627.            ::= { applOpenFileTable 1 }
  628.  
  629.    applOpenFileId          OBJECT-TYPE
  630.            SYNTAX          Unsigned32
  631.            MAX-ACCESS      not-accessible
  632.            STATUS          current
  633.            DESCRIPTION
  634.              "This attribute serves to uniquely identify this
  635.               open file in the context of the running application
  636.               element.  When practical, the native file descriptor
  637.               number shall be used."
  638.            ::= { applOpenFileEntry 1 }
  639.  
  640.    applOpenFileOpenTime    OBJECT-TYPE
  641.            SYNTAX          TimeStamp
  642.            MAX-ACCESS      read-only
  643.            STATUS          current
  644.            DESCRIPTION
  645.              "This attribute records the value of sysUptime.0
  646.               when this file was opened and this entry was
  647.               added to this table.  This attribute serves as a
  648.               discontinuity indicator for the counter attributes
  649.               in this entry."
  650.            ::= { applOpenFileEntry 2 }
  651.  
  652.    applOpenFileName        OBJECT-TYPE
  653.            SYNTAX          LongUtf8String
  654.            MAX-ACCESS      read-only
  655.            STATUS          current
  656.            DESCRIPTION
  657.              "This attribute reports the name of this open file.
  658.               Wherever practical, a fully qualified path name
  659.               should be reported.
  660.  
  661.               The values 'stdin', 'stdout', and 'stderr' are
  662.               reserved in accordance with common usage."
  663.            ::= { applOpenFileEntry 3 }
  664.  
  665.    applOpenFileReadRequests        OBJECT-TYPE
  666.  
  667.  
  668.  
  669. Applmib Working Group     Expires December 1997                [Page 12]
  670.  
  671. Internet Draft         Application Management MIB           10 July 1997
  672.  
  673.  
  674.            SYNTAX          Counter64
  675.            UNITS           "read requests"
  676.            MAX-ACCESS      read-only
  677.            STATUS          current
  678.            DESCRIPTION
  679.              "This attribute reports the number of read requests
  680.               for this file made by this running application
  681.               element.  All read requests for this file by
  682.               this running application element, regardless of
  683.               completion status, are included in this count.
  684.  
  685.               Discontinuities in this counter can be detected
  686.               by monitoring the applOpenFileOpenTime value for
  687.               this entry."
  688.            ::= { applOpenFileEntry 4 }
  689.  
  690.    applOpenFileReadRequestsLow     OBJECT-TYPE
  691.            SYNTAX          Counter32
  692.            UNITS           "read requests"
  693.            MAX-ACCESS      read-only
  694.            STATUS          current
  695.            DESCRIPTION
  696.              "This attribute reports the low thirty-two
  697.               bits of applOpenFileReadRequests.
  698.  
  699.               Discontinuities in this counter can be detected
  700.               by monitoring the applOpenFileOpenTime value for
  701.               this entry."
  702.            ::= { applOpenFileEntry 5 }
  703.  
  704.    applOpenFileBytesRead   OBJECT-TYPE
  705.            SYNTAX          Counter64
  706.            UNITS           "bytes"
  707.            MAX-ACCESS      read-only
  708.            STATUS          current
  709.            DESCRIPTION
  710.              "This attribute reports the number of bytes read
  711.               from this file by this running application element.
  712.               Only bytes successfully read are included in
  713.               this count.
  714.  
  715.               Discontinuities in this counter can be detected
  716.               by monitoring the applOpenFileOpenTime value for
  717.               this entry."
  718.            ::= { applOpenFileEntry 6 }
  719.  
  720.    applOpenFileBytesReadLow   OBJECT-TYPE
  721.            SYNTAX          Counter32
  722.  
  723.  
  724.  
  725. Applmib Working Group     Expires December 1997                [Page 13]
  726.  
  727. Internet Draft         Application Management MIB           10 July 1997
  728.  
  729.  
  730.            UNITS           "bytes"
  731.            MAX-ACCESS      read-only
  732.            STATUS          current
  733.            DESCRIPTION
  734.              "This attribute corresponds to the low thirty-
  735.               two bits of applOpenFileBytesRead.
  736.  
  737.               Discontinuities in this counter can be detected
  738.               by monitoring the applOpenFileOpenTime value for
  739.               this entry."
  740.            ::= { applOpenFileEntry 7 }
  741.  
  742.    applOpenFileLastReadTime        OBJECT-TYPE
  743.            SYNTAX          DateAndTime
  744.            MAX-ACCESS      read-only
  745.            STATUS          current
  746.            DESCRIPTION
  747.              "This attribute reports the time of the most
  748.               recent read request made by this running application
  749.               element, regardless of completion status, for this
  750.               open file.
  751.  
  752.               If no read requests have been made by this running
  753.               application element, the value of this attribute
  754.               shall be '0000000000000000'H "
  755.            DEFVAL { '0000000000000000'H }
  756.            ::= { applOpenFileEntry 8 }
  757.  
  758.    applOpenFileWriteRequests       OBJECT-TYPE
  759.            SYNTAX          Counter64
  760.            UNITS           "write requests"
  761.            MAX-ACCESS      read-only
  762.            STATUS          current
  763.            DESCRIPTION
  764.              "This attribute reports the number of write requests
  765.               for this file made by this running application
  766.               element.  All write requests for this file by
  767.               this running application element, regardless of
  768.               completion status, are included in this count.
  769.  
  770.               Discontinuities in this counter can be detected
  771.               by monitoring the applOpenFileOpenTime value for
  772.               this entry."
  773.            ::= { applOpenFileEntry 9 }
  774.  
  775.  
  776.    applOpenFileWriteRequestsLow       OBJECT-TYPE
  777.            SYNTAX          Counter32
  778.  
  779.  
  780.  
  781. Applmib Working Group     Expires December 1997                [Page 14]
  782.  
  783. Internet Draft         Application Management MIB           10 July 1997
  784.  
  785.  
  786.            UNITS           "write requests"
  787.            MAX-ACCESS      read-only
  788.            STATUS          current
  789.            DESCRIPTION
  790.              "This attribute corresponds to the low thirty-
  791.               two bits of applOpenFileWriteRequests.
  792.  
  793.               Discontinuities in this counter can be detected
  794.               by monitoring the applOpenFileOpenTime value for
  795.               this entry."
  796.            ::= { applOpenFileEntry 10 }
  797.  
  798.    applOpenFileBytesWritten        OBJECT-TYPE
  799.            SYNTAX          Counter64
  800.            UNITS           "bytes"
  801.            MAX-ACCESS      read-only
  802.            STATUS          current
  803.            DESCRIPTION
  804.              "This attribute reports the number of bytes written
  805.               to this file by this running application
  806.               element.  Only bytes successfully written (no errors
  807.               reported by the API in use by the application)
  808.               are included in this count.
  809.  
  810.               Discontinuities in this counter can be detected
  811.               by monitoring the applOpenFileOpenTime value for
  812.               this entry."
  813.            ::= { applOpenFileEntry 11 }
  814.  
  815.    applOpenFileBytesWrittenLow        OBJECT-TYPE
  816.            SYNTAX          Counter32
  817.            UNITS           "bytes"
  818.            MAX-ACCESS      read-only
  819.            STATUS          current
  820.            DESCRIPTION
  821.              "This attribute corresponds to the low thirty-
  822.               two bits of applOpenFileBytesWritten.
  823.  
  824.               Discontinuities in this counter can be detected
  825.               by monitoring the applOpenFileOpenTime value for
  826.               this entry."
  827.            ::= { applOpenFileEntry 12 }
  828.  
  829.    applOpenFileLastWriteTime       OBJECT-TYPE
  830.            SYNTAX          DateAndTime
  831.            MAX-ACCESS      read-only
  832.            STATUS          current
  833.            DESCRIPTION
  834.  
  835.  
  836.  
  837. Applmib Working Group     Expires December 1997                [Page 15]
  838.  
  839. Internet Draft         Application Management MIB           10 July 1997
  840.  
  841.  
  842.              "This attribute reports the time of the most
  843.               recent write request made by this running
  844.               application element, regardless of completion
  845.               status, for this open file.
  846.  
  847.               If no write requests have been made by this running
  848.               application element, the value of this attribute
  849.               shall be '0000000000000000'H "
  850.            DEFVAL { '0000000000000000'H }
  851.            ::= { applOpenFileEntry 13 }
  852.  
  853.    applOpenFileSeekRequests        OBJECT-TYPE
  854.            SYNTAX          Counter64
  855.            UNITS           "seek requests"
  856.            MAX-ACCESS      read-only
  857.            STATUS          current
  858.            DESCRIPTION
  859.              "This attribute reports the number of seek requests
  860.               made on this open file.
  861.  
  862.               Discontinuities in this counter can be detected
  863.               by monitoring the applOpenFileOpenTime value for
  864.               this entry."
  865.            ::= { applOpenFileEntry 14 }
  866.  
  867.    applOpenFileSeekRequestsLow        OBJECT-TYPE
  868.            SYNTAX          Counter32
  869.            UNITS           "seek requests"
  870.            MAX-ACCESS      read-only
  871.            STATUS          current
  872.            DESCRIPTION
  873.              "This attribute corresponds to the low thirty-
  874.               two bits of applOpenFileSeekRequests.
  875.  
  876.               Discontinuities in this counter can be detected
  877.               by monitoring the applOpenFileOpenTime value for
  878.               this entry."
  879.            ::= { applOpenFileEntry 15 }
  880.  
  881.    applOpenFileSizeHigh    OBJECT-TYPE
  882.            SYNTAX          Unsigned32
  883.            UNITS           "2^32 byte blocks"
  884.            MAX-ACCESS      read-only
  885.            STATUS          current
  886.            DESCRIPTION
  887.              "This file's current size in 2^32 byte blocks.
  888.  
  889.               For example, for a file with a total size of
  890.  
  891.  
  892.  
  893. Applmib Working Group     Expires December 1997                [Page 16]
  894.  
  895. Internet Draft         Application Management MIB           10 July 1997
  896.  
  897.  
  898.               4,294,967,296 bytes, this attribute would have
  899.               a value of 1; for a file with a total size of
  900.               4,294,967,295 bytes this attribute's value would
  901.               be 0."
  902.            ::= { applOpenFileEntry 16 }
  903.  
  904.    applOpenFileSizeLow     OBJECT-TYPE
  905.            SYNTAX          Unsigned32
  906.            UNITS           "bytes"
  907.            MAX-ACCESS      read-only
  908.            STATUS          current
  909.            DESCRIPTION
  910.              "This file's current size modulo 2^32 bytes.
  911.  
  912.               For example, for a file with a total size of
  913.               4,294,967,296 bytes this attribute would have
  914.               a value of 0; for a file with a total size of
  915.               4,294,967,295 bytes this attribute's value would
  916.               be 4,294,967,295."
  917.            ::= { applOpenFileEntry 17 }
  918.  
  919.    applOpenFileOpenMode    OBJECT-TYPE
  920.            SYNTAX          BITS { read(0),
  921.                                   write(1) }
  922.            MAX-ACCESS      read-only
  923.            STATUS          current
  924.            DESCRIPTION
  925.              "This attribute reports the mode in which the file
  926.               was most recently opened by this running application
  927.               element.
  928.  
  929.               These bits correspond to the Posix/ANSI C library
  930.               function fopen() 'type' parameter, using the
  931.               following mappings:
  932.  
  933.                    r -> read(0)
  934.                    w -> write(1)
  935.                    a -> write(1)
  936.                    + -> read(0), write(1)
  937.  
  938.               These bits have the following meanings:
  939.  
  940.                    read(0) - the file was opened for reading
  941.                    write(1) - the file was opened for writing."
  942.            ::= { applOpenFileEntry 18 }
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949. Applmib Working Group     Expires December 1997                [Page 17]
  950.  
  951. Internet Draft         Application Management MIB           10 July 1997
  952.  
  953.  
  954.    -- *************************************************************
  955.    --
  956.    --      applOpenFileXrefTable - Open File cross-reference table
  957.    --
  958.    -- *************************************************************
  959.  
  960.    applOpenFileXrefTable OBJECT-TYPE
  961.            SYNTAX          SEQUENCE OF ApplOpenFileXrefEntry
  962.            MAX-ACCESS      not-accessible
  963.            STATUS          current
  964.            DESCRIPTION
  965.              "The applOpenFileXrefTable provides an alternative
  966.               indexing to the information in the
  967.               applOpenFileTable.  Rather than grouping entries by
  968.               sysApplElmtRunIndex, it groups them by their names
  969.               (applOpenXrefFileName is a potentially truncated
  970.               applOpenFileName).  Since in many environments
  971.               multiple processes may concurrently open a file,
  972.               and a single process may open a file multiple
  973.               times, entries in this table are also indexed by
  974.               sysApplElmtRunIndex and applOpenFileId."
  975.            ::= { applFileGroup 2 }
  976.  
  977.    ApplOpenFileXrefEntry  ::= SEQUENCE
  978.            {
  979.                    applOpenFileXrefName    Utf8String,
  980.                    applOpenFileXrefId      Unsigned32
  981.            }
  982.  
  983.    applOpenFileXrefEntry   OBJECT-TYPE
  984.            SYNTAX          ApplOpenFileXrefEntry
  985.            MAX-ACCESS      not-accessible
  986.            STATUS          current
  987.            DESCRIPTION
  988.              "An applOpenFileXrefEntry indicates that a file
  989.               has been opened by a running application element.
  990.               Note that if a file has been opened multiple
  991.               times, even by the same process, it may have
  992.               multiple entries.
  993.  
  994.               Note that the SMI limitation on the maximum number
  995.               of components in an OBJECT IDENTIFIERS means that
  996.               the full name of an open file may be too long to
  997.               use directly as an index.  In such cases, the name
  998.               is truncated for purposes of indexing."
  999.            INDEX           { applOpenFileXrefName,
  1000.                              sysApplElmtRunIndex,
  1001.                              applOpenFileXrefId }
  1002.  
  1003.  
  1004.  
  1005. Applmib Working Group     Expires December 1997                [Page 18]
  1006.  
  1007. Internet Draft         Application Management MIB           10 July 1997
  1008.  
  1009.  
  1010.            ::= { applOpenFileXrefTable 1 }
  1011.  
  1012.    applOpenFileXrefName    OBJECT-TYPE
  1013.            SYNTAX          Utf8String (SIZE (0 .. 114 ))
  1014.            MAX-ACCESS      not-accessible
  1015.            STATUS          current
  1016.            DESCRIPTION
  1017.              "This index corresponds to applOpenFileName.
  1018.               This index's value is equal to that of
  1019.               applOpenFileName after truncation to this
  1020.               attribute's maximum length.  This length
  1021.               limitation is made necessary by SNMP's limits
  1022.               on maximum object identifier length."
  1023.            ::= { applOpenFileXrefEntry 1 }
  1024.  
  1025.    applOpenFileXrefId      OBJECT-TYPE
  1026.            SYNTAX          Unsigned32
  1027.            MAX-ACCESS      read-only
  1028.            STATUS          current
  1029.            DESCRIPTION
  1030.              "This attribute serves to uniquely identify this
  1031.               open file in the context of the running application
  1032.               element.  Where suitable, the native file descriptor
  1033.               number may be used.  This attribute is like
  1034.               applOpenFileId, only accessible."
  1035.            ::= { applOpenFileXrefEntry 2 }
  1036.  
  1037.  
  1038.  
  1039.  
  1040.    -- *************************************************************
  1041.    --
  1042.    --      applOpenConnectionTable - Open Connection Table
  1043.    --
  1044.    -- *************************************************************
  1045.  
  1046.    applOpenConnectionTable OBJECT-TYPE
  1047.            SYNTAX          SEQUENCE OF ApplOpenConnectionEntry
  1048.            MAX-ACCESS      not-accessible
  1049.            STATUS          current
  1050.            DESCRIPTION
  1051.              "The applOpenConnectionTable provides information
  1052.               about open connections from the perspective of
  1053.               the running application element.  Entries in this
  1054.               table are indexed by sysApplElmtRunIndex and by
  1055.               applOpenConnectionId, which serves to uniquely
  1056.               identify each connection in the context of a
  1057.               running application element."
  1058.  
  1059.  
  1060.  
  1061. Applmib Working Group     Expires December 1997                [Page 19]
  1062.  
  1063. Internet Draft         Application Management MIB           10 July 1997
  1064.  
  1065.  
  1066.            ::= { applConnectionGroup 1 }
  1067.  
  1068.    ApplOpenConnectionEntry  ::= SEQUENCE
  1069.            {
  1070.                    applOpenConnectionId            Unsigned32,
  1071.                    applOpenConnectionOpenTime      TimeStamp,
  1072.                    applOpenConnectionTransport     TDomain,
  1073.                    applOpenConnectionNearEndAddr   TAddress,
  1074.                    applOpenConnectionNearEndFqdn   Utf8String,
  1075.                    applOpenConnectionFarEndAddr    TAddress,
  1076.                    applOpenConnectionFarEndFqdn    Utf8String,
  1077.                    applOpenConnectionApplication   Utf8String,
  1078.                    applOpenConnectionReadRequests  Counter64,
  1079.                    applOpenConnectionReadReqsLow   Counter32,
  1080.                    applOpenConnectionBytesRead     Counter64,
  1081.                    applOpenConnectionBytesReadLow  Counter32,
  1082.                    applOpenConnectionLastReadTime  DateAndTime,
  1083.                    applOpenConnectionWriteRequests Counter64,
  1084.                    applOpenConnectionWriteReqsLow  Counter32,
  1085.                    applOpenConnectionBytesWritten  Counter64,
  1086.                    applOpenConnectionBytesWritLow  Counter32,
  1087.                    applOpenConnectionLastWriteTime DateAndTime
  1088.            }
  1089.  
  1090.    applOpenConnectionEntry OBJECT-TYPE
  1091.            SYNTAX          ApplOpenConnectionEntry
  1092.            MAX-ACCESS      not-accessible
  1093.            STATUS          current
  1094.            DESCRIPTION
  1095.              "An applOpenConnectionEntry indicates that a
  1096.               running application element has an open connection.
  1097.               The entry has information describing that
  1098.               connection."
  1099.            INDEX           { sysApplElmtRunIndex,
  1100.                              applOpenConnectionId }
  1101.            ::= { applOpenConnectionTable 1 }
  1102.  
  1103.    applOpenConnectionId    OBJECT-TYPE
  1104.            SYNTAX          Unsigned32
  1105.            MAX-ACCESS      not-accessible
  1106.            STATUS          current
  1107.            DESCRIPTION
  1108.              "This attribute serves to uniquely identify this open
  1109.               connection in the context of the running application
  1110.               element.  Where suitable, the application's native
  1111.               descriptor number may be used."
  1112.            ::= { applOpenConnectionEntry 1 }
  1113.  
  1114.  
  1115.  
  1116.  
  1117. Applmib Working Group     Expires December 1997                [Page 20]
  1118.  
  1119. Internet Draft         Application Management MIB           10 July 1997
  1120.  
  1121.  
  1122.    applOpenConnectionOpenTime      OBJECT-TYPE
  1123.            SYNTAX          TimeStamp
  1124.            MAX-ACCESS      read-only
  1125.            STATUS          current
  1126.            DESCRIPTION
  1127.              "This attribute records the value of sysUptime.0
  1128.               when this connection was opened and this entry was
  1129.               added to this table.  This attribute serves as a
  1130.               discontinuity indicator for the counter attributes
  1131.               in this entry."
  1132.            ::= { applOpenConnectionEntry 2 }
  1133.  
  1134.    applOpenConnectionTransport     OBJECT-TYPE
  1135.            SYNTAX          TDomain
  1136.            MAX-ACCESS      read-only
  1137.            STATUS          current
  1138.            DESCRIPTION
  1139.              "The applOpenConnectionTransport attribute
  1140.               identifies the transport protocol in use for
  1141.               this connection.  If it is not practical
  1142.               to determine the underlying transport, this
  1143.               attribute's value shall have a value of {0 0}."
  1144.            DEFVAL { { 0 0 } }
  1145.            ::= { applOpenConnectionEntry 3 }
  1146.  
  1147.    applOpenConnectionNearEndAddr       OBJECT-TYPE
  1148.            SYNTAX          TAddress
  1149.            MAX-ACCESS      read-only
  1150.            STATUS          current
  1151.            DESCRIPTION
  1152.              "The applOpenConnectionNearEndAddr attribute reports
  1153.               the transport address and port information for
  1154.               the near end of this connection.
  1155.  
  1156.               If the value is not known, the value has a  length
  1157.               of zero."
  1158.            DEFVAL { "" }
  1159.            ::= { applOpenConnectionEntry 4 }
  1160.  
  1161.    applOpenConnectionNearEndFqdn       OBJECT-TYPE
  1162.            SYNTAX          Utf8String
  1163.            MAX-ACCESS      read-only
  1164.            STATUS          current
  1165.            DESCRIPTION
  1166.              "The applOpenConnectionNearEndFqdn attribute reports
  1167.               the fully-qualified domain name and port information
  1168.               for the near end of this connection.
  1169.  
  1170.  
  1171.  
  1172.  
  1173. Applmib Working Group     Expires December 1997                [Page 21]
  1174.  
  1175. Internet Draft         Application Management MIB           10 July 1997
  1176.  
  1177.  
  1178.               If the value is not known, the value has a  length
  1179.               of zero."
  1180.            DEFVAL { "" }
  1181.            ::= { applOpenConnectionEntry 5 }
  1182.  
  1183.    applOpenConnectionFarEndAddr        OBJECT-TYPE
  1184.            SYNTAX          TAddress
  1185.            MAX-ACCESS      read-only
  1186.            STATUS          current
  1187.            DESCRIPTION
  1188.              "The applOpenConnectionFarEndAddr attribute reports
  1189.               the transport address and port information for
  1190.               the far end of this connection.
  1191.  
  1192.               If not known, as in the case of a connectionless
  1193.               transport, the value of this attribute shall be
  1194.               a zero-length string."
  1195.            DEFVAL { "" }
  1196.            ::= { applOpenConnectionEntry 6 }
  1197.  
  1198.    applOpenConnectionFarEndFqdn        OBJECT-TYPE
  1199.            SYNTAX          Utf8String
  1200.            MAX-ACCESS      read-only
  1201.            STATUS          current
  1202.            DESCRIPTION
  1203.              "The applOpenConnectionFarEndFqdn attribute reports
  1204.               the fully-qualified domain name for
  1205.               the far end of this connection.
  1206.  
  1207.               If not known, as in the case of a connectionless
  1208.               transport, the value of this attribute shall be
  1209.               a zero-length string."
  1210.            DEFVAL { "" }
  1211.            ::= { applOpenConnectionEntry 7 }
  1212.  
  1213.    applOpenConnectionApplication   OBJECT-TYPE
  1214.            SYNTAX          Utf8String
  1215.            MAX-ACCESS      read-only
  1216.            STATUS          current
  1217.            DESCRIPTION
  1218.              "The applOpenConnectionApplication attribute
  1219.               identifies the application layer protocol in use.
  1220.               If not known, the value of this attribute shall
  1221.               be a zero-length string.
  1222.  
  1223.               When possible, protocol names should be
  1224.               those used in the 'ASSIGNED NUMBERS' [16].
  1225.               For example, an SMTP mail server would use 'SMTP'."
  1226.  
  1227.  
  1228.  
  1229. Applmib Working Group     Expires December 1997                [Page 22]
  1230.  
  1231. Internet Draft         Application Management MIB           10 July 1997
  1232.  
  1233.  
  1234.            DEFVAL { "" }
  1235.            ::= { applOpenConnectionEntry 8 }
  1236.  
  1237.    applOpenConnectionReadRequests  OBJECT-TYPE
  1238.            SYNTAX          Counter64
  1239.            UNITS           "read requests"
  1240.            MAX-ACCESS      read-only
  1241.            STATUS          current
  1242.            DESCRIPTION
  1243.              "This attribute reports the number of read requests
  1244.               for this connection made by this running application
  1245.               element.  All read requests for this connection
  1246.               by this running application element, regardless
  1247.               of completion status, are included in this count.
  1248.  
  1249.               Discontinuities in this counter can be detected by
  1250.               monitoring the applOpenConnectionOpenTime attribute
  1251.               for this entry."
  1252.            ::= { applOpenConnectionEntry 9 }
  1253.  
  1254.    applOpenConnectionReadReqsLow  OBJECT-TYPE
  1255.            SYNTAX          Counter32
  1256.            UNITS           "read requests"
  1257.            MAX-ACCESS      read-only
  1258.            STATUS          current
  1259.            DESCRIPTION
  1260.              "This attribute corresponds to the low thirty-two
  1261.               bits of applOpenConnectionReadReqs.
  1262.  
  1263.               Discontinuities in this counter can be detected by
  1264.               monitoring the applOpenConnectionOpenTime attribute
  1265.               for this entry."
  1266.            ::= { applOpenConnectionEntry 10 }
  1267.  
  1268.    applOpenConnectionBytesRead     OBJECT-TYPE
  1269.            SYNTAX          Counter64
  1270.            UNITS           "bytes"
  1271.            MAX-ACCESS      read-only
  1272.            STATUS          current
  1273.            DESCRIPTION
  1274.              "This attribute reports the number of bytes read
  1275.               from this connection by this running application
  1276.               element.  Only bytes successfully read are included
  1277.               in this count.
  1278.  
  1279.               Discontinuities in this counter can be detected by
  1280.               monitoring the applOpenConnectionOpenTime attribute
  1281.               for this entry."
  1282.  
  1283.  
  1284.  
  1285. Applmib Working Group     Expires December 1997                [Page 23]
  1286.  
  1287. Internet Draft         Application Management MIB           10 July 1997
  1288.  
  1289.  
  1290.            ::= { applOpenConnectionEntry 11 }
  1291.  
  1292.    applOpenConnectionBytesReadLow     OBJECT-TYPE
  1293.            SYNTAX          Counter32
  1294.            UNITS           "bytes"
  1295.            MAX-ACCESS      read-only
  1296.            STATUS          current
  1297.            DESCRIPTION
  1298.              "This attribute corresponds to the low thirty-two
  1299.               bits of applOpenConnectionBytesRead.
  1300.  
  1301.               Discontinuities in this counter can be detected by
  1302.               monitoring the applOpenConnectionOpenTime attribute
  1303.               for this entry."
  1304.            ::= { applOpenConnectionEntry 12 }
  1305.  
  1306.    applOpenConnectionLastReadTime  OBJECT-TYPE
  1307.            SYNTAX          DateAndTime
  1308.            MAX-ACCESS      read-only
  1309.            STATUS          current
  1310.            DESCRIPTION
  1311.              "This attribute reports the time of the most
  1312.               recent read request made by this running application
  1313.               element, regardless of completion status, for this
  1314.               open connection.
  1315.  
  1316.               If no read requests have been made by this running
  1317.               application element for this connection, the value
  1318.               of this attribute shall be '0000000000000000'H "
  1319.            DEFVAL { '0000000000000000'H }
  1320.            ::= { applOpenConnectionEntry 13 }
  1321.  
  1322.    applOpenConnectionWriteRequests OBJECT-TYPE
  1323.            SYNTAX          Counter64
  1324.            UNITS           "write requests"
  1325.            MAX-ACCESS      read-only
  1326.            STATUS          current
  1327.            DESCRIPTION
  1328.              "The applOpenConnectionWriteRequests attribute
  1329.               reports the number of write requests, regardless of
  1330.               completion status, made by this running application
  1331.               element for this open connection.
  1332.  
  1333.               Discontinuities in this counter can be detected by
  1334.               monitoring the applOpenConnectionOpenTime attribute
  1335.               for this entry."
  1336.            ::= { applOpenConnectionEntry 14 }
  1337.  
  1338.  
  1339.  
  1340.  
  1341. Applmib Working Group     Expires December 1997                [Page 24]
  1342.  
  1343. Internet Draft         Application Management MIB           10 July 1997
  1344.  
  1345.  
  1346.    applOpenConnectionWriteReqsLow OBJECT-TYPE
  1347.            SYNTAX          Counter32
  1348.            UNITS           "write requests"
  1349.            MAX-ACCESS      read-only
  1350.            STATUS          current
  1351.            DESCRIPTION
  1352.              "This attribute corresponds to the low thirty-two
  1353.               bits of applOpenConnectionWriteRequests.
  1354.  
  1355.               Discontinuities in this counter can be detected by
  1356.               monitoring the applOpenConnectionOpenTime attribute
  1357.               for this entry."
  1358.            ::= { applOpenConnectionEntry 15 }
  1359.  
  1360.    applOpenConnectionBytesWritten  OBJECT-TYPE
  1361.            SYNTAX          Counter64
  1362.            UNITS           "bytes"
  1363.            MAX-ACCESS      read-only
  1364.            STATUS          current
  1365.            DESCRIPTION
  1366.              "This attribute reports the number of bytes written
  1367.               to this connection by this running application
  1368.               element.  Only bytes successfully written (no errors
  1369.               reported by the API in use by the application)
  1370.               are included in this count.
  1371.  
  1372.               Discontinuities in this counter can be detected by
  1373.               monitoring the applOpenConnectionOpenTime attribute
  1374.               for this entry."
  1375.            ::= { applOpenConnectionEntry 16 }
  1376.  
  1377.    applOpenConnectionBytesWritLow  OBJECT-TYPE
  1378.            SYNTAX          Counter32
  1379.            UNITS           "bytes"
  1380.            MAX-ACCESS      read-only
  1381.            STATUS          current
  1382.            DESCRIPTION
  1383.              "This attribute corresponds to the low thirty-two
  1384.               bits of applOpenConnectionBytesWritten.
  1385.  
  1386.               Discontinuities in this counter can be detected by
  1387.               monitoring the applOpenConnectionOpenTime attribute
  1388.               for this entry."
  1389.            ::= { applOpenConnectionEntry 17 }
  1390.  
  1391.    applOpenConnectionLastWriteTime OBJECT-TYPE
  1392.            SYNTAX          DateAndTime
  1393.            MAX-ACCESS      read-only
  1394.  
  1395.  
  1396.  
  1397. Applmib Working Group     Expires December 1997                [Page 25]
  1398.  
  1399. Internet Draft         Application Management MIB           10 July 1997
  1400.  
  1401.  
  1402.            STATUS          current
  1403.            DESCRIPTION
  1404.              "The applOpenConnectionLastWriteTime attribute
  1405.               reports the time of the most recent write request
  1406.               made by this running application element, regardless
  1407.               of completion status, for this open connection.
  1408.  
  1409.               If no write requests have been made by this running
  1410.               application element for this connection, the value
  1411.               of this attribute shall be '0000000000000000'H "
  1412.            DEFVAL { '0000000000000000'H }
  1413.            ::= { applOpenConnectionEntry 18 }
  1414.  
  1415.  
  1416.    -- *************************************************************
  1417.    --
  1418.    --      applExConnectionGroup - history information for former
  1419.    --      connections.  These tables control the collection of
  1420.    --      of connection history information and represent the
  1421.    --      accumlated historical data.
  1422.    --
  1423.    -- *************************************************************
  1424.  
  1425.  
  1426.    applExConnectionControlTable    OBJECT-TYPE
  1427.            SYNTAX          SEQUENCE OF ApplExConnectionControlEntry
  1428.            MAX-ACCESS      not-accessible
  1429.            STATUS          current
  1430.            DESCRIPTION
  1431.              "The applExConnectionControlTable controls the
  1432.               accumulation of history information about
  1433.               connections from the perspective of the running
  1434.               application element.  Entries in this table are
  1435.               indexed by sysApplElmtRunIndex, giving control
  1436.               of connection history accumulation at the
  1437.               level of each running application element."
  1438.            ::= { applExConnectionGroup 1 }
  1439.  
  1440.    ApplExConnectionControlEntry  ::= SEQUENCE
  1441.            {
  1442.                    applExConnectionControlCollect  INTEGER,
  1443.                    applExConnectionControlMaxRows  Unsigned32,
  1444.                    applExConnectionControlTimeLimit Unsigned32,
  1445.                    applExConnectionControlRemItems Counter32
  1446.            }
  1447.  
  1448.    applExConnectionControlEntry    OBJECT-TYPE
  1449.            SYNTAX          ApplExConnectionControlEntry
  1450.  
  1451.  
  1452.  
  1453. Applmib Working Group     Expires December 1997                [Page 26]
  1454.  
  1455. Internet Draft         Application Management MIB           10 July 1997
  1456.  
  1457.  
  1458.            MAX-ACCESS      not-accessible
  1459.            STATUS          current
  1460.            DESCRIPTION
  1461.              "An applExConnectionControlEntry provides the
  1462.               ability to control the retention of connection
  1463.               history information by a running application."
  1464.            INDEX           { sysApplElmtRunIndex }
  1465.            ::= { applExConnectionControlTable 1 }
  1466.  
  1467.    applExConnectionControlCollect  OBJECT-TYPE
  1468.            SYNTAX          INTEGER { enabled (1),
  1469.                                      frozen (2),
  1470.                                      disabled (3) }
  1471.            MAX-ACCESS      read-write
  1472.            STATUS          current
  1473.            DESCRIPTION
  1474.              "When the value of applExConnectionControlCollect is
  1475.               'enabled', each time the corresponding running
  1476.               application element closes an open connection a new
  1477.               entry will be added to the applExConnectionTable.
  1478.  
  1479.               When the value of applExConnectionControlCollect
  1480.               is 'frozen', no new entries are added to the
  1481.               applExConnectionTable for this running application
  1482.               element, and old entries are not aged out.
  1483.  
  1484.               When the value of applExConnectionControlCollect
  1485.               is 'disabled', all entries are removed from
  1486.               applExConnectionTable for this running application,
  1487.               and no new entries are added."
  1488.            ::= { applExConnectionControlEntry 1 }
  1489.  
  1490.    applExConnectionControlMaxRows  OBJECT-TYPE
  1491.            SYNTAX          Unsigned32
  1492.            UNITS           "connection history entries"
  1493.            MAX-ACCESS      read-write
  1494.            STATUS          current
  1495.            DESCRIPTION
  1496.              "The maximum number of entries allowed in the
  1497.               applExConnectionTable for this running application
  1498.               element.  Once the number of rows for this running
  1499.               application element in the applExConnectionTable
  1500.               reaches this value, the management subsystem will
  1501.               remove the oldest entry to make room for the new
  1502.               entry to be added.  Entries will be removed on
  1503.               the basis of oldest applExconnectionCloseTime
  1504.               value first."
  1505.            DEFVAL          { 500 }
  1506.  
  1507.  
  1508.  
  1509. Applmib Working Group     Expires December 1997                [Page 27]
  1510.  
  1511. Internet Draft         Application Management MIB           10 July 1997
  1512.  
  1513.  
  1514.            ::= { applExConnectionControlEntry 2 }
  1515.  
  1516.    applExConnectionControlTimeLimit        OBJECT-TYPE
  1517.            SYNTAX          Unsigned32
  1518.            UNITS           "seconds"
  1519.            MAX-ACCESS      read-write
  1520.            STATUS          current
  1521.            DESCRIPTION
  1522.              "The maximum time in seconds which an entry for this
  1523.               running application elementmay exist in the
  1524.               applExconnectionTable before it is removed.
  1525.               Any entry that is older than this value will be
  1526.               removed (aged out) from the table, unless the
  1527.               applExConnectionControlCollect is set to 'frozen'.
  1528.  
  1529.               Note that an entry may be aged out prior to
  1530.               reaching this time limit if it is the oldest
  1531.               entry in the table and must be removed to
  1532.               make space for a new entry so as to not
  1533.               exceed applExconnectionControlMaxRows, or if
  1534.               the applExConnectionControlCollect is set to
  1535.               'disabled'."
  1536.            DEFVAL          { 7200 }
  1537.            ::= { applExConnectionControlEntry 3 }
  1538.  
  1539.    applExConnectionControlRemItems OBJECT-TYPE
  1540.            SYNTAX          Counter32
  1541.            UNITS           "connection history entries"
  1542.            MAX-ACCESS      read-only
  1543.            STATUS          current
  1544.            DESCRIPTION
  1545.              "The applExConnectionControlRemItems attribute
  1546.               reports the number of applExConnectionControlTable
  1547.               entries for this running application element
  1548.               that were deleted in order to make room for a new
  1549.               history entry.
  1550.  
  1551.               This count does NOT include entries deleted for the
  1552.               following reasons:
  1553.                    - the corresponding
  1554.                      applExConnectionControlCollect attribute
  1555.                      has been set to 'disabled'
  1556.  
  1557.                    - the entry has been in the table longer
  1558.                      that the time limit indicated
  1559.                      by the corresponding
  1560.                      applExConnectionControlTimeLimit.
  1561.              "
  1562.  
  1563.  
  1564.  
  1565. Applmib Working Group     Expires December 1997                [Page 28]
  1566.  
  1567. Internet Draft         Application Management MIB           10 July 1997
  1568.  
  1569.  
  1570.            ::= { applExConnectionControlEntry 4 }
  1571.  
  1572.  
  1573.    -- *************************************************************
  1574.    --
  1575.    --      applExConnectionTable - Table of former connections
  1576.    --
  1577.    -- *************************************************************
  1578.  
  1579.    applExConnectionTable OBJECT-TYPE
  1580.            SYNTAX          SEQUENCE OF ApplExConnectionEntry
  1581.            MAX-ACCESS      not-accessible
  1582.            STATUS          current
  1583.            DESCRIPTION
  1584.              "The applExConnectionTable provides history
  1585.               information about connections from the perspective
  1586.               of the running application element.  Entries in
  1587.               this table are indexed by sysApplElmtRunIndex and
  1588.               by applExConnectionId, which serves to uniquely
  1589.               identify each former connection in the context of
  1590.               a running application element.
  1591.  
  1592.               Entries for closed connections for a given running
  1593.               application element can be added to this table only
  1594.               if the running application element's entry in the
  1595.               applExConnectionControlTable has the value 'enabled'
  1596.               for the attribute applExConnectionControlCollect.
  1597.  
  1598.               Entries for closed connections are removed under
  1599.               the following circumstances:
  1600.  
  1601.                    - the running application element no longer
  1602.                      exists
  1603.  
  1604.                    - the corresponding
  1605.                      applExConnectionControlCollect attribute
  1606.                      has been set to 'disabled'
  1607.  
  1608.                    - the entry has been in the table longer
  1609.                      that the time limit
  1610.                      indicated by the corresponding
  1611.                      applExConnectionControlTimeLimit and the
  1612.                      value of applExConnectionControlCollect is
  1613.                      not 'frozen'
  1614.  
  1615.                    - this is the oldest entry for the running
  1616.                      application element in question and the
  1617.                      addition of a new element would otherwise
  1618.  
  1619.  
  1620.  
  1621. Applmib Working Group     Expires December 1997                [Page 29]
  1622.  
  1623. Internet Draft         Application Management MIB           10 July 1997
  1624.  
  1625.  
  1626.                      cause applExConnectionControlMaxRows to
  1627.                      be exceeded for this running application
  1628.                      element.
  1629.  
  1630.                    - a value of applExConnectionId has been re-
  1631.                      used.  Note that under normal circumstances,
  1632.                      this is unlikely.
  1633.  
  1634.               Removal/replacement of an entry under the
  1635.               two conditions causes the corresponding
  1636.               applExConnectionControlRemItems to be
  1637.               incremented."
  1638.  
  1639.            ::= { applExConnectionGroup 2 }
  1640.  
  1641.    ApplExConnectionEntry  ::= SEQUENCE
  1642.            {
  1643.                    applExConnectionId              Unsigned32,
  1644.                    applExConnectionOpenTime        DateAndTime,
  1645.                    applExConnectionCloseTime       DateAndTime,
  1646.                    applExConnectionTransport       TDomain,
  1647.                    applExConnectionNearEndAddr     TAddress,
  1648.                    applExConnectionNearEndFqdn     Utf8String,
  1649.                    applExConnectionFarEndAddr      TAddress,
  1650.                    applExConnectionFarEndFqdn      Utf8String,
  1651.                    applExConnectionApplication     Utf8String,
  1652.                    applExConnectionReadRequests    Counter64,
  1653.                    applExConnectionReadReqsLow     Counter32,
  1654.                    applExConnectionBytesRead       Counter64,
  1655.                    applExConnectionBytesReadLow    Counter32,
  1656.                    applExConnectionLastReadTime    DateAndTime,
  1657.                    applExConnectionWriteRequests   Counter64,
  1658.                    applExConnectionWriteReqsLow    Counter32,
  1659.                    applExConnectionBytesWritten    Counter64,
  1660.                    applExConnectionBytesWritLow    Counter32,
  1661.                    applExConnectionLastWriteTime   DateAndTime
  1662.            }
  1663.  
  1664.    applExConnectionEntry   OBJECT-TYPE
  1665.            SYNTAX          ApplExConnectionEntry
  1666.            MAX-ACCESS      not-accessible
  1667.            STATUS          current
  1668.            DESCRIPTION
  1669.              "An applExConnectionEntry indicates that a running
  1670.               application element once had an open connection,
  1671.               which is now closed.  The entry has information
  1672.               describing that connection."
  1673.            INDEX           { sysApplElmtRunIndex,
  1674.  
  1675.  
  1676.  
  1677. Applmib Working Group     Expires December 1997                [Page 30]
  1678.  
  1679. Internet Draft         Application Management MIB           10 July 1997
  1680.  
  1681.  
  1682.                              applExConnectionId }
  1683.            ::= { applExConnectionTable 1 }
  1684.  
  1685.    applExConnectionId      OBJECT-TYPE
  1686.            SYNTAX          Unsigned32
  1687.            MAX-ACCESS      read-only
  1688.            STATUS          current
  1689.            DESCRIPTION
  1690.              "This attribute serves to uniquely identify this
  1691.               closed connection in the context of the running
  1692.               application element.  This attribute has no other
  1693.               semantics.
  1694.  
  1695.               In issuing this index value, the implementation
  1696.               must avoid re-issuing an index value which has
  1697.               already been assigned to an entry which has not yet
  1698.               been deleted due to age or space considerations."
  1699.            ::= { applExConnectionEntry 1 }
  1700.  
  1701.    applExConnectionOpenTime        OBJECT-TYPE
  1702.            SYNTAX          DateAndTime
  1703.            MAX-ACCESS      read-only
  1704.            STATUS          current
  1705.            DESCRIPTION
  1706.              "This attribute records the time when this
  1707.               connection was originally opened."
  1708.            ::= { applExConnectionEntry 2 }
  1709.  
  1710.    applExConnectionCloseTime       OBJECT-TYPE
  1711.            SYNTAX          DateAndTime
  1712.            MAX-ACCESS      read-only
  1713.            STATUS          current
  1714.            DESCRIPTION
  1715.              "This attribute records the time when this
  1716.               connection was closed."
  1717.            ::= { applExConnectionEntry 3 }
  1718.  
  1719.    applExConnectionTransport       OBJECT-TYPE
  1720.            SYNTAX          TDomain
  1721.            MAX-ACCESS      read-only
  1722.            STATUS          current
  1723.            DESCRIPTION
  1724.              "The applExConnectionTransport attribute identifies
  1725.               the transport protocol that was in use for this
  1726.               former connection.  If the trasport protocol could
  1727.               not be determined, the value { 0 0 } is used."
  1728.            DEFVAL { { 0 0 } }
  1729.            ::= { applExConnectionEntry 4 }
  1730.  
  1731.  
  1732.  
  1733. Applmib Working Group     Expires December 1997                [Page 31]
  1734.  
  1735. Internet Draft         Application Management MIB           10 July 1997
  1736.  
  1737.  
  1738.    applExConnectionNearEndAddr OBJECT-TYPE
  1739.            SYNTAX          TAddress
  1740.            MAX-ACCESS      read-only
  1741.            STATUS          current
  1742.            DESCRIPTION
  1743.              "The applExConnectionNearEndAddr attribute reports
  1744.               the transport address and port information for
  1745.               the near end of this former connection.
  1746.  
  1747.               If the information could not be determined, the
  1748.               value shall be a zero-length string."
  1749.            DEFVAL { "" }
  1750.            ::= { applExConnectionEntry 5 }
  1751.  
  1752.    applExConnectionNearEndFqdn OBJECT-TYPE
  1753.            SYNTAX          Utf8String
  1754.            MAX-ACCESS      read-only
  1755.            STATUS          current
  1756.            DESCRIPTION
  1757.              "The applExConnectionNearEndFqdn attribute reports
  1758.               the fully-qualified domain name for
  1759.               the near end of this former connection.
  1760.  
  1761.               If the information could not be determined, the
  1762.               value shall be a zero-length string."
  1763.            DEFVAL { "" }
  1764.            ::= { applExConnectionEntry 6 }
  1765.  
  1766.    applExConnectionFarEndAddr  OBJECT-TYPE
  1767.            SYNTAX          TAddress
  1768.            MAX-ACCESS      read-only
  1769.            STATUS          current
  1770.            DESCRIPTION
  1771.              "The applExConnectionFarEnd attribute reports
  1772.               the transport address and port information for
  1773.               the far end of this former connection.
  1774.  
  1775.               If not known, as in the case of a connectionless
  1776.               transport, the value of this attribute shall be
  1777.               a zero-length string."
  1778.            DEFVAL { "" }
  1779.            ::= { applExConnectionEntry 7 }
  1780.  
  1781.    applExConnectionFarEndFqdn  OBJECT-TYPE
  1782.            SYNTAX          Utf8String
  1783.            MAX-ACCESS      read-only
  1784.            STATUS          current
  1785.            DESCRIPTION
  1786.  
  1787.  
  1788.  
  1789. Applmib Working Group     Expires December 1997                [Page 32]
  1790.  
  1791. Internet Draft         Application Management MIB           10 July 1997
  1792.  
  1793.  
  1794.              "The applExConnectionFarEnd attribute reports
  1795.               the transport address and port information for
  1796.               the far end of this former connection.
  1797.  
  1798.               If not known, as in the case of a connectionless
  1799.               transport, the value of this attribute shall be
  1800.               a zero-length string."
  1801.            DEFVAL { "" }
  1802.            ::= { applExConnectionEntry 8 }
  1803.  
  1804.    applExConnectionApplication     OBJECT-TYPE
  1805.            SYNTAX          Utf8String
  1806.            MAX-ACCESS      read-only
  1807.            STATUS          current
  1808.            DESCRIPTION
  1809.              "The applExConnectionApplication attribute
  1810.               identifies the application layer protocol that was
  1811.               in use.  Where possible, the values defined in [16]
  1812.               shall be used.  If not known, the value of this
  1813.               attribute shall be a zero-length string."
  1814.            DEFVAL { "" }
  1815.            ::= { applExConnectionEntry 9 }
  1816.  
  1817.    applExConnectionReadRequests    OBJECT-TYPE
  1818.            SYNTAX          Counter64
  1819.            UNITS           "read requests"
  1820.            MAX-ACCESS      read-only
  1821.            STATUS          current
  1822.            DESCRIPTION
  1823.              "This attribute reports the number of read requests
  1824.               for this connection made by this running application
  1825.               element.  All read requests for this connection
  1826.               by this running application element, regardless
  1827.               of completion status, are included in this count."
  1828.            ::= { applExConnectionEntry 10 }
  1829.  
  1830.    applExConnectionReadReqsLow    OBJECT-TYPE
  1831.            SYNTAX          Counter32
  1832.            UNITS           "read requests"
  1833.            MAX-ACCESS      read-only
  1834.            STATUS          current
  1835.            DESCRIPTION
  1836.              "This attribute corresponds to the low thirty-two
  1837.               bits of applExConnectionReadRequests."
  1838.            ::= { applExConnectionEntry 11 }
  1839.  
  1840.    applExConnectionBytesRead       OBJECT-TYPE
  1841.            SYNTAX          Counter64
  1842.  
  1843.  
  1844.  
  1845. Applmib Working Group     Expires December 1997                [Page 33]
  1846.  
  1847. Internet Draft         Application Management MIB           10 July 1997
  1848.  
  1849.  
  1850.            UNITS           "bytes"
  1851.            MAX-ACCESS      read-only
  1852.            STATUS          current
  1853.            DESCRIPTION
  1854.              "This attribute reports the number of bytes read
  1855.               from this connection by this running application
  1856.               element.  Only bytes successfully read are included
  1857.               in this count. "
  1858.            ::= { applExConnectionEntry 12 }
  1859.  
  1860.    applExConnectionBytesReadLow       OBJECT-TYPE
  1861.            SYNTAX          Counter32
  1862.            UNITS           "bytes"
  1863.            MAX-ACCESS      read-only
  1864.            STATUS          current
  1865.            DESCRIPTION
  1866.              "This attribute corresponds to the low thirty-two
  1867.               bits of applExConnectionBytesRead."
  1868.            ::= { applExConnectionEntry 13 }
  1869.  
  1870.    applExConnectionLastReadTime    OBJECT-TYPE
  1871.            SYNTAX          DateAndTime
  1872.            MAX-ACCESS      read-only
  1873.            STATUS          current
  1874.            DESCRIPTION
  1875.              "This attribute reports the time of the most
  1876.               recent read request made by this running application
  1877.               element, regardless of completion status, for this
  1878.               former connection.
  1879.  
  1880.               If no read requests have been made by this running
  1881.               application element for this connection, the value
  1882.               of this attribute shall be '0000000000000000'H "
  1883.            DEFVAL { '0000000000000000'H }
  1884.            ::= { applExConnectionEntry 14 }
  1885.  
  1886.    applExConnectionWriteRequests   OBJECT-TYPE
  1887.            SYNTAX          Counter64
  1888.            UNITS           "write requests"
  1889.            MAX-ACCESS      read-only
  1890.            STATUS          current
  1891.            DESCRIPTION
  1892.              "The applExconnectionWriteRequests attribute
  1893.               reports the number of write requests, regardless of
  1894.               completion status, made by this running application
  1895.               element for this former connection."
  1896.            ::= { applExConnectionEntry 15 }
  1897.  
  1898.  
  1899.  
  1900.  
  1901. Applmib Working Group     Expires December 1997                [Page 34]
  1902.  
  1903. Internet Draft         Application Management MIB           10 July 1997
  1904.  
  1905.  
  1906.    applExConnectionWriteReqsLow   OBJECT-TYPE
  1907.            SYNTAX          Counter32
  1908.            UNITS           "write requests"
  1909.            MAX-ACCESS      read-only
  1910.            STATUS          current
  1911.            DESCRIPTION
  1912.              "This attribute corresponds to the low thirty-two
  1913.               bits of applExconnectionWriteRequests."
  1914.            ::= { applExConnectionEntry 16 }
  1915.  
  1916.    applExConnectionBytesWritten    OBJECT-TYPE
  1917.            SYNTAX          Counter64
  1918.            UNITS           "bytes"
  1919.            MAX-ACCESS      read-only
  1920.            STATUS          current
  1921.            DESCRIPTION
  1922.              "This attribute reports the number of bytes written
  1923.               to this former connection by this running
  1924.               application element.  Only bytes successfully
  1925.               written (no errors reported by the API in use by
  1926.               the application) are included in this count."
  1927.            ::= { applExConnectionEntry 17 }
  1928.  
  1929.    applExConnectionBytesWritLow    OBJECT-TYPE
  1930.            SYNTAX          Counter32
  1931.            UNITS           "bytes"
  1932.            MAX-ACCESS      read-only
  1933.            STATUS          current
  1934.            DESCRIPTION
  1935.              "This attribute corresponds to the low thirty-two
  1936.               bits of applExconnectionBytesWritten."
  1937.            ::= { applExConnectionEntry 18 }
  1938.  
  1939.    applExConnectionLastWriteTime   OBJECT-TYPE
  1940.            SYNTAX          DateAndTime
  1941.            MAX-ACCESS      read-only
  1942.            STATUS          current
  1943.            DESCRIPTION
  1944.              "The applExConnectionLastWriteTime attribute reports
  1945.               the time of the most recent write request made by
  1946.               this running application element, regardless of
  1947.               completion status, for this former connection.
  1948.  
  1949.               If no write requests have been made by this running
  1950.               application element for this connection, the value
  1951.               of this attribute shall be '0000000000000000'H "
  1952.            DEFVAL { '0000000000000000'H }
  1953.            ::= { applExConnectionEntry 19 }
  1954.  
  1955.  
  1956.  
  1957. Applmib Working Group     Expires December 1997                [Page 35]
  1958.  
  1959. Internet Draft         Application Management MIB           10 July 1997
  1960.  
  1961.  
  1962.    -- *************************************************************
  1963.    --
  1964.    --      applTransactionControlTable - common and control
  1965.    --      information for transaction stream monitoring
  1966.    --
  1967.    -- *************************************************************
  1968.  
  1969.    applTransactionControlTable     OBJECT-TYPE
  1970.            SYNTAX          SEQUENCE OF ApplTransactionControlEntry
  1971.            MAX-ACCESS      not-accessible
  1972.            STATUS          current
  1973.            DESCRIPTION
  1974.              "The applTransactionControlTable contains common
  1975.               information for the control of transaction
  1976.               statistic accumulation."
  1977.            ::= { applTransactionGroup 1 }
  1978.  
  1979.    ApplTransactionControlEntry ::= SEQUENCE {
  1980.            applTransactStreamId         Unsigned32,
  1981.            applTransactStreamPointer    RowPointer,
  1982.            applTransactStreamDescr      Utf8String,
  1983.            applTransactStreamUnitOfWork Utf8String
  1984.                                                            }
  1985.  
  1986.    applTransactionControlEntry OBJECT-TYPE
  1987.            SYNTAX  ApplTransactionControlEntry
  1988.            MAX-ACCESS      not-accessible
  1989.            STATUS          current
  1990.            DESCRIPTION
  1991.              "An applTransactionControlentry contains control
  1992.               information for a single transaction stream.  A
  1993.               transaction stream can be a network connection,
  1994.               file, or other source of transactions."
  1995.            INDEX           { sysApplElmtRunIndex,
  1996.                              applTransactStreamId }
  1997.            ::= { applTransactionControlTable 1 }
  1998.  
  1999.    applTransactStreamId OBJECT-TYPE
  2000.            SYNTAX          Unsigned32
  2001.            MAX-ACCESS      not-accessible
  2002.            STATUS          current
  2003.            DESCRIPTION
  2004.              "An applTransactStreamId serves to uniquely
  2005.               identify a transaction stream in the context of
  2006.               a given running application element."
  2007.            ::= { applTransactionControlEntry 1 }
  2008.  
  2009.    applTransactStreamPointer            OBJECT-TYPE
  2010.  
  2011.  
  2012.  
  2013. Applmib Working Group     Expires December 1997                [Page 36]
  2014.  
  2015. Internet Draft         Application Management MIB           10 July 1997
  2016.  
  2017.  
  2018.            SYNTAX          RowPointer
  2019.            MAX-ACCESS      read-only
  2020.            STATUS          current
  2021.            DESCRIPTION
  2022.              "The applTransactStreamPointer attribute
  2023.               identifies the network connection or file
  2024.               I/O stream over which these transactions are
  2025.               carried.  This will normally point to an entry
  2026.               in the applOpenFilesTable or to an entry in the
  2027.               applOpenConnectionsTable.  If this transaction
  2028.               stream is not associated with a specific file or
  2029.               connection, this attribute's value shall be
  2030.               { 0 0 }."
  2031.            ::= { applTransactionControlEntry 2 }
  2032.  
  2033.    applTransactStreamDescr              OBJECT-TYPE
  2034.            SYNTAX          Utf8String
  2035.            MAX-ACCESS      read-only
  2036.            STATUS          current
  2037.            DESCRIPTION
  2038.              "The applTransactStreamDescr attribute provides
  2039.               a human-readable description of this transaction
  2040.               stream.
  2041.  
  2042.               If no descriptive information is available, this
  2043.               attribute's value shall be a zero-length string."
  2044.            DEFVAL { "" }
  2045.            ::= { applTransactionControlEntry 3 }
  2046.  
  2047.    applTransactStreamUnitOfWork         OBJECT-TYPE
  2048.            SYNTAX          Utf8String
  2049.            MAX-ACCESS      read-only
  2050.            STATUS          current
  2051.            DESCRIPTION
  2052.              "The applTransactStreamUnitOfWork attribute
  2053.               provides a human-readable definition of what the
  2054.               unit of work is for this transaction stream.
  2055.  
  2056.               If no descriptive information is available, this
  2057.               attribute's value shall be a zero-length string."
  2058.            DEFVAL { "" }
  2059.            ::= { applTransactionControlEntry 4 }
  2060.  
  2061.  
  2062.  
  2063.    -- *************************************************************
  2064.    --
  2065.    --      applTransactStreamTable
  2066.  
  2067.  
  2068.  
  2069. Applmib Working Group     Expires December 1997                [Page 37]
  2070.  
  2071. Internet Draft         Application Management MIB           10 July 1997
  2072.  
  2073.  
  2074.    --
  2075.    -- *************************************************************
  2076.  
  2077.    applTransactStreamTable      OBJECT-TYPE
  2078.            SYNTAX          SEQUENCE OF ApplTransactStreamEntry
  2079.            MAX-ACCESS      not-accessible
  2080.            STATUS          current
  2081.            DESCRIPTION
  2082.              "The applTransactStreamTable contains entries,
  2083.               organized by running application element, for each
  2084.               open transaction stream.
  2085.  
  2086.               The simple model of a transaction used here looks
  2087.               like this:
  2088.  
  2089.                    invoker  |   Request     | performer
  2090.                             | - - - - - - > |
  2091.                             |               |
  2092.                             |   Response    |
  2093.                             | < - - - - - - |
  2094.                             |               |
  2095.  
  2096.               Since in some protocols it is possible for an entity
  2097.               to take on both the invoker and performer roles,
  2098.               information here is accumulated for transmitted
  2099.               and received requests, as well as for transmitted
  2100.               and received responses.  Counts are maintained
  2101.               for both transactions and bytes transferred."
  2102.            ::= { applTransactionGroup 2 }
  2103.  
  2104.    ApplTransactStreamEntry ::= SEQUENCE {
  2105.            applTransactStreamUpTime        TimeStamp,
  2106.            applTransactStreamTxReqs        Counter64,
  2107.            applTransactStreamTxReqsLow     Counter32,
  2108.            applTransactStreamTxReqBytes    Counter64,
  2109.            applTransactStreamTxReqBytesLow Counter32,
  2110.            applTransactStreamTxReqTime     DateAndTime,
  2111.            applTransactStreamTxRsps        Counter64,
  2112.            applTransactStreamTxRspsLow     Counter32,
  2113.            applTransactStreamTxRspBytes    Counter64,
  2114.            applTransactStreamTxRspBytesLow Counter32,
  2115.            applTransactStreamTxRspTime     DateAndTime,
  2116.            applTransactStreamRxReqs        Counter64,
  2117.            applTransactStreamRxReqsLow     Counter32,
  2118.            applTransactStreamRxReqBytes    Counter64,
  2119.            applTransactStreamRxReqBytesLow Counter32,
  2120.            applTransactStreamRxReqTime     DateAndTime,
  2121.            applTransactStreamRxRsps        Counter64,
  2122.  
  2123.  
  2124.  
  2125. Applmib Working Group     Expires December 1997                [Page 38]
  2126.  
  2127. Internet Draft         Application Management MIB           10 July 1997
  2128.  
  2129.  
  2130.            applTransactStreamRxRspsLow     Counter32,
  2131.            applTransactStreamRxRspBytes    Counter64,
  2132.            applTransactStreamRxRspBytesLow Counter32,
  2133.            applTransactStreamRxRspTime     DateAndTime,
  2134.            applTransactStreamInvCumTime    Counter32,
  2135.            applTransactStreamPrfCumTime    Counter32    }
  2136.  
  2137.  
  2138.    applTransactStreamEntry OBJECT-TYPE
  2139.            SYNTAX  ApplTransactStreamEntry
  2140.            MAX-ACCESS      not-accessible
  2141.            STATUS          current
  2142.            DESCRIPTION
  2143.              "An applTransactStreamEntry reports transaction
  2144.               throughput information for a transaction stream.
  2145.               Entries in this table are indexed identically to
  2146.               those in the applTransactionControlTable."
  2147.  
  2148.            INDEX           { sysApplElmtRunIndex,
  2149.                              applTransactStreamId }
  2150.            ::= { applTransactStreamTable 1 }
  2151.  
  2152.    applTransactStreamUpTime             OBJECT-TYPE
  2153.            SYNTAX          TimeStamp
  2154.            MAX-ACCESS      read-only
  2155.            STATUS          current
  2156.            DESCRIPTION
  2157.              "The applTransactStreamUpTime attribute records
  2158.               the value of sysUpTime.0 when this transaction
  2159.               stream entry was created and serves as a
  2160.               discontinuity indicator for all of the counters
  2161.               in this row."
  2162.            ::= { applTransactStreamEntry 1 }
  2163.  
  2164.  
  2165.    applTransactStreamTxReqs             OBJECT-TYPE
  2166.            SYNTAX          Counter64
  2167.            UNITS           "requests"
  2168.            MAX-ACCESS      read-only
  2169.            STATUS          current
  2170.            DESCRIPTION
  2171.              "The applTransactStreamTxReqs attribute reports
  2172.               the number of requests transmitted by this running
  2173.               application element over this transaction stream.
  2174.  
  2175.               Discontinuities in this counter can be detected
  2176.               by monitoring the applTransactStreamUpTime for
  2177.               this row."
  2178.  
  2179.  
  2180.  
  2181. Applmib Working Group     Expires December 1997                [Page 39]
  2182.  
  2183. Internet Draft         Application Management MIB           10 July 1997
  2184.  
  2185.  
  2186.            ::= { applTransactStreamEntry 2 }
  2187.  
  2188.    applTransactStreamTxReqsLow          OBJECT-TYPE
  2189.            SYNTAX          Counter32
  2190.            UNITS           "requests"
  2191.            MAX-ACCESS      read-only
  2192.            STATUS          current
  2193.            DESCRIPTION
  2194.              "This attribute corresponds to the low thirty-two
  2195.               bits of applTransactStreamTxReqs.
  2196.  
  2197.               Discontinuities in this counter can be detected
  2198.               by monitoring the applTransactStreamUpTime for
  2199.               this row."
  2200.            ::= { applTransactStreamEntry 3 }
  2201.  
  2202.  
  2203.    applTransactStreamTxReqBytes         OBJECT-TYPE
  2204.            SYNTAX          Counter64
  2205.            UNITS           "bytes"
  2206.            MAX-ACCESS      read-only
  2207.            STATUS          current
  2208.            DESCRIPTION
  2209.              "The applTransactStreamTxReqBytes attribute
  2210.               reports the number of bytes transmitted by this
  2211.               running application element in requests over this
  2212.               transaction stream.
  2213.  
  2214.               Discontinuities in this counter can be detected
  2215.               by monitoring the applTransactStreamUpTime for
  2216.               this row."
  2217.            ::= { applTransactStreamEntry 4 }
  2218.  
  2219.    applTransactStreamTxReqBytesLow      OBJECT-TYPE
  2220.            SYNTAX          Counter32
  2221.            UNITS           "bytes"
  2222.            MAX-ACCESS      read-only
  2223.            STATUS          current
  2224.            DESCRIPTION
  2225.              "This attribute corresponds to the low thirty-two
  2226.               bits of applTransactStreamTxReqBytes.
  2227.  
  2228.               Discontinuities in this counter can be detected
  2229.               by monitoring the applTransactStreamUpTime for
  2230.               this row."
  2231.            ::= { applTransactStreamEntry 5 }
  2232.  
  2233.    applTransactStreamTxReqTime          OBJECT-TYPE
  2234.  
  2235.  
  2236.  
  2237. Applmib Working Group     Expires December 1997                [Page 40]
  2238.  
  2239. Internet Draft         Application Management MIB           10 July 1997
  2240.  
  2241.  
  2242.            SYNTAX          DateAndTime
  2243.            MAX-ACCESS      read-only
  2244.            STATUS          current
  2245.            DESCRIPTION
  2246.              "The applTransactStreamTxReqTime attribute reports
  2247.               the time of the most recent transmission of a
  2248.               request over this transaction stream.
  2249.  
  2250.               If no requests have been sent by this running
  2251.               application element over this transaction
  2252.               stream, the value of this attribute shall be
  2253.               '0000000000000000'H "
  2254.            DEFVAL { '0000000000000000'H }
  2255.            ::= { applTransactStreamEntry 6 }
  2256.  
  2257.    applTransactStreamTxRsps             OBJECT-TYPE
  2258.            SYNTAX          Counter64
  2259.            UNITS           "responses"
  2260.            MAX-ACCESS      read-only
  2261.            STATUS          current
  2262.            DESCRIPTION
  2263.              "The applTransactStreamTxRsps attribute reports
  2264.               the number of responses sent by this running
  2265.               application element over this transaction stream.
  2266.  
  2267.               Discontinuities in this counter can be detected
  2268.               by monitoring the applTransactStreamUpTime for
  2269.               this row."
  2270.            ::= { applTransactStreamEntry 7 }
  2271.  
  2272.    applTransactStreamTxRspsLow          OBJECT-TYPE
  2273.            SYNTAX          Counter32
  2274.            UNITS           "responses"
  2275.            MAX-ACCESS      read-only
  2276.            STATUS          current
  2277.            DESCRIPTION
  2278.              "This attribute corresponds to the low thirty-two
  2279.               bits of applTransactStreamTxRsps.
  2280.  
  2281.               Discontinuities in this counter can be detected
  2282.               by monitoring the applTransactStreamUpTime for
  2283.               this row."
  2284.            ::= { applTransactStreamEntry 8 }
  2285.  
  2286.    applTransactStreamTxRspBytes         OBJECT-TYPE
  2287.            SYNTAX          Counter64
  2288.            UNITS           "bytes"
  2289.            MAX-ACCESS      read-only
  2290.  
  2291.  
  2292.  
  2293. Applmib Working Group     Expires December 1997                [Page 41]
  2294.  
  2295. Internet Draft         Application Management MIB           10 July 1997
  2296.  
  2297.  
  2298.            STATUS          current
  2299.            DESCRIPTION
  2300.              "The applTransactStreamTxRspBytes attribute
  2301.               reports the number of bytes sent by this running
  2302.               application element in responses over this
  2303.               transaction stream.
  2304.  
  2305.               Discontinuities in this counter can be detected
  2306.               by monitoring the applTransactStreamUpTime for
  2307.               this row."
  2308.            ::= { applTransactStreamEntry 9 }
  2309.  
  2310.    applTransactStreamTxRspBytesLow        OBJECT-TYPE
  2311.            SYNTAX          Counter32
  2312.            UNITS           "bytes"
  2313.            MAX-ACCESS      read-only
  2314.            STATUS          current
  2315.            DESCRIPTION
  2316.              "This attribute corresponds to the low thirty-two
  2317.               bits of applTransactStreamTxRspBytes.
  2318.  
  2319.               Discontinuities in this counter can be detected
  2320.               by monitoring the applTransactStreamUpTime for
  2321.               this row."
  2322.            ::= { applTransactStreamEntry 10 }
  2323.  
  2324.    applTransactStreamTxRspTime          OBJECT-TYPE
  2325.            SYNTAX          DateAndTime
  2326.            MAX-ACCESS      read-only
  2327.            STATUS          current
  2328.            DESCRIPTION
  2329.              "The applTransactStreamTxRspTime attribute
  2330.               reports the time the most recent response was
  2331.               transmitted over this transaction stream by this
  2332.               running application element.
  2333.  
  2334.               If no responses have been sent by this running
  2335.               application element over this transaction
  2336.               stream, the value of this attribute shall be
  2337.               '0000000000000000'H "
  2338.            DEFVAL { '0000000000000000'H }
  2339.            ::= { applTransactStreamEntry 11 }
  2340.  
  2341.    applTransactStreamRxReqs             OBJECT-TYPE
  2342.            SYNTAX          Counter64
  2343.            UNITS           "requests"
  2344.            MAX-ACCESS      read-only
  2345.            STATUS          current
  2346.  
  2347.  
  2348.  
  2349. Applmib Working Group     Expires December 1997                [Page 42]
  2350.  
  2351. Internet Draft         Application Management MIB           10 July 1997
  2352.  
  2353.  
  2354.            DESCRIPTION
  2355.              "The applTransactStreamRxReqs attribute reports
  2356.               the number requests received by this running
  2357.               application element over this transaction stream.
  2358.  
  2359.               Discontinuities in this counter can be detected
  2360.               by monitoring the applTransactStreamUpTime for
  2361.               this row."
  2362.            ::= { applTransactStreamEntry 12 }
  2363.  
  2364.    applTransactStreamRxReqsLow          OBJECT-TYPE
  2365.            SYNTAX          Counter32
  2366.            UNITS           "requests"
  2367.            MAX-ACCESS      read-only
  2368.            STATUS          current
  2369.            DESCRIPTION
  2370.              "This attribute corresponds to the low thirty-two
  2371.               bits of applTransactStreamRxReqs.
  2372.  
  2373.               Discontinuities in this counter can be detected
  2374.               by monitoring the applTransactStreamUpTime for
  2375.               this row."
  2376.            ::= { applTransactStreamEntry 13 }
  2377.  
  2378.    applTransactStreamRxReqBytes         OBJECT-TYPE
  2379.            SYNTAX          Counter64
  2380.            UNITS           "bytes"
  2381.            MAX-ACCESS      read-only
  2382.            STATUS          current
  2383.            DESCRIPTION
  2384.              "The applTransactStreamRxReqBytes attribute
  2385.               reports the number of bytes received by this
  2386.               running application element in requests on this
  2387.               transaction stream.
  2388.  
  2389.               Discontinuities in this counter can be detected
  2390.               by monitoring the applTransactStreamUpTime for
  2391.               this row."
  2392.            ::= { applTransactStreamEntry 14 }
  2393.  
  2394.    applTransactStreamRxReqBytesLow        OBJECT-TYPE
  2395.            SYNTAX          Counter32
  2396.            UNITS           "bytes"
  2397.            MAX-ACCESS      read-only
  2398.            STATUS          current
  2399.            DESCRIPTION
  2400.              "This attribute corresponds to the low thirty-two
  2401.               bits of applTransactStreamRxReqBytes.
  2402.  
  2403.  
  2404.  
  2405. Applmib Working Group     Expires December 1997                [Page 43]
  2406.  
  2407. Internet Draft         Application Management MIB           10 July 1997
  2408.  
  2409.  
  2410.               Discontinuities in this counter can be detected
  2411.               by monitoring the applTransactStreamUpTime for
  2412.               this row."
  2413.            ::= { applTransactStreamEntry 15 }
  2414.  
  2415.    applTransactStreamRxReqTime          OBJECT-TYPE
  2416.            SYNTAX          DateAndTime
  2417.            MAX-ACCESS      read-only
  2418.            STATUS          current
  2419.            DESCRIPTION
  2420.              "The applTransactStreamRxReqTime attribute reports
  2421.               the time of the most recent receipt by this
  2422.               running application element of a request on this
  2423.               transaction stream.
  2424.  
  2425.               If no requests have been received by this running
  2426.               application element over this transaction
  2427.               stream, the value of this attribute shall be
  2428.               '0000000000000000'H "
  2429.            DEFVAL { '0000000000000000'H }
  2430.            ::= { applTransactStreamEntry 16 }
  2431.  
  2432.    applTransactStreamRxRsps             OBJECT-TYPE
  2433.            SYNTAX          Counter64
  2434.            UNITS           "responses"
  2435.            MAX-ACCESS      read-only
  2436.            STATUS          current
  2437.            DESCRIPTION
  2438.              "The applTransactStreamRxRsps attribute reports
  2439.               the number of responses received by this running
  2440.               application element on this transaction stream.
  2441.  
  2442.               Discontinuities in this counter can be detected
  2443.               by monitoring the applTransactStreamUpTime for
  2444.               this row."
  2445.            ::= { applTransactStreamEntry 17 }
  2446.  
  2447.    applTransactStreamRxRspsLow          OBJECT-TYPE
  2448.            SYNTAX          Counter32
  2449.            UNITS           "responses"
  2450.            MAX-ACCESS      read-only
  2451.            STATUS          current
  2452.            DESCRIPTION
  2453.              "This attribute corresponds to the low thirty-two
  2454.               bits of applTransactStreamRxRsps.
  2455.  
  2456.               Discontinuities in this counter can be detected
  2457.               by monitoring the applTransactStreamUpTime for
  2458.  
  2459.  
  2460.  
  2461. Applmib Working Group     Expires December 1997                [Page 44]
  2462.  
  2463. Internet Draft         Application Management MIB           10 July 1997
  2464.  
  2465.  
  2466.               this row."
  2467.            ::= { applTransactStreamEntry 18 }
  2468.  
  2469.    applTransactStreamRxRspBytes         OBJECT-TYPE
  2470.            SYNTAX          Counter64
  2471.            UNITS           "bytes"
  2472.            MAX-ACCESS      read-only
  2473.            STATUS          current
  2474.            DESCRIPTION
  2475.              "The applTransactStreamRxRspBytes attribute
  2476.               reports the number of bytes in responses received
  2477.               by this running application element on this
  2478.               transaction stream.
  2479.  
  2480.               Discontinuities in this counter can be detected
  2481.               by monitoring the applTransactStreamUpTime for
  2482.               this row."
  2483.            ::= { applTransactStreamEntry 19 }
  2484.  
  2485.  
  2486.    applTransactStreamRxRspBytesLow      OBJECT-TYPE
  2487.            SYNTAX          Counter32
  2488.            UNITS           "bytes"
  2489.            MAX-ACCESS      read-only
  2490.            STATUS          current
  2491.            DESCRIPTION
  2492.              "This attribute corresponds to the low thirty-two
  2493.               bits of applTransactStreamRxRspBytes.
  2494.  
  2495.               Discontinuities in this counter can be detected
  2496.               by monitoring the applTransactStreamUpTime for
  2497.               this row."
  2498.            ::= { applTransactStreamEntry 20 }
  2499.  
  2500.    applTransactStreamRxRspTime          OBJECT-TYPE
  2501.            SYNTAX          DateAndTime
  2502.            MAX-ACCESS      read-only
  2503.            STATUS          current
  2504.            DESCRIPTION
  2505.              "The applTransactStreamRxRspTime attribute records
  2506.               the time of the receipt by this running application
  2507.               element of the most recent response on this
  2508.               transaction stream.
  2509.  
  2510.               If no responses have been received by this
  2511.               running application element over this transaction
  2512.               stream, the value of this attribute shall be
  2513.               '0000000000000000'H "
  2514.  
  2515.  
  2516.  
  2517. Applmib Working Group     Expires December 1997                [Page 45]
  2518.  
  2519. Internet Draft         Application Management MIB           10 July 1997
  2520.  
  2521.  
  2522.            DEFVAL { '0000000000000000'H }
  2523.            ::= { applTransactStreamEntry 21 }
  2524.  
  2525.    applTransactStreamInvCumTime         OBJECT-TYPE
  2526.            SYNTAX          Counter32
  2527.            UNITS           "milliseconds"
  2528.            MAX-ACCESS      read-only
  2529.            STATUS          current
  2530.            DESCRIPTION
  2531.              "The applTransactStreamInvCumTime attribute
  2532.               reports the cumulative sum of the times measured
  2533.               between the transmission of requests and the
  2534.               receipt of the corresponding responses.
  2535.  
  2536.               Discontinuities in this counter can be detected
  2537.               by monitoring the applTransactStreamUpTime for
  2538.               this row."
  2539.            ::= { applTransactStreamEntry 22 }
  2540.  
  2541.    applTransactStreamPrfCumTime         OBJECT-TYPE
  2542.            SYNTAX          Counter32
  2543.            UNITS           "milliseconds"
  2544.            MAX-ACCESS      read-only
  2545.            STATUS          current
  2546.            DESCRIPTION
  2547.              "The applTransactStreamPrfCumTime attribute
  2548.               reports the cumulative sum of the times measured
  2549.               between receipt of requests and the transmission
  2550.               of the corresponding responses.
  2551.  
  2552.               Discontinuities in this counter can be detected
  2553.               by monitoring the applTransactStreamUpTime for
  2554.               this row."
  2555.            ::= { applTransactStreamEntry 23 }
  2556.  
  2557.  
  2558.    --
  2559.    --ISSUE: More detailed statistics from the ARM mib to come...
  2560.    --
  2561.  
  2562.  
  2563.    -- *************************************************************
  2564.    --
  2565.    --      applElmtRunControlGroup - monitor and control running
  2566.    --      application elements
  2567.    --
  2568.    -- *************************************************************
  2569.  
  2570.  
  2571.  
  2572.  
  2573. Applmib Working Group     Expires December 1997                [Page 46]
  2574.  
  2575. Internet Draft         Application Management MIB           10 July 1997
  2576.  
  2577.  
  2578.    applElmtRunStatusTable OBJECT-TYPE
  2579.            SYNTAX          SEQUENCE OF ApplElmtRunStatusEntry
  2580.            MAX-ACCESS      not-accessible
  2581.            STATUS          current
  2582.            DESCRIPTION
  2583.              "This table provies information on running
  2584.               application elements, complementing information
  2585.               avilable in the correspondingly indexed
  2586.               sysApplelmtRunTable [11]."
  2587.            ::= { applElmtRunControlGroup 1 }
  2588.  
  2589.    ApplElmtRunStatusEntry ::= SEQUENCE {
  2590.            applElmtRunStatusSuspended              TruthValue,
  2591.            applElmtRunStatusHeapUsage              Gauge32,
  2592.            applElmtRunStatusOpenConnections        Gauge32,
  2593.            applElmtRunStatusLastErrorMsg           Utf8String,
  2594.            applElmtRunStatusLastErrorTime          DateAndTime }
  2595.  
  2596.    applElmtRunStatusEntry OBJECT-TYPE
  2597.            SYNTAX          ApplElmtRunStatusEntry
  2598.            MAX-ACCESS      not-accessible
  2599.            STATUS          current
  2600.            DESCRIPTION
  2601.              "An applElmtRunStatusEntry contains information
  2602.               to support the control and monitoring of a single
  2603.               running application element."
  2604.            INDEX { sysApplElmtRunIndex }
  2605.            ::= { applElmtRunStatusTable 1 }
  2606.  
  2607.    applElmtRunStatusSuspended      OBJECT-TYPE
  2608.            SYNTAX          TruthValue
  2609.            MAX-ACCESS      read-only
  2610.            STATUS          current
  2611.            DESCRIPTION
  2612.              "The applElmtRunStatusSuspended attribute reports
  2613.               whether processing by this running application
  2614.               element has been suspended, whether by management
  2615.               request or by other means."
  2616.            ::= { applElmtRunStatusEntry 1 }
  2617.  
  2618.    applElmtRunStatusHeapUsage      OBJECT-TYPE
  2619.            SYNTAX          Gauge32
  2620.            UNITS           "bytes"
  2621.            MAX-ACCESS      read-only
  2622.            STATUS          current
  2623.            DESCRIPTION
  2624.              "The applElmtRunStatusHeapUsage reports the
  2625.               current approximate heap usage by this running
  2626.  
  2627.  
  2628.  
  2629. Applmib Working Group     Expires December 1997                [Page 47]
  2630.  
  2631. Internet Draft         Application Management MIB           10 July 1997
  2632.  
  2633.  
  2634.               application element."
  2635.            ::= { applElmtRunStatusEntry 2 }
  2636.  
  2637.    applElmtRunStatusOpenConnections        OBJECT-TYPE
  2638.            SYNTAX          Gauge32
  2639.            UNITS           "connections"
  2640.            MAX-ACCESS      read-only
  2641.            STATUS          current
  2642.            DESCRIPTION
  2643.              "The applElmtRunStatusOpenConnections reports
  2644.               the current number of open connections in use
  2645.               by this running application element."
  2646.            ::= { applElmtRunStatusEntry 3 }
  2647.  
  2648.    applElmtRunStatusLastErrorMsg   OBJECT-TYPE
  2649.            SYNTAX          Utf8String
  2650.            MAX-ACCESS      read-only
  2651.            STATUS          current
  2652.            DESCRIPTION
  2653.              "The applElmtRunStatusLastErrorMessage attribute
  2654.               reports the most recent error message (typically
  2655.               written to stderr or a system error logging
  2656.               facility) from this running application element.
  2657.               If no such message has yet been generated, the value
  2658.               of this attribute shall be a zero-length string."
  2659.            DEFVAL { "" }
  2660.            ::= { applElmtRunStatusEntry 4 }
  2661.  
  2662.    applElmtRunStatusLastErrorTime  OBJECT-TYPE
  2663.            SYNTAX          DateAndTime
  2664.            MAX-ACCESS      read-only
  2665.            STATUS          current
  2666.            DESCRIPTION
  2667.              "The applElmtRunStatusLastErrorTime attribute
  2668.               reports the time of the most recent error message
  2669.               in applElmtRunStatusLastErrorMsg.
  2670.  
  2671.               If no such message has yet been generated, the value
  2672.               of this attribute shall be '0000000000000000'H "
  2673.            DEFVAL { '0000000000000000'H }
  2674.            ::= { applElmtRunStatusEntry 5 }
  2675.  
  2676.  
  2677.    -- *************************************************************
  2678.    --
  2679.    --      applElmtRunControlTable - control running application
  2680.    --      elements
  2681.    --
  2682.  
  2683.  
  2684.  
  2685. Applmib Working Group     Expires December 1997                [Page 48]
  2686.  
  2687. Internet Draft         Application Management MIB           10 July 1997
  2688.  
  2689.  
  2690.    -- *************************************************************
  2691.  
  2692.  
  2693.    applElmtRunControlTable OBJECT-TYPE
  2694.            SYNTAX          SEQUENCE OF ApplElmtRunControlEntry
  2695.            MAX-ACCESS      not-accessible
  2696.            STATUS          current
  2697.            DESCRIPTION
  2698.              "This table provides the ability to control
  2699.               application elements, complementing information
  2700.               avilable in the correspondingly indexed
  2701.               sysApplelmtRunTable [11]."
  2702.            ::= { applElmtRunControlGroup 2 }
  2703.  
  2704.    ApplElmtRunControlEntry ::= SEQUENCE {
  2705.                    applElmtRunControlSuspend       TruthValue,
  2706.                    applElmtRunControlReconfigure   TestAndIncr,
  2707.                    applElmtRunControlTerminate     TruthValue }
  2708.  
  2709.    applElmtRunControlEntry OBJECT-TYPE
  2710.            SYNTAX          ApplElmtRunControlEntry
  2711.            MAX-ACCESS      not-accessible
  2712.            STATUS          current
  2713.            DESCRIPTION
  2714.              "An applElmtRunControlEntry contains information
  2715.               to support the control of a single running
  2716.               application element."
  2717.            INDEX { sysApplElmtRunIndex }
  2718.            ::= { applElmtRunControlTable 1 }
  2719.  
  2720.    applElmtRunControlSuspend       OBJECT-TYPE
  2721.            SYNTAX          TruthValue
  2722.            MAX-ACCESS      read-write
  2723.            STATUS          current
  2724.            DESCRIPTION
  2725.              "Setting this variable to 'true' requests the
  2726.               suspension of processing by this running application
  2727.               element.  Setting this variable to 'false' requests
  2728.               that processing be resumed.  The effect, if any,
  2729.               will be reported by the applElmtRunStatusSuspended
  2730.               attribute."
  2731.            DEFVAL { false }
  2732.            ::= { applElmtRunControlEntry 1 }
  2733.  
  2734.    applElmtRunControlReconfigure   OBJECT-TYPE
  2735.            SYNTAX          TestAndIncr
  2736.            MAX-ACCESS      read-write
  2737.            STATUS          current
  2738.  
  2739.  
  2740.  
  2741. Applmib Working Group     Expires December 1997                [Page 49]
  2742.  
  2743. Internet Draft         Application Management MIB           10 July 1997
  2744.  
  2745.  
  2746.            DESCRIPTION
  2747.              "Changing the value of this variable requests
  2748.               that the running application element re-load
  2749.               its configuration (like SIGHUP for many
  2750.               UNIX-based daemons)."
  2751.            ::= { applElmtRunControlEntry 2 }
  2752.  
  2753.    applElmtRunControlTerminate     OBJECT-TYPE
  2754.            SYNTAX          TruthValue
  2755.            MAX-ACCESS      read-write
  2756.            STATUS          current
  2757.            DESCRIPTION
  2758.              "Setting the value of applElmtRunControlTerminate
  2759.               to 'true' requests that the running application
  2760.               element terminate processing and exit in an
  2761.               orderly manner.  This is a 'polite' shutdown
  2762.               request."
  2763.            DEFVAL { false }
  2764.            ::= { applElmtRunControlEntry 3 }
  2765.  
  2766.  
  2767.    END
  2768.  
  2769.  
  2770.  
  2771. 6.  Implementation Issues
  2772.  
  2773.    Unlike the system application MIB [11], in many environments support
  2774.    for much of this MIB requires instrumentation built into the managed
  2775.    resource.  Some tables may be implemented by a single monitor
  2776.    process; for others, the implementation may be distributed within the
  2777.    managed system with the resources being managed.
  2778.  
  2779.    As a practical matter, this means that the management infrastructure
  2780.    of the managed system must support different subagents taking
  2781.    responsibility for different rows of a single table.  This can be
  2782.    supported by Agentx [14], as well as some other subagent protocols
  2783.    [15].
  2784.  
  2785.    The sysApplRunElmtIndex is the key connection between this MIB and
  2786.    the systems application MIB.  Implementations of these two MIBs
  2787.    intended to run concurrently on a given platform must employ a
  2788.    consistent policy for assigning this value to running application
  2789.    elements.
  2790.  
  2791.    Some of the objects defined in this MIB may carry a high run-time
  2792.    cost in some environments.  For example, tracking transaction elapsed
  2793.    time could be expensive if it required a two kernel calls (start and
  2794.  
  2795.  
  2796.  
  2797. Applmib Working Group     Expires December 1997                [Page 50]
  2798.  
  2799. Internet Draft         Application Management MIB           10 July 1997
  2800.  
  2801.  
  2802.    finish) per transaction.  Similarly, maintaining tables of per-
  2803.    transaction information, rather than aggregating information by
  2804.    transaction type or transaction stream, could have significant
  2805.    storage and performance impacts.
  2806.  
  2807.  
  2808.  
  2809. 7.  Security Considerations
  2810.  
  2811.    By making potentially sensitive information externally accessible,
  2812.    the capabilities supported by the MIB have the potential of becoming
  2813.    security problems.
  2814.  
  2815.    The tables in this MIB are organized to separate sensitive control
  2816.    capabilities from less sensitive usage information.  The MIB is
  2817.    structured to be useful for managers with read-only access rights.
  2818.  
  2819.    The capabilities supported by this MIB include several that may be of
  2820.    value to a security administrator.  These include the ability to
  2821.    monitor the level of usage of a given application, to verify
  2822.    licenses, and to check the integrity of application components.
  2823.  
  2824.  
  2825. 8.  Acknowledgements
  2826.  
  2827.    This document was produced by the Application MIB working group.
  2828.  
  2829.    The author gratefully acknowledges the comments and contributions of
  2830.    the following individuals:
  2831.  
  2832.              Harrie Hazewinkel
  2833.              Carl Kalbfleisch
  2834.              Cheryl Krupczak
  2835.              John Saperia
  2836.              Juergen Schoenwaelder
  2837.  
  2838.  
  2839. 9.  Editors' Addresses
  2840.  
  2841.    Carl Kalbfleisch
  2842.    Verio, Inc.
  2843.    1950 Stemmons Frwy
  2844.    2026 INFOMART
  2845.    Dallas, TX 75207
  2846.    USA
  2847.  
  2848.    Phone: +1 972 238-8303
  2849.    Fax:   +1 214 672-7275
  2850.  
  2851.  
  2852.  
  2853. Applmib Working Group     Expires December 1997                [Page 51]
  2854.  
  2855. Internet Draft         Application Management MIB           10 July 1997
  2856.  
  2857.  
  2858.    E-Mail: cwk@verio.net
  2859.  
  2860.  
  2861.    Cheryl Krupczak
  2862.    Empire Technologies, Inc.
  2863.    541 Tenth Street, NW Suite 169
  2864.    Atlanta, GA 30318
  2865.  
  2866.    Phone: +1 770 384-0184
  2867.  
  2868.    E-Mail: cheryl@empiretech.com
  2869.  
  2870.  
  2871.    Randy Presuhn
  2872.    BMC Software, Inc.
  2873.    Silicon Valley Division
  2874.    (formerly PEER Networks)
  2875.    1190 Saratoga Avenue
  2876.    San Jose, CA 95129
  2877.    USA
  2878.  
  2879.    Phone: +1 408 556-0720
  2880.    Fax:   +1 408 556-0735
  2881.  
  2882.    E-Mail: rpresuhn@bmc.com
  2883.  
  2884.  
  2885.    Jon Saperia
  2886.    BGS Systems, Inc.
  2887.    One First Avenue
  2888.    Waltham, MA 02254
  2889.    USA
  2890.  
  2891.    Phone: +1 617 663-4682
  2892.    Fax:   +1 617 890-0000
  2893.  
  2894.    E-Mail: saperia@networks.bgs.com
  2895.  
  2896.  
  2897. 10.  References
  2898.  
  2899.    [1]  Grillo, P., and S. Waldbusser, "Host Resources MIB", RFC 1514,
  2900.    September 1993.
  2901.  
  2902.    [2]  Freed, N., and S. Kille, "Network Services Monitoring MIB", RFC
  2903.    1565, January 1994.
  2904.  
  2905.    [3]  Freed, N., and S. Kille, "Mail Monitoring MIB", RFC 1566,
  2906.  
  2907.  
  2908.  
  2909. Applmib Working Group     Expires December 1997                [Page 52]
  2910.  
  2911. Internet Draft         Application Management MIB           10 July 1997
  2912.  
  2913.  
  2914.    January 1994.
  2915.  
  2916.    [4]  Brower, D., Purvy, R., Daniel, A., Sinykin, M., and J. Smith,
  2917.    "Relational Database Management System (RDBMS) Management Information
  2918.    Base (MIB) using SMIv2", RFC 1697, August 1994.
  2919.  
  2920.    [5]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  2921.    "Structure of Management Information for Version 2 of the Simple
  2922.    Network Management Protocol (SNMPv2)", RFC 1902, January 1996.
  2923.  
  2924.    [6]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual
  2925.    Conventions for Version 2 of the Simple Network Management Protocol
  2926.    (SNMPv2)", RFC 1903, January 1996.
  2927.  
  2928.    [7]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  2929.    "Conformance Statements for Version 2 of the Simple Network
  2930.    Management Protocol (SNMPv2)", RFC 1904, January 1996.
  2931.  
  2932.    [8]  McCloghrie, K. and A. Bierman, "Entity MIB", RFC 2037, October
  2933.    1996.
  2934.  
  2935.    [9]  C. Kalbfleisch, "Applicability of Standards Track MIBs to
  2936.    Management of World Wide Web Servers", RFC 2039, November 1996.
  2937.  
  2938.    [10] Yergeau, F., "UTF-8, a transformation format of Unicode and ISO
  2939.    10646", RFC 2044, October 1996.
  2940.  
  2941.    [11] Krupczak, C., and J. Saperia, "Definitions of System-Level
  2942.    Managed Objects for Applications",
  2943.    <draft-ietf-applmib-sysapplmib-08.txt>, April 1997.
  2944.  
  2945.    [12] ITU-T Recommendation X.744 | ISO/IEC IS 10164-18:1996,
  2946.    Information Technology - Open Systems Interconnection - Systems
  2947.    Management: Software Management Function, 1996.
  2948.  
  2949.    [13] IEEE P1387.2, POSIX System Administration - Part 2: Software
  2950.    Administration.  (Draft)
  2951.  
  2952.    [14] Daniele, M., Francisco, D., and B. Wijnen, "Agent Extensibility
  2953.    (AgentX) Protocol", <draft-ietf-agentx-pro-03.txt>, April, 1997.
  2954.  
  2955.    [15] Rose, M., "SNMP MUX Protocol and MIB", RFC 1227, May 1991.
  2956.  
  2957.    [16] Reynolds, J. and J. Postel, "ASSIGNED NUMBERS", RFC 1700, STD 2,
  2958.    October, 1994.
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965. Applmib Working Group     Expires December 1997                [Page 53]
  2966.  
  2967. Internet Draft         Application Management MIB           10 July 1997
  2968.  
  2969.  
  2970. 11.  Issues and List of Things Left To Be Done
  2971.  
  2972.    The following issues remain to be resolved.
  2973.  
  2974.       -  Should applOpenConnectionApplication be a human-readable thing
  2975.          or something like an RMON protocol identifier?
  2976.  
  2977.       -  Is the truncation of the file name used as an index for
  2978.          applOpenFileXrefEntry a problem?
  2979.  
  2980.       -  Decide which object definitions should be borrowed or reference
  2981.          from the ARM work.
  2982.  
  2983.       -  Do we need to report current mode in addition to open mode?
  2984.          For example, fcntl() can change append mode.  (With this
  2985.          revision of the draft, we've reduced the alternatives to read
  2986.          and write, but the issue remains.)
  2987.  
  2988.       -  The syntax for the identifiers for transport and application
  2989.          protocol identifiers should be narrowed down a bit.
  2990.  
  2991.       -  MIB definitions to support the following capabilities are still
  2992.          needed:
  2993.  
  2994.          -  system calls?
  2995.             Strawman: close this issue, no one has argued that we need
  2996.             these.
  2997.  
  2998.          -  stack penetration?
  2999.             Strawman: close this issue, no one has argued that we really
  3000.             need this.
  3001.  
  3002.          -  other networking resources?
  3003.             Strawman: close this issue, what is in the MIB appears to be
  3004.             enough.
  3005.  
  3006.          -  dependency information
  3007.  
  3008.          -  logging capability
  3009.  
  3010.       -  align with stdguide requirements
  3011.  
  3012.       -  add conformance clauses
  3013.  
  3014.       -  Should applOpenconnectionNearEnd (and similar attributes) be
  3015.          Taddress or fqdn?
  3016.  
  3017.       -  should control capabilities be defined at an application,
  3018.  
  3019.  
  3020.  
  3021. Applmib Working Group     Expires December 1997                [Page 54]
  3022.  
  3023. Internet Draft         Application Management MIB           10 July 1997
  3024.  
  3025.  
  3026.          service, or process level in this MIB?
  3027.  
  3028.  
  3029.    The following items were removed from the document's scope section:
  3030.  
  3031.       -  other resources are open to discussion, possibilities include:
  3032.  
  3033.          -  various system calls;
  3034.  
  3035.          -  stack penetration;
  3036.  
  3037.          -  networking resources.
  3038.  
  3039.  
  3040.    Some of the tables, e.g., the applTransactStreamTable, currently have
  3041.    lots of remarkably similar attributes.  By breaking this information
  3042.    into multiple tables and using more indexes, we can achieve what
  3043.    appears to be an overall simplification:
  3044.  
  3045.    Indexes: element, stream
  3046.            applTransactStreamUpTime        TimeStamp
  3047.            applTransactStreamInvCumTime    Counter32
  3048.            applTransactStreamPrfCumTime    Counter32
  3049.  
  3050.    Indexes: element, stream, direction (tx/rx), request/response
  3051.            applTransactFlowTrans           Counter64,
  3052.            applTransactFlowTransLow        Counter32,
  3053.            applTransactFlowBytes           Counter64,
  3054.            applTransactFlowBytesLow        Counter32,
  3055.            applTransactFlowTime            DateAndTime,
  3056.  
  3057.    This makes adding a new, fine-grained table easy:
  3058.    Indexes: element, stream, direction (tx/rx), request/response, kind
  3059.    (where "kind" is the protocol specific transaction type)
  3060.            applTransactKindTrans           Counter64,
  3061.            applTransactKindTransLow        Counter32,
  3062.            applTransactKindBytes           Counter64,
  3063.            applTransactKindBytesLow        Counter32,
  3064.            applTransactKindTime            DateAndTime,
  3065.  
  3066.    There are two tradeoffs here: this approach may be harder to describe,
  3067.    and it would behave differently under get-next/bulk.
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077. Applmib Working Group     Expires December 1997                [Page 55]
  3078.  
  3079.                             Table of Contents
  3080.  
  3081.  
  3082.  
  3083.  
  3084. 1. Introduction ...................................................    1
  3085.  
  3086. 2. Overview .......................................................    2
  3087.  
  3088. 3. Architecture ...................................................    4
  3089.  
  3090. 3.1. Relationships to other MIBs ..................................    4
  3091.  
  3092. 3.1.1. Relationship to NSM ........................................    4
  3093.  
  3094. 3.1.2. Relationship to the System Application MIB .................    5
  3095.  
  3096. 4. MIB Structure ..................................................    5
  3097.  
  3098. 4.1. The open files table .........................................    5
  3099.  
  3100. 4.2. The open files cross-reference table .........................    6
  3101.  
  3102. 4.3. The open connections table ...................................    7
  3103.  
  3104. 4.4. The transaction statistics tables ............................    7
  3105.  
  3106. 4.5. The running application element status table .................    8
  3107.  
  3108. 4.6. The running application element control table ................    8
  3109.  
  3110. 4.7. The application component details table ......................    9
  3111.  
  3112. 5. Definitions ....................................................    9
  3113.  
  3114. 6. Implementation Issues ..........................................   50
  3115.  
  3116. 7. Security Considerations ........................................   51
  3117.  
  3118. 8. Acknowledgements ...............................................   51
  3119.  
  3120. 9. Editors' Addresses .............................................   51
  3121.  
  3122. 10. References ....................................................   52
  3123.  
  3124.  
  3125.  
  3126.  
  3127. Applmib Working Group     Expires December 1997                 [Page 1]
  3128.  
  3129. Internet Draft         Application Management MIB           10 July 1997
  3130.  
  3131.  
  3132. 11. Issues and List of Things Left To Be Done .....................   54
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183. Applmib Working Group     Expires December 1997                 [Page 2]
  3184.