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           // ===================================================================