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