1 karl 1.1 // ===================================================================
2 // Title: Network SNMP Management 2.7
3 // Filename: Network27_SNMP.mof
4 // Version: 2.7.0
5 // Status: Preliminary
6 // Date: 07/31/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 classes to manage
47 // SNMP (Simple Network Management Protocol) services.
48 //
49 // The object classes below are listed in an order that
50 // avoids forward references. Required objects, defined
51 // by other working groups, are omitted.
52 // ==================================================================
53 // Change Log for v2.7
54 // CR791 - Add classes to support the configuration and management
55 // of SNMP services
56 // ===================================================================
57
58 #pragma Locale ("en_US")
59
60
61 // ==================================================================
62 // SNMPService
63 // ==================================================================
64 karl 1.1 [Experimental, Version ("2.7.0"), Description (
65 "SNMPService represents an SNMP agent running on a hosting "
66 "system. The UDP port to use to contact the agent is "
67 "an instance of UDPProtocolEndpoint. The endpoint is "
68 "associated with the SNMPService via a Dependency "
69 "relationship. The community string(s) to use when contacting "
70 "the SNMP agent reside in instances of SNMPCommunityString, that "
71 "are associated with the SNMPService via the "
72 "ServiceAccessBySAP relationship.") ]
73 class CIM_SNMPService : CIM_Service {
74 };
75
76
77 // ==================================================================
78 // SNMPCommunityString
79 // ==================================================================
80 [Experimental, Version ("2.7.0"), Description (
81 "SNMPCommunityString is an access point for an SNMPService. "
82 "Each instance stores a community string that can be used "
83 "for making SNMP requests.") ]
84 class CIM_SNMPCommunityString : CIM_ServiceAccessPoint {
85 karl 1.1
86 [Description (
87 "The SNMP community string/password used for read or "
88 "read/write access to the agent's data."),
89 MappingStrings {"MIB.IETF|ENTITY-MIB.entLogicalCommunity"} ]
90 string CommunityString;
91
92 [Description (
93 "An enumerated integer describing whether read or read/"
94 "write access is granted, or whether this information is "
95 "unknown."),
96 Values {"Unknown", "Read Only", "Read/Write"} ]
97 uint16 TypeOfAccess;
98
99 [Description (
100 "This array contains one or more object identifiers "
101 "indicating the MIB modules/object subtrees that are "
102 "accessed using the CommunityString. Either text strings of "
103 "numbers (such as 1.2.3.4.5), or words (such as 'system') "
104 "are specified. When using text strings of numbers, an "
105 "asterisk (*) can replace any subidentifier to specify "
106 karl 1.1 "a subtree family - for example, 1.2.*.5. Descriptions "
107 "related to each entry in the array are found at the "
108 "corresponding index of the LogicalEntitiesDescriptions "
109 "property."),
110 ArrayType ("Indexed"),
111 ModelCorrespondence {
112 "CIM_SNMPCommunityString.LogicalEntitiesDescriptions"},
113 MappingStrings {"MIB.IETF|ENTITY-MIB.entLogicalType"} ]
114 string LogicalEntitiesAccessed[];
115
116 [Description (
117 "Free-form textual descriptions of the logical entities "
118 "indicated in the LogicalEntitiesAccessed array. There "
119 "is a correspondence between the entity identifier in "
120 "the LogicalEntitiesAccessed array, and the description "
121 "in this array at the corresponding index."),
122 ArrayType ("Indexed"),
123 ModelCorrespondence {
124 "CIM_SNMPCommunityString.LogicalEntitiesAccessed"},
125 MappingStrings {"MIB.IETF|ENTITY-MIB.entLogicalDescr"} ]
126 string LogicalEntitiesDescriptions[];
127 karl 1.1 };
128
129
130 // ==================================================================
131 // SNMPTrapTarget
132 // ==================================================================
133 [Experimental, Version ("2.7.0"), Description (
134 "SNMPTrapTarget contains information describing "
135 "a remote system, to which Informs and Traps are sent. "
136 "An SNMPService is related via a ServiceSAPDependency "
137 "association to one or more instances of this class.") ]
138 class CIM_SNMPTrapTarget : CIM_RemotePort {
139
140 [Override ("AccessInfo"), Description ("The host address.") ]
141 string AccessInfo;
142
143 [Override ("PortProtocol"), Description (
144 "A UDP port to which the traps/informs are sent.") ]
145 uint16 PortProtocol = 3;
146
147 [Override ("PortInfo"), Description (
148 karl 1.1 "The UDP port number to which the traps/informs are "
149 "sent. The default is port 162.") ]
150 string PortInfo = "162";
151
152 [Description (
153 "Allows the selection of the notification message - "
154 "Traps or Informs. By default, Traps are selected."),
155 ValueMap {"1", "2"}, Values {"Traps", "Informs"} ]
156 uint16 NotificationMessage = 1;
157
158 [Description (
159 "The SNMP version used to send the traps or informs. "
160 "Note that v1 does not support informs."),
161 ValueMap {"1", "2", "3"}, Values {"v1", "v2C", "v3"} ]
162 uint16 SNMPVersion;
163
164 [Description (
165 "A community string/password to send with the "
166 "trap operation.") ]
167 string CommunityString;
168 };
169 karl 1.1
170
171 // ==================================================================
172 // TrapSourceForSNMPService
173 // ==================================================================
174 [Association, Experimental, Version ("2.7.0"),
175 Description (
176 "TrapSourceForSNMPService specifies the protocol "
177 "endpoint/interface (and hence its IP address) from which "
178 "traps originate.") ]
179 class CIM_TrapSourceForSNMPService : CIM_ServiceSAPDependency {
180
181 [Override ("Antecedent"), Max (1),
182 Description (
183 "The endpoint that acts as the trap source.") ]
184 CIM_ProtocolEndpoint REF Antecedent;
185
186 [Override ("Dependent"), Description (
187 "The SNMP service that sends the notifications.") ]
188 CIM_SNMPService REF Dependent;
189 };
190 karl 1.1
191
192 // ===================================================================
193 // end of file
194 // ===================================================================
|