1 karl  1.1 // ===================================================================
  2           // Title:  Runtime Application Model
  3           // $State: Preliminary $
  4           // $Date: 2004/07/02 22:50:19 $
  5           // $Source: /home/dmtf2/dotorg/var/cvs/repositories/dev/Schema/MOF/Application_AppRuntime.mof,v $
  6           // $Revision: 1.3 $
  7           // ===================================================================
  8           //#pragma inLine ("Includes/copyright.inc")
  9           // Copyright 1998-2004 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 karl  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 karl  1.1 // http://www.dmtf.org/about/policies/disclosures.php.
 44           //#pragma inLine
 45           // ===================================================================
 46           // Description: These classes represent the characterization of a
 47           //      running application that supports a particular business
 48           //      function and that can be managed as an independent unit.
 49           //      They are maintained as a separate MOF file in the
 50           //      Application Model.
 51           // 
 52           //      The object classes below are listed in an order that
 53           //      avoids forward references. Required objects, defined
 54           //      by other working groups, are omitted.
 55           // ==================================================================
 56           // Change Log for v2.8 Preliminary
 57           //      15 May 2003
 58           //         - CR 1063 - Original Application Runtime Model
 59           //         - CR 1147 - Change name of LastStatusUpdate
 60           //                     property in the RuntimeApplicationSystem and
 61           //                     change the statistics association to point
 62           //                     to the CIM_Application class.
 63           //     19 Dec 2003 CIM 2.8 Final
 64 karl  1.1 //         - CR 1178 - Change to the CIM_ApplicationSystem class
 65           //                     to add the application runtime subclass back in.
 66           //         - CR 1197 - Delete DependencyCharacteristics[] from
 67           //                     CIM_ApplicationSystemDependency
 68           //         - CR 1198 - Move the Application Runtime Model from
 69           //                     Preliminary to Final status
 70           // ===================================================================
 71           
 72           #pragma locale ("en_US")
 73           
 74           // ===================================================================
 75           // ApplicationSystemDependency
 76           // ===================================================================
 77              [Association, Version ( "2.8.0" ), Description (
 78                  "This dependency expresses use-relationships or other logical "
 79                  "interactions between application systems. At the business "
 80                  "level, the relationship could be due to a distributed business "
 81                  "process. Viewed from the technical level, the relationship is "
 82                  "to be interpreted as communication between application "
 83                  "systems. ApplicationSystemDependency primarily expresses "
 84                  "'horizontal' relationships, i.e., relationships between "
 85 karl  1.1        "distributed or local application systems.")]
 86           class CIM_ApplicationSystemDependency : CIM_Dependency {
 87           
 88                 [Override ( "Antecedent" ), Description (
 89                     "Antecedent represents the independent application system in "
 90                     "this association.")]
 91              CIM_ApplicationSystem REF Antecedent;
 92           
 93                 [Override ( "Dependent" ), Description (
 94                     "Dependent represents the application system dependent on "
 95                     "the Antecedent.")]
 96              CIM_ApplicationSystem REF Dependent;
 97           };
 98           
 99           
100           // ===================================================================
101           // ApplicationSystemHierarchy
102           // ===================================================================
103              [Association, Aggregation, Version ( "2.8.0" ), Description (
104                  "Application systems may have arbitrarily complex structures. "
105                  "It may be necessary to build application system hierarchies "
106 karl  1.1        "including the two-step hierarchy of distributed and local "
107                  "systems. ApplicationSystemHierarchy allows building "
108                  "containment trees (only one parent at a time). It should not "
109                  "be used to express use-relationships; use "
110                  "CIM_ApplicationSystemDependency instead.")]
111           class CIM_ApplicationSystemHierarchy : CIM_Component {
112           
113                 [Aggregate, Override ( "GroupComponent" ), Max ( 1 ), 
114                  Description (
115                     "The parent ApplicationSystem in the association.")]
116              CIM_ApplicationSystem REF GroupComponent;
117           
118                 [Override ( "PartComponent" ), Description (
119                     "The child ApplicationSystem in the association.")]
120              CIM_ApplicationSystem REF PartComponent;
121           };
122           
123           // ===================================================================
124           // StatisticalRuntimeOverview
125           // ===================================================================
126              [Version ( "2.8.0" ), Description (
127 karl  1.1        "This class represents statistical data and metrics that "
128                  "characterize the application as a whole. It exists only once "
129                  "per application system instance and provides primarily raw "
130                  "data for the monitoring of service levels. Therefore, the "
131                  "metrics presented are only a summary or overview of the "
132                  "application system behavior at a certain point of time. "
133                  "Instances are only available if the concerned application is "
134                  "running. Therefore, an instance of ApplicationSystem MUST "
135                  "exist when the instance of this class is created.")]
136           class CIM_StatisticalRuntimeOverview : CIM_StatisticalData {
137           
138                 [Description (
139                     "The point in time (date and time) when the most recent "
140                     "inbound activity was observed for the application. A value "
141                     "of all zeros indicates that no inbound activity has taken "
142                     "place since the application was started.")]
143              datetime LastActivity;
144           
145                 [Description (
146                     "The number of requests currently being served. This is not "
147                     "the count of open connections! Very often it reflects the "
148 karl  1.1           "number of current user requests. Note that the semantics of "
149                     "a request are general enough to characterize the entire "
150                     "application system."), 
151                  Counter]
152              uint32 NumberOfActiveRequests;
153           
154                 [Description (
155                     "The number of active requestors in the application system. "
156                     "It may differ from the number of active requests (greater "
157                     "if a requestor has issued multiple requests, smaller if "
158                     "some of the requestors have no request running at the "
159                     "considered point in time). Very often it reflects the "
160                     "number of user logged on to the application system or the "
161                     "number of sessions being served by the system. \n"
162                     "Note that the semantics of a requestor are general enough "
163                     "to characterize the entire application system."), 
164                  Counter]
165              uint32 NumberOfActiveRequestors;
166           
167                 [Description (
168                     "The average response time is the mean of a number of "
169 karl  1.1           "requests captured between StatisticTime and a close point "
170                     "in time in the past. This interval or duration, that the "
171                     "average depends on, is defined by the underlying "
172                     "implementation such that it still has a reasonable "
173                     "proximity to one point in time. The term average is not "
174                     "focused on averaging a number of requests but averaging a "
175                     "period of time. Therefore, the average does not relate to "
176                     "more than a couple of minutes and, consequently, "
177                     "AverageResponseTime has the notion of the response time at "
178                     "the point in time of StatisticTime. If the interval is too "
179                     "great, AverageResponseTime becomes meaningless for "
180                     "monitoring. If no response time can be determined, the "
181                     "value is 0."), 
182                  Units ( "MilliSeconds" )]
183              uint32 AverageResponseTime;
184           };
185           
186           
187           // ===================================================================
188           // AssociatedAppSystemOverviewStatistics
189           // ===================================================================
190 karl  1.1    [Association, Version ( "2.8.0" ), Description (
191                  "The link to the runtime overview statistics of an application "
192                  "system.")]
193           class CIM_AssociatedAppSystemOverviewStatistics : CIM_ElementStatisticalData {
194           
195                 [Override ( "ManagedElement" ), Min ( 1 ), Max ( 1 ), 
196                  Description (
197                     "The application system for which the overview is defined.")]
198              CIM_ApplicationSystem REF ManagedElement;
199           
200                 [Override ( "Stats" ), Max ( 1 ), Description (
201                     "The application system runtime statistical overview.")]
202              CIM_StatisticalRuntimeOverview REF Stats;
203           };
204           
205           
206           // ==================================================================
207           // end of file
208           // ==================================================================