Class CIM_ProtocolEndpoint
extends CIM_ServiceAccessPoint

A communication point from which data may be sent or received. ProtocolEndpoints link system/computer interfaces to LogicalNetworks.

Class Hierarchy

CIM_ManagedElement
   |
   +--CIM_ManagedSystemElement
   |
   +--CIM_LogicalElement
   |
   +--CIM_EnabledLogicalElement
   |
   +--CIM_ServiceAccessPoint
   |
   +--CIM_ProtocolEndpoint

Direct Known Subclasses

CIM_LANEndpoint
CIM_IPProtocolEndpoint
CIM_BGPProtocolEndpoint
CIM_IPXProtocolEndpoint
CIM_TCPProtocolEndpoint
CIM_UDPProtocolEndpoint
CIM_OSPFProtocolEndpointBase
CIM_OSPFProtocolEndpoint
CIM_OSPFVirtualInterface
CIM_SwitchPort
CIM_SecurityAssociationEndpoint
CIM_IPsecSAEndpoint
CIM_IKESAEndpoint

Class Qualifiers

NameData TypeValueScopeFlavors
DescriptionstringA communication point from which data may be sent or received. ProtocolEndpoints link system/computer interfaces to LogicalNetworks.None TRANSLATABLE= true
Versionstring2.8.0TOSUBCLASS= falseTRANSLATABLE= true

Local Class Properties

