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