1 tony  1.1 // ===================================================================
  2           // Title:       Application MOF Specification 2.8, Runtime
  3           //              Application Model
  4           // Filename:    Application28_AppRuntime.mof
  5           // Version:     2.8
  6           // Status:      Final
  7           // Date:        Jan 26, 2004
  8           // ===================================================================
  9           // Copyright 1998-2003 Distributed Management Task Force, Inc. (DMTF).
 10           // All rights reserved.
 11           // DMTF is a not-for-profit association of industry members dedicated
 12           // to promoting enterprise and systems management and interoperability.
 13           // DMTF specifications and documents may be reproduced for uses
 14           // consistent with this purpose by members and non-members,
 15           // provided that correct attribution is given.
 16           // As DMTF specifications may be revised from time to time,
 17           // the particular version and release date should always be noted.
 18           // 
 19           // Implementation of certain elements of this standard or proposed
 20           // standard may be subject to third party patent rights, including
 21           // provisional patent rights (herein "patent rights"). DMTF makes
 22 tony  1.1 // no representations to users of the standard as to the existence
 23           // of such rights, and is not responsible to recognize, disclose, or
 24           // identify any or all such third party patent right, owners or
 25           // claimants, nor for any incomplete or inaccurate identification or
 26           // disclosure of such rights, owners or claimants. DMTF shall have no
 27           // liability to any party, in any manner or circumstance, under any
 28           // legal theory whatsoever, for failure to recognize, disclose, or
 29           // identify any such third party patent rights, or for such party's
 30           // reliance on the standard or incorporation thereof in its product,
 31           // protocols or testing procedures. DMTF shall have no liability to
 32           // any party implementing such standard, whether such implementation
 33           // is foreseeable or not, nor to any patent owner or claimant, and shall
 34           // have no liability or responsibility for costs or losses incurred if
 35           // a standard is withdrawn or modified after publication, and shall be
 36           // indemnified and held harmless by any party implementing the
 37           // standard from any and all claims of infringement by a patent owner
 38           // for such implementations.
 39           // 
 40           // For information about patents held by third-parties which have
 41           // notified the DMTF that, in their opinion, such patent may relate to
 42           // or impact implementations of DMTF standards, visit
 43 tony  1.1 // http://www.dmtf.org/about/policies/disclosures.php.
 44           // ===================================================================
 45           // Description: These classes represent the characterization of a
 46           //      running application that supports a particular business
 47           //      function and that can be managed as an independent unit.
 48           //      They are maintained as a separate MOF file in the
 49           //      Application Model.
 50           // 
 51           //      The object classes below are listed in an order that
 52           //      avoids forward references. Required objects, defined
 53           //      by other working groups, are omitted.
 54           // ==================================================================
 55           // Change Log for v2.8 Preliminary
 56           //      15 May 2003
 57           //         - CR 1063 - Original Application Runtime Model
 58           //         - CR 1147 - Change name of LastStatusUpdate
 59           //                     property in the RuntimeApplicationSystem and
 60           //                     change the statistics association to point
 61           //                     to the CIM_Application class.
 62           //     19 Dec 2003 CIM 2.8 Final
 63           //         - CR 1178 - Change to the CIM_ApplicationSystem class
 64 tony  1.1 //                     to add the application runtime subclass back in.
 65           //         - CR 1197 - Delete DependencyCharacteristics[] from
 66           //                     CIM_ApplicationSystemDependency
 67           //         - CR 1198 - Move the Application Runtime Model from
 68           //                     Preliminary to Final status
 69           // ===================================================================
 70           
 71           #pragma locale ("en_US")
 72           
 73           // ===================================================================
 74           // ApplicationSystemDependency
 75           // ===================================================================
 76              [Association, Version ( "2.8.0" ), Description (
 77                  "This dependency expresses use-relationships or other logical "
 78                  "interactions between application systems. At the business "
 79                  "level, the relationship could be due to a distributed business "
 80                  "process. Viewed from the technical level, the relationship is "
 81                  "to be interpreted as communication between application "
 82                  "systems. ApplicationSystemDependency primarily expresses "
 83                  "'horizontal' relationships, i.e., relationships between "
 84                  "distributed or local application systems.")]
 85 tony  1.1 class CIM_ApplicationSystemDependency : CIM_Dependency {
 86           
 87                 [Override ( "Antecedent" ), Description (
 88                     "Antecedent represents the independent application system in "
 89                     "this association.")]
 90              CIM_ApplicationSystem REF Antecedent;
 91           
 92                 [Override ( "Dependent" ), Description (
 93                     "Dependent represents the application system dependent on "
 94                     "the Antecedent.")]
 95              CIM_ApplicationSystem REF Dependent;
 96           };
 97           
 98           
 99           // ===================================================================
