1 karl 1.1 // ===================================================================
2 // Title: Network Collections 2.7
3 // Filename: Network27_Collections.mof
4 // Version: 2.7.1
5 // Status: Preliminary
6 // Date: November 12 2002
7 // ===================================================================
8 // Copyright 1998-2002 Distributed Management Task Force, Inc. (DMTF).
9 // All rights reserved.
10 // DMTF is a not-for-profit association of industry members dedicated
11 // to promoting enterprise and systems management and interoperability.
12 // DMTF specifications and documents may be reproduced for uses
13 // consistent with this purpose by members and non-members,
14 // provided that correct attribution is given.
15 // As DMTF specifications may be revised from time to time,
16 // the particular version and release date should always be noted.
17 //
18 // Implementation of certain elements of this standard or proposed
19 // standard may be subject to third party patent rights, including
20 // provisional patent rights (herein "patent rights"). DMTF makes
21 // no representations to users of the standard as to the existence
22 karl 1.1 // of such rights, and is not responsible to recognize, disclose, or
23 // identify any or all such third party patent right, owners or
24 // claimants, nor for any incomplete or inaccurate identification or
25 // disclosure of such rights, owners or claimants. DMTF shall have no
26 // liability to any party, in any manner or circumstance, under any
27 // legal theory whatsoever, for failure to recognize, disclose, or
28 // identify any such third party patent rights, or for such party's
29 // reliance on the standard or incorporation thereof in its product,
30 // protocols or testing procedures. DMTF shall have no liability to
31 // any party implementing such standard, whether such implementation
32 // is foreseeable or not, nor to any patent owner or claimant, and shall
33 // have no liability or responsibility for costs or losses incurred if
34 // a standard is withdrawn or modified after publication, and shall be
35 // indemnified and held harmless by any party implementing the
36 // standard from any and all claims of infringement by a patent owner
37 // for such implementations.
38 //
39 // For information about patents held by third-parties which have
40 // notified the DMTF that, in their opinion, such patent may relate to
41 // or impact implementations of DMTF standards, visit
42 // http://www.dmtf.org/about/policies/disclosures.php.
43 karl 1.1 // ===================================================================
44 // Description: The Network Model extends the management concepts to
45 // represent protocol interfaces and network/protocol
46 // services. This file defines network "collections" such
47 // as logical networks (collections of protocol endpoints)
48 // and IP address ranges (an implicit collection).
49 //
50 // The object classes below are listed in an order that
51 // avoids forward references. Required objects, defined
52 // by other working groups, are omitted.
53 // ==================================================================
54 // Change Log for v2.7.1
55 // CR920 - Add missing parenthesis to the Description for IPSubnet.
56 // PrefixLength
57 //
58 // Change Log for v2.7
59 // CR803 - Deprecate IPAddressRange and add RangeOfIPAddresses
60 // CR804 - Update description for IBSubnet.SubnetMask and add
61 // .PrefixLength
62 // ===================================================================
63
64 karl 1.1 #pragma Locale ("en_US")
65
66
67 // ==================================================================
68 // LogicalNetwork
69 // ==================================================================
70 [Version ("2.6.0"), Description (
71 "A LogicalNetwork groups together a set of "
72 "ProtocolEndpoints of a given type which are able to "
73 "communicate with each other directly. It is used for "
74 "describing the characteristics of the grouping "
75 "and/or its associated medium. A LogicalNetwork "
76 "represents the ability to send and/or receive data "
77 "over a network.") ]
78 class CIM_LogicalNetwork : CIM_CollectionOfMSEs {
79
80 [Propagated ("CIM_AdminDomain.CreationClassName"), Key,
81 MaxLen (256), Description (
82 "The scoping AdminDomain's CreationClassName.") ]
83 string SystemCreationClassName;
84
85 karl 1.1 [Propagated ("CIM_AdminDomain.Name"), Key, MaxLen (256),
86 Description ("The scoping AdminDomain's Name.") ]
87 string SystemName;
88
89 [Key, MaxLen (256), Description (
90 "CreationClassName indicates the name of the class or the "
91 "subclass used in the creation of an instance. When used "
92 "with the other key properties of this class, this property "
93 "allows all instances of this class and its subclasses to "
94 "be uniquely identified.") ]
95 string CreationClassName;
96
97 [Key, MaxLen (256), Description (
98 "The Name property defines the label by which the object is "
99 "known.") ]
100 string Name;
101
102 [Description (
103 "Type is an enumeration that provides additional "
104 "information that can be used to help categorize and "
105 "classify different instances of this class. \n"
106 karl 1.1 "\n"
107 "Subclasses should ensure that they are of the "
108 "appropriate type defined in the Type enumeration. "
109 "That is, the IPSubnet subclass should define its "
110 "property as either IPv4 or IPv6, as opposed to, "
111 "for example, ATM."),
112 ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
113 "10", "11", "12", "13", "14", "15", "16", "17", "18"},
114 Values {"Unknown", "Other", "IPv4", "IPv6",
115 "IPX", "AppleTalk", "DECnet", "SNA", "CONP",
116 "CLNP", "VINES", "XNS", "ATM", "Frame Relay",
117 "Ethernet", "TokenRing", "FDDI", "Infiniband",
118 "Fibre Channel"},
119 ModelCorrespondence {
120 "CIM_LogicalNetwork.OtherTypeDescription"} ]
121 uint16 NetworkType;
122
123 [MaxLen(64), Description (
124 "A string describing the type of protocol that is "
125 "being run by this LogicalNetwork, when the value of "
126 "the Type property (or any of its subclasses) "
127 karl 1.1 "is set to 1 (i.e., \"Other\"). This property "
128 "should be set to NULL when the Type property is "
129 "any value other than 1."),
130 ModelCorrespondence {"CIM_LogicalNetwork.NetworkType"} ]
131 string OtherTypeDescription;
132 };
133
134
135 // ==================================================================
136 // NetworksInAdminDomain
137 // ==================================================================
138 [Association, Version ("2.6.0"), Description (
139 "This association is used to define the set of Logical"
140 "Networks contained in an AdminDomain. This has the implied "
141 "semantics that this set of LogicalNetworks are all "
142 "managed by the same network administrator that manages "
143 "the domain.") ]
144 class CIM_NetworksInAdminDomain {
145
146 [Key, Min (1), Max (1), Description (
147 "The AdminDomain that hosts the various LogicalNetworks.") ]
148 karl 1.1 CIM_AdminDomain REF Domain;
149
150 [Weak, Key, Description (
151 "The LogicalNetworks that are hosted by the AdminDomain.") ]
152 CIM_LogicalNetwork REF Network;
153 };
154
155
156 // ==================================================================
157 // IPSubnet
158 // ==================================================================
159 [Version ("2.7.0"), Description (
160 "An IPSubnet represents a group of related "
161 "IPProtocolEndpoints that can communicate with each other "
162 "directly using IP. It is used for describing the "
163 "characteristics of the grouping.") ]
164 class CIM_IPSubnet : CIM_LogicalNetwork {
165
166 [Description (
167 "The IP address of the entire subnet, formatted according "
168 "to the appropriate convention as defined in the AddressType "
169 karl 1.1 "property of this class.") ]
170 string SubnetNumber;
171
172 [Description (
173 "The mask for the starting IPv4 address of the IPSubnet, "
174 "if needed (i.e., if the AddressType property is 1, "
175 "\"IPv4\").") ]
176 string SubnetMask;
177
178 [Experimental, Description (
179 "The prefix length for IPv6 addresses in the IPSubnet, "
180 "if needed (i.e., if the AddressType property is 2, "
181 "\"IPv6\").") ]
182 uint8 PrefixLength;
183
184 [Description (
185 "An enumeration that describes the format of the address "
186 "properties in IPSubnet."),
187 ValueMap {"0", "1", "2"},
188 Values {"Unknown", "IPv4", "IPv6"} ]
189 uint16 AddressType;
190 karl 1.1 };
191
192
193 // ==================================================================
194 // LANSegment
195 // ==================================================================
196 [Version ("2.6.0"), Description (
197 "A collection of LAN Endpoints of a particular type "
198 "that are able to intercommunicate directly without "
199 "the assistance of bridging or routing services.") ]
200 class CIM_LANSegment : CIM_LogicalNetwork {
201
202 [MaxLen(64), Description (
203 "A label or identifier for the LAN Segment."),
204 ModelCorrespondence {"CIM_LANEndpoint.LANID"} ]
205 string LANID;
206
207 [Description (
208 "An indication of the kind of technology used on the LAN."),
209 ValueMap {"0", "1", "2", "3", "4"},
210 Values {"Unknown", "Other", "Ethernet", "TokenRing", "FDDI"},
211 karl 1.1 ModelCorrespondence {"CIM_LANEndpoint.LANType"} ]
212 uint16 LANType;
213
214 [MaxLen(64), Description (
215 "A string describing the type of technology used on the LAN "
216 "when the value of the LANType property of this class (or "
217 "any of its subclasses) is set to 1 (i.e., \"Other\"). The "
218 "format of the string inserted in this property should be "
219 "similar in format to the values defined for the LANType "
220 "property. This property should be set to NULL when the "
221 "LANType property is any value other than 1."),
222 ModelCorrespondence {"CIM_LANSegment.LANType"} ]
223 string OtherLANType;
224 };
225
226
227 // ==================================================================
228 // IPXNetwork
229 // ==================================================================
230 [Version ("2.6.0"), Description (
231 "A network or subnet that uses the IPX protocol.") ]
232 karl 1.1 class CIM_IPXNetwork : CIM_LogicalNetwork {
233
234 [Description (
235 "An IPX network number formatted as eight hexadecimal "
236 "digits (e.g., \"00112233\").") ]
237 string NetworkNumber;
238 };
239
240
241 // ==================================================================
242 // InLogicalNetwork
243 // ==================================================================
244 [Association, Aggregation, Version ("2.7.0"),
245 Description (
246 "This association defines a ProtocolEndpoint as a member of "
247 "a specific LogicalNetwork.") ]
248 class CIM_InLogicalNetwork : CIM_CollectedMSEs {
249
250 [Override ("Collection"), Aggregate, Description (
251 "The LogicalNetwork that groups the ProtocolEndpoint "
252 "instances.") ]
253 karl 1.1 CIM_LogicalNetwork REF Collection;
254
255 [Override ("Member"), Description (
256 "The child ProtocolEndpoints that are components of the "
257 "LogicalNetwork.") ]
258 CIM_ProtocolEndpoint REF Member;
259 };
260
261
262 // ==================================================================
263 // RangeOfIPAddresses
264 // ==================================================================
265 [Experimental, Version ("2.7.0"), Description (
266 "The class RangeOfIPAddresses represents an implicit grouping "
267 "(or 'pool') of IP addresses specified by the properties, "
268 "Start and EndAddress. It is defined as scoped/contained by "
269 "a system such as an individual network element or an "
270 "admin domain.") ]
271 class CIM_RangeOfIPAddresses : CIM_SystemSpecificCollection {
272
273 [Description (
274 karl 1.1 "The starting IP address of the AddressRange, formatted "
275 "according to the appropriate convention as defined in the "
276 "AddressType property of this class (e.g., 171.79.6.40)."),
277 ModelCorrespondence {"CIM_RangeOfIPAddresses.AddressType"} ]
278 string StartAddress;
279
280 [Description (
281 "The ending IP address of the AddressRange, formatted "
282 "according to the appropriate convention as defined in the "
283 "AddressType property of this class (e.g., 171.79.6.40)."),
284 ModelCorrespondence {"CIM_RangeOfIPAddresses.AddressType"} ]
285 string EndAddress;
286
287 [Description (
288 "An enumeration that defines how the address and mask "
289 "properties are formatted."),
290 ValueMap {"0", "1", "2"},
291 Values {"Unknown", "IPv4", "IPv6"} ]
292 uint16 AddressType;
293 };
294
295 karl 1.1
296 // ==================================================================
297 // IPAddressRange
298 // ==================================================================
299 [Abstract, Version ("2.7.0"),
300 Deprecated {"CIM_RangeOfIPAddresses"}, Description (
301 "IPAddressRange represents a grouping of specific addresses, "
302 "and provides additional semantics for this group if "
303 "appropriate. The class is deprecated in lieu of the "
304 "concrete class RangeOfIPAddresses since there is "
305 "sufficient information for the class to be instantiated. "
306 "In addition, an address range should be defined in the "
307 "context of a System (for example, a network element or an "
308 "admin domain). These semantics are incorporated in the "
309 "RangeOfIPAddresses class.") ]
310 class CIM_IPAddressRange : CIM_CollectionOfMSEs {
311
312 [Deprecated {"CIM_RangeOfIPAddresses.StartAddress"},
313 Description (
314 "The starting IP address of the AddressRange, formatted "
315 "according to the appropriate convention as defined in the "
316 karl 1.1 "AddressType property of this class (e.g., 171.79.6.40).") ]
317 string StartAddress;
318
319 [Deprecated {"CIM_RangeOfIPAddresses.EndAddress"},
320 Description (
321 "The ending IP address of the AddressRange, formatted "
322 "according to the appropriate convention as defined in the "
323 "AddressType property of this class (e.g., 171.79.6.40).") ]
324 string EndAddress;
325
326 [Deprecated {"CIM_RangeOfIPAddresses.AddressType"},
327 Description (
328 "An enumeration that defines how to format the address and "
329 "mask of the address range that defines this IPSubnet. \n"
330 "\n"
331 "Whenever possible, IPv4-compatible addresses should "
332 "be used instead of IPv6 addresses (see RFC 2373, "
333 "section 2.5.4). In order to have a consistent format "
334 "for IPv4 addresses in a mixed IPv4/v6 environment, all "
335 "IPv4 addresses and both IPv4-compatible IPv6 addresses "
336 "and IPv4-mapped IPv6 addresses, per RFC 2373, section "
337 karl 1.1 "2.5.4, should be formatted in standard IPv4 format."),
338 ValueMap {"0", "1", "2"},
339 Values {"Unknown", "IPv4", "IPv6"} ]
340 uint16 TypeOfAddress;
341
342 [Deprecated {"No value"}, Description (
343 "This attribute defines the region that addresses can be "
344 "allocated to."),
345 ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8"},
346 Values {"Unknown",
347 "Multiregional: 192.0.0.0 to 193.255.255.255",
348 "Europe: 194.0.0.0 to 195.255.255.255",
349 "Others: 196.0.0.0 to 197.255.255.255",
350 "North America: 198.0.0.0 to 199.255.255.255",
351 "Central & South America: 200.0.0.0 to 201.255.255.255",
352 "Pacific Rim: 202.0.0.0 to 203.255.255.255",
353 "Others: 204.0.0.0 to 205.255.255.255",
354 "Others: 206.0.0.0 to 207.255.255.255"} ]
355 uint16 AllocationRegion;
356 };
357
358 karl 1.1
359 // ===================================================================
360 // end of file
361 // ===================================================================
|