NameData TypeQualifiers
NameData TypeValueScopeFlavors
Captionstring
DescriptionstringThe Caption property is a short textual description (one- line string) of the object.None TRANSLATABLE= true
MaxLenuint3264None None
CreationClassNamestring
DescriptionstringCreationClassName indicates the name of the class or the subclass used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.None TRANSLATABLE= true
KeybooleantrueNone OVERRIDABLE= false
MaxLenuint32256None None
Descriptionstring
DescriptionstringThe Description property provides a textual description of the object.None TRANSLATABLE= true
MappingStringsstringMIB.IETF|IF-MIB.ifDescrNone None
OverridestringDescriptionNone OVERRIDABLE= false
ElementNamestring
DescriptionstringA user-friendly name for the object. This property allows each instance to define a user-friendly name IN ADDITION TO its key properties/identity data, and description information. Note that ManagedSystemElement's Name property is also defined as a user-friendly name. But, it is often subclassed to be a Key. It is not reasonable that the same property can convey both identity and a user friendly name, without inconsistencies. Where Name exists and is not a Key (such as for instances of LogicalDevice), the same information MAY be present in both the Name and ElementName properties.None TRANSLATABLE= true
EnabledDefaultuint16
DescriptionstringAn enumerated value indicating an administrator's default/startup configuration for an element's Enabled State. By default, the element is "Enabled" (value=2).None TRANSLATABLE= true
ValueMapstring2, 3, 5, 6, 7, 8..32767, 32768..65535None None
ValuesstringEnabled, Disabled, Not Applicable, Enabled but Offline, No Default, DMTF Reserved, Vendor ReservedNone TRANSLATABLE= true
WritebooleantrueNone None
EnabledStateuint16
DescriptionstringEnabledState is an integer enumeration that indicates the enabled/disabled states of an element. It can also indicate the transitions between these requested states. For example, shutting down (value = 4) and starting (value=10) are transient states between enabled and disabled. The following text briefly summarizes the various enabled/disabled states: Enabled (2) indicates that the element is/could be executing commands, will process any queued commands, and queues new requests. Disabled (3) indicates that the element will not execute commands and will drop any new requests. Shutting Down (4) indicates that the element is in the process of going to a Disabled state. Not Applicable (5) indicates the element doesn't support being enabled/disabled. Enabled but Offline (6) indicates that the element may be completing commands, and will drop any new requests. Test (7) indicates that the element is in a test state. Deferred (8) indicates that the element may be completing commands, but will queue any new requests. Quiesce (9) indicates that the element is enabled but in a restricted mode. The element's behavior is similar to the Enabled state, but it only processes a restricted set of commands. All other requests are queued. Starting (10) indicates that the element is in the process of going to an Enabled state. New requests are queued.None TRANSLATABLE= true
MappingStringsstringMIB.IETF|IF-MIB.ifAdminStatusNone None
ModelCorrespondencestringCIM_EnabledLogicalElement.OtherEnabledStateNone None
OverridestringEnabledStateNone OVERRIDABLE= false
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11..32767, 32768..65535None None
ValuesstringUnknown, Other, Enabled, Disabled, Shutting Down, Not Applicable, Enabled but Offline, In Test, Deferred, Quiesce, Starting, DMTF Reserved, Vendor ReservedNone TRANSLATABLE= true
InstallDatedatetime
DescriptionstringA datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.None TRANSLATABLE= true
MappingStringsstringMIF.DMTF|ComponentID|001.5None None
Namestring
DescriptionstringA string which identifies this ProtocolEndpoint with either a port or an interface on a device. To ensure uniqueness, the Name property should be prepended or appended with information from the Type or OtherTypeDescription properties. The method chosen is described in the NameFormat property of this class.None TRANSLATABLE= true
KeybooleantrueNone OVERRIDABLE= false
MaxLenuint32256None None
OverridestringNameNone OVERRIDABLE= false
NameFormatstring
DescriptionstringNameFormat contains the naming heuristic that is chosen to ensure that the value of the Name property is unique. For example, one might choose to prepend the name of the port or interface with the Type of ProtocolEndpoint that this instance is (e.g., IPv4) followed by an underscore.None TRANSLATABLE= true
MaxLenuint32256None None
OtherEnabledStatestring
DescriptionstringA string describing the element's enabled/disabled state when the EnabledState property is set to 1 ("Other"). This property MUST be set to NULL when EnabledState is any value other than 1.None TRANSLATABLE= true
ModelCorrespondencestringCIM_EnabledLogicalElement.EnabledStateNone None
OtherTypeDescriptionstring
DescriptionstringA string describing the type of ProtocolEndpoint when the Type property of this class (or any of its subclasses) is set to 1 (i.e., "Other"). This property should be set to NULL when the Type property is any value other than 1.None TRANSLATABLE= true
MaxLenuint3264None None
ModelCorrespondencestringCIM_ProtocolEndpoint.ProtocolType, CIM_ProtocolEndpoint.ProtocolIFTypeNone None
ProtocolIFTypeuint16
DescriptionstringProtocolIFType is an enumeration synchronized with the IANA ifType MIB, maintained at the URL, http: //www.iana.org/assignments/ianaiftype-mib. Also, // // // // additional values defined by the DMTF are included. The property is used to categorize and classify instances of the ProtocolEndpoint class. Note that if the ProtocolIFType is set to 1 ("Other"), then the type information should be provided in the OtherTypeDescription string property.None TRANSLATABLE= true
MappingStringsstringMIB.IETF|IF-MIB.ifTypeNone None
ModelCorrespondencestringCIM_ProtocolEndpoint.OtherTypeDescriptionNone None
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, ..4095, 4096, 4097, 4098, 4099, 4100, 4101, 4102, 4103, 4104, 4105, 4106, 4107, 4108, 4109, 4110, 4111, 4112, 4113, 4114, 4115, ..32767, 32768..None None
ValuesstringUnknown, Other, Regular 1822, HDH 1822, DDN X.25, RFC877 X.25, Ethernet CSMA/CD, ISO 802.3 CSMA/CD, ISO 802.4 Token Bus, ISO 802.5 Token Ring, ISO 802.6 MAN, StarLAN, Proteon 10Mbit, Proteon 80Mbit, HyperChannel, FDDI, LAP-B, SDLC, DS1, E1, Basic ISDN, Primary ISDN, Proprietary Point-to-Point Serial, PPP, Software Loopback, EON, Ethernet 3Mbit, NSIP, SLIP, Ultra, DS3, SIP, Frame Relay, RS-232, Parallel, ARCNet, ARCNet Plus, ATM, MIO X.25, SONET, X.25 PLE, ISO 802.211c, LocalTalk, SMDS DXI, Frame Relay Service, V.35, HSSI, HIPPI, Modem, AAL5, SONET Path, SONET VT, SMDS ICIP, Proprietary Virtual/Internal, Proprietary Multiplexor, IEEE 802.12, Fibre Channel, HIPPI Interface, Frame Relay Interconnect, ATM Emulated LAN for 802.3, ATM Emulated LAN for 802.5, ATM Emulated Circuit, Fast Ethernet (100BaseT), ISDN, V.11, V.36, G703 at 64K, G703 at 2Mb, QLLC, Fast Ethernet 100BaseFX, Channel, IEEE 802.11, IBM 260/370 OEMI Channel, ESCON, Data Link Switching, ISDN S/T Interface, ISDN U Interface, LAP-D, IP Switch, Remote Source Route Bridging, ATM Logical, DS0, DS0 Bundle, BSC, Async, Combat Net Radio, ISO 802.5r DTR, Ext Pos Loc Report System, AppleTalk Remote Access Protocol, Proprietary Connectionless, ITU X.29 Host PAD, ITU X.3 Terminal PAD, Frame Relay MPI, ITU X.213, ADSL, RADSL, SDSL, VDSL, ISO 802.5 CRFP, Myrinet, Voice Receive and Transmit, Voice Foreign Exchange Office, Voice Foreign Exchange Service, Voice Encapsulation, Voice over IP, ATM DXI, ATM FUNI, ATM IMA, PPP Multilink Bundle, IP over CDLC, IP over CLAW, Stack to Stack, Virtual IP Address, MPC, IP over ATM, ISO 802.5j Fibre Token Ring, TDLC, Gigabit Ethernet, HDLC, LAP-F, V.37, X.25 MLP, X.25 Hunt Group, Transp HDLC, Interleave Channel, FAST Channel, IP (for APPN HPR in IP Networks), CATV MAC Layer, CATV Downstream, CATV Upstream, Avalon 12MPP Switch, Tunnel, Coffee, Circuit Emulation Service, ATM SubInterface, Layer 2 VLAN using 802.1Q, Layer 3 VLAN using IP, Layer 3 VLAN using IPX, Digital Power Line, Multimedia Mail over IP, DTM, DCN, IP Forwarding, MSDSL, IEEE 1394, IF-GSN/HIPPI-6400, DVB-RCC MAC Layer, DVB-RCC Downstream, DVB-RCC Upstream, ATM Virtual, MPLS Tunnel, SRP, Voice over ATM, Voice over Frame Relay, ISDL, Composite Link, SS7 Signaling Link, Proprietary P2P Wireless, Frame Forward, RFC1483 Multiprotocol over ATM, USB, IEEE 802.3ad Link Aggregate, BGP Policy Accounting, FRF .16 Multilink FR, H.323 Gatekeeper, H.323 Proxy, MPLS, Multi-Frequency Signaling Link, HDSL-2, S-HDSL, DS1 Facility Data Link, Packet over SONET/SDH, DVB-ASI Input, DVB-ASI Output, Power Line, Non Facility Associated Signaling, TR008, GR303 RDT, GR303 IDT, ISUP, Proprietary Wireless MAC Layer, Proprietary Wireless Downstream, Proprietary Wireless Upstream, HIPERLAN Type 2, Proprietary Broadband Wireless Access Point to Mulipoint, SONET Overhead Channel, Digital Wrapper Overhead Channel, ATM Adaptation Layer 2, Radio MAC, ATM Radio, Inter Machine Trunk, MVL DSL, Long Read DSL, Frame Relay DLCI Endpoint, ATM VCI Endpoint, Optical Channel, Optical Transport, Proprietary ATM, Voice over Cable, Infiniband, TE Link, Q.2931, Virtual Trunk Group, SIP Trunk Group, SIP Signaling, CATV Upstream Channel, Econet, FSAN 155Mb PON, FSAN 622Mb PON, Transparent Bridge, Line Group, Voice E&M Feature Group, Voice FGD EANA, Voice DID, MPEG Transport, 6To4, GTP, Paradyne EtherLoop 1, Paradyne EtherLoop 2, Optical Channel Group, HomePNA, GFP, ciscoISLvlan, actelisMetaLOOP, Fcip, IANA Reserved, IPv4, IPv6, IPv4/v6, IPX, DECnet, SNA, CONP, CLNP, VINES, XNS, ISDN B Channel Endpoint, ISDN D Channel Endpoint, BGP, OSPF, UDP, TCP, 802.11a, 802.11b, 802.11g, 802.11h, DMTF Reserved, Vendor ReservedNone TRANSLATABLE= true
ProtocolTypeuint16
DeprecatedstringCIM_ProtocolEndpoint.ProtocolIFTypeTOSUBCLASS= falseNone
DescriptionstringProtocolType is an enumeration providing information to categorize and classify different instances of this class. For most instances, information in this enumeration and the subclass' definition overlap. However, there are several cases where a specific subclass of ProtocolEndpoint is not required (for example, there is no Fibre Channel subclass of ProtocolEndpoint). Hence, this property is needed to define the type of Endpoint. This property is deprecated in lieu of the ProtocolIFType enumeration. This is done to have better alignment between the IETF's IF-MIB and this CIM class.None TRANSLATABLE= true
ModelCorrespondencestringCIM_ProtocolEndpoint.OtherTypeDescriptionNone None
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27None None
ValuesstringUnknown, Other, IPv4, IPv6, IPX, AppleTalk, DECnet, SNA, CONP, CLNP, VINES, XNS, ATM, Frame Relay, Ethernet, TokenRing, FDDI, Infiniband, Fibre Channel, ISDN BRI Endpoint, ISDN B Channel Endpoint, ISDN D Channel Endpoint, IPv4/v6, BGP, OSPF, MPLS, UDP, TCPNone TRANSLATABLE= true
RequestedStateuint16
DescriptionstringRequestedState is an integer enumeration indicating the last requested or desired state for the element. The actual state of the element is represented by EnabledState. This property is provided to compare the last requested and current enabled/disabled states. Note that when EnabledState is set to 5 ("Not Applicable"), then this property has no meaning. By default, the element's RequestedState is 5 ("No Change"). Refer to the EnabledState's property Description for explanations of the values in the RequestedState enumeration. It should be noted that there are two new values in RequestedState that build on the statuses of EnabledState. These are "Reboot" (10) and "Reset" (11). The former, Reboot, refers to doing a "Shut Down" and then moving to an "Enabled" state. The latter, Reset, indicates that the element is first "Disabled" and then "Enabled". The distinction between requesting "Shut Down" and "Disabled" should also be noted. The former, Shut Down, requests an orderly transition to the Disabled state, and MAY involve removing power, to completely erase any existing state. The latter, the Disabled state, requests an immediate disabling of the element, such that it will not execute or accept any commands or processing requests. This property is set as the result of a method invocation (such as Start or StopService on CIM_Service), or may be overridden and defined as WRITEable in a subclass. The method approach is considered superior to a WRITEable property, since it allows an explicit invocation of the operation and the return of a result code.None TRANSLATABLE= true
ModelCorrespondencestringCIM_EnabledLogicalElement.EnabledStateNone None
ValueMapstring2, 3, 4, 5, 6, 7, 8, 9, 10, 11, .., 32768..65535None None
ValuesstringEnabled, Disabled, Shut Down, No Change, Offline, Test, Deferred, Quiesce, Reboot, Reset, DMTF Reserved, Vendor ReservedNone TRANSLATABLE= true
Statusstring
DeprecatedstringCIM_ManagedSystemElement.OperationalStatusTOSUBCLASS= falseNone
DescriptionstringA string indicating the current status of the object. Various operational and non-operational statuses are defined. This property is deprecated in lieu of OperationalStatus, which includes the same semantics in its enumeration. This change is made for 3 reasons: 1) Status is more correctly defined as an array. This overcomes the limitation of describing status via a single value, when it is really a multi-valued property (for example, an element may be OK AND Stopped. 2) A MaxLen of 10 is too restrictive and leads to unclear enumerated values. And, 3) The change to a uint16 data type was discussed when CIM V2.0 was defined. However, existing V1.0 implementations used the string property and did not want to modify their code. Therefore, Status was grandfathered into the Schema. Use of the Deprecated qualifier allows the maintenance of the existing property, but also permits an improved definition using OperationalStatus.None TRANSLATABLE= true
MaxLenuint3210None None
ValueMapstringOK, Error, Degraded, Unknown, Pred Fail, Starting, Stopping, Service, Stressed, NonRecover, No Contact, Lost Comm, StoppedNone None
SystemCreationClassNamestring
DescriptionstringThe scoping System's CreationClassName.None TRANSLATABLE= true
KeybooleantrueNone OVERRIDABLE= false
MaxLenuint32256None None
PropagatedstringCIM_System.CreationClassNameNone OVERRIDABLE= false
SystemNamestring
DescriptionstringThe scoping System's Name.None TRANSLATABLE= true
KeybooleantrueNone OVERRIDABLE= false
MaxLenuint32256None None
PropagatedstringCIM_System.NameNone OVERRIDABLE= false
TimeOfLastStateChangedatetime
DescriptionstringThe date/time when the element's EnabledState last changed. If the state of the element has not changed and this property is populated, then it MUST be set to a 0 interval value. If a state change was requested, but rejected or not yet processed, the property MUST NOT be updated.None TRANSLATABLE= true
MappingStringsstringMIB.IETF|IF-MIB.ifLastChangeNone None
OverridestringTimeOfLastStateChangeNone OVERRIDABLE= false
OperationalStatusuint16[]
ArrayTypestringIndexedNone OVERRIDABLE= false
DescriptionstringIndicates the current status(es) of the element. Various health and operational statuses are defined. Many of the enumeration's values are self- explanatory. However, a few are not and are described in more detail. "Stressed" indicates that the element is functioning, but needs attention. Examples of "Stressed" states are overload, overheated, etc. "Predictive Failure" indicates that an element is functioning nominally but predicting a failure in the near future. "In Service" describes an element being configured, maintained, cleaned, or otherwise administered. "No Contact" indicates that the monitoring system has knowledge of this element, but has never been able to establish communications with it. "Lost Communication" indicates that the ManagedSystem Element is known to exist and has been contacted successfully in the past, but is currently unreachable. "Stopped" and "Aborted" are similar, although the former implies a clean and orderly stop, while the latter implies an abrupt stop where the element's state and configuration may need to be updated. "Dormant" indicates that the element is inactive or quiesced. "Supporting Entity in Error" describes that this element may be "OK" but that another element, on which it is dependent, is in error. An example is a network service or endpoint that cannot function due to lower layer networking problems. "Completed" indicates the element has completed its operation. This value should be combined with either OK, Error, or Degraded so that a client can till if the complete operation passed (Completed with OK), and failure (Completed with Error). Completed with Degraded would imply the operation finished, but did not complete OK or report an error. "Power Mode" indicates the element has additional power model information contained in the Associated PowerManagementService association. OperationalStatus replaces the Status property on ManagedSystemElement to provide a consistent approach to enumerations, to address implementation needs for an array property, and to provide a migration path from today's environment to the future. This change was not made earlier since it required the DEPRECATED qualifier. Due to the widespread use of the existing Status property in management applications, it is strongly RECOMMENDED that providers/instrumentation provide BOTH the Status and OperationalStatus properties. Further, the first value of OperationalStatus SHOULD contain the primary status for the element. When instrumented, Status (since it is single-valued) SHOULD also provide the primary status of the element.None TRANSLATABLE= true
MappingStringsstringMIB.IETF|IF-MIB.ifOperStatusNone None
ModelCorrespondencestringCIM_ManagedSystemElement.StatusDescriptionsNone None
OverridestringOperationalStatusNone OVERRIDABLE= false
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, .., 0x8000..None None
ValuesstringUnknown, Other, OK, Degraded, Stressed, Predictive Failure, Error, Non-Recoverable Error, Starting, Stopping, Stopped, In Service, No Contact, Lost Communication, Aborted, Dormant, Supporting Entity in Error, Completed, Power Mode, DMTF Reserved, Vendor ReservedNone TRANSLATABLE= true
StatusDescriptionsstring[]
ArrayTypestringIndexedNone OVERRIDABLE= false
DescriptionstringStrings describing the various OperationalStatus array values. For example, if "Stopping" is the value assigned to OperationalStatus, then this property may contain an explanation as to why an object is being stopped. Note that entries in this array are correlated with those at the same array index in OperationalStatus.None TRANSLATABLE= true
ModelCorrespondencestringCIM_ManagedSystemElement.OperationalStatusNone None