100           // ApplicationSystemHierarchy
101           // ===================================================================
102              [Association, Aggregation, Version ( "2.8.0" ), Description (
103                  "Application systems may have arbitrarily complex structures. "
104                  "It may be necessary to build application system hierarchies "
105                  "including the two-step hierarchy of distributed and local "
106 tony  1.1        "systems. ApplicationSystemHierarchy allows building "
107                  "containment trees (only one parent at a time). It should not "
108                  "be used to express use-relationships; use "
109                  "CIM_ApplicationSystemDependency instead.")]
110           class CIM_ApplicationSystemHierarchy : CIM_Component {
111           
112                 [Aggregate, Override ( "GroupComponent" ), Max ( 1 ), 
113                  Description (
114                     "The parent ApplicationSystem in the association.")]
115              CIM_ApplicationSystem REF GroupComponent;
116           
117                 [Override ( "PartComponent" ), Description (
118                     "The child ApplicationSystem in the association.")]
119              CIM_ApplicationSystem REF PartComponent;
120           };
121           
122           // ===================================================================
123           // StatisticalRuntimeOverview
124           // ===================================================================
125              [Version ( "2.8.0" ), Description (
126                  "This class represents statistical data and metrics that "
127 tony  1.1        "characterize the application as a whole. It exists only once "
128                  "per application system instance and provides primarily raw "
129                  "data for the monitoring of service levels. Therefore, the "
130                  "metrics presented are only a summary or overview of the "
131                  "application system behavior at a certain point of time. "
132                  "Instances are only available if the concerned application is "
133                  "running. Therefore, an instance of ApplicationSystem MUST "
134                  "exist when the instance of this class is created.")]
135           class CIM_StatisticalRuntimeOverview : CIM_StatisticalData {
136           
137                 [Description (
138                     "The point in time (date and time) when the most recent "
139                     "inbound activity was observed for the application. A value "
140                     "of all zeros indicates that no inbound activity has taken "
141                     "place since the application was started.")]
142              datetime LastActivity;
143           
144                 [Description (
145                     "The number of requests currently being served. This is not "
146                     "the count of open connections! Very often it reflects the "
147                     "number of current user requests. Note that the semantics of "
148 tony  1.1           "a request are general enough to characterize the entire "
149                     "application system."), 
150                  Counter]
151              uint32 NumberOfActiveRequests;
152           
153                 [Description (
154                     "The number of active requestors in the application system. "
155                     "It may differ from the number of active requests (greater "
156                     "if a requestor has issued multiple requests, smaller if "
157                     "some of the requestors have no request running at the "
158                     "considered point in time). Very often it reflects the "
159                     "number of user logged on to the application system or the "
160                     "number of sessions being served by the system. \n"
161                     "Note that the semantics of a requestor are general enough "
162                     "to characterize the entire application system."), 
163                  Counter]
164              uint32 NumberOfActiveRequestors;
165           
166                 [Description (
167                     "The average response time is the mean of a number of "
168                     "requests captured between StatisticTime and a close point "
169 tony  1.1           "in time in the past. This interval or duration, that the "
170                     "average depends on, is defined by the underlying "
171                     "implementation such that it still has a reasonable "
172                     "proximity to one point in time. The term average is not "
173                     "focused on averaging a number of requests but averaging a "
174                     "period of time. Therefore, the average does not relate to "
175                     "more than a couple of minutes and, consequently, "
176                     "AverageResponseTime has the notion of the response time at "
177                     "the point in time of StatisticTime. If the interval is too "
178                     "great, AverageResponseTime becomes meaningless for "
179                     "monitoring. If no response time can be determined, the "
180                     "value is 0."), 
181                  Units ( "MilliSeconds" )]
182              uint32 AverageResponseTime;
183           };
184           
185           
186           // ===================================================================
187           // AssociatedAppSystemOverviewStatistics
188           // ===================================================================
189              [Association, Version ( "2.8.0" ), Description (
190 tony  1.1        "The link to the runtime overview statistics of an application "
191                  "system.")]
192           class CIM_AssociatedAppSystemOverviewStatistics : CIM_ElementStatisticalData {
193           
194                 [Override ( "ManagedElement" ), Min ( 1 ), Max ( 1 ), 
195                  Description (
196                     "The application system for which the overview is defined.")]
197              CIM_ApplicationSystem REF ManagedElement;
198           
199                 [Override ( "Stats" ), Max ( 1 ), Description (
200                     "The application system runtime statistical overview.")]
201              CIM_StatisticalRuntimeOverview REF Stats;
202           };
203           
204           
205           // ==================================================================
206           // end of file
207           // ==================================================================