es.tid.pce.pcep.objects

Class Monitoring

java.lang.Object

es.tid.pce.pcep.objects.PCEPObject

es.tid.pce.pcep.objects.Monitoring

All Implemented Interfaces:

PCEPElement

public class Monitoring
extends PCEPObject

PCEP Monitoring Object (described in RFC 5886). 4.1. MONITORING Object The MONITORING object MUST be present within PCMonReq and PCMonRep messages (out-of-band monitoring requests) and MAY be carried within PCRep and PCReq messages (in-band monitoring requests). There SHOULD NOT be more than one instance of the MONITORING object in a PCMonReq or PCMonRep message: if more than one instance of the MONITORING object is present, the recipient MUST process the first instance and MUST ignore other instances. The MONITORING object is used to specify the set of requested PCE state metrics. The MONITORING Object-Class (19) has been assigned by IANA. The MONITORING Object-Type (1) has been assigned by IANA. The format of the MONITORING object body is as follows: 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Reserved | Flags |I|C|P|G|L| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Monitoring-id-number | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | // Optional TLV(s) // | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Flags: 24 bits The following flags are currently defined: L (Liveness) - 1 bit: when set, this indicates that the state metric of interest is the PCE's liveness and thus the PCE MUST include a PCE-ID object in the corresponding reply. The L bit MUST always be ignored in a PCMonRep or PCRep message. G (General) - 1 bit: when set, this indicates that the monitoring request is a general monitoring request. When the requested performance metric is specific, the G bit MUST be cleared. The G bit MUST always be ignored in a PCMonRep or PCRep message. P (Processing Time) - 1 bit: the P bit of the MONITORING object carried in a PCMonReq or a PCReq message is set to indicate that the processing times is a metric of interest. If allowed by policy, a PROC-TIME object MUST be inserted in the corresponding PCMonRep or PCRep message. The P bit MUST always be ignored in a PCMonRep or PCRep message. C (Overload) - 1 bit: The C bit of the MONITORING object carried in a PCMonReq or a PCReq message is set to indicate that the overload status is a metric of interest, in which case an OVERLOAD object MUST be inserted in the corresponding PCMonRep or PCRep message. The C bit MUST always be ignored in a PCMonRep or PCRep message. I (Incomplete) - 1 bit: If a PCE supports a received PCMonReq message and that message does not trigger any policy violation, but the PCE cannot provide any of the set of requested performance metrics for unspecified reasons, the PCE MUST set the I bit. The I bit has no meaning in a request and SHOULD be ignored on receipt. Monitoring-id-number (32 bits): The monitoring-id-number value combined with the PCC-REQ-ID identifying the requesting PCC uniquely identifies the monitoring request context. The monitoring-id-number MUST start at a non-zero value and MUST be incremented each time a new monitoring request is sent to a PCE. Each increment SHOULD have a value of 1 and may cause a wrap back to zero. If no reply to a monitoring request is received from the PCE, and the PCC wishes to resend its path computation monitoring request, the same monitoring- id-number MUST be used. Conversely, a different monitoring-id-number MUST be used for different requests sent to a PCE. A PCEP implementation SHOULD checkpoint the Monitoring-id-number of pending monitoring requests in case of restart thus avoiding the reuse of a Monitoring-id-number of an in-process monitoring request. Unassigned bits are considered as reserved and MUST be set to zero on transmission and ignored on reception. No optional TLVs are currently defined.

Author:

ogondio

Field Summary

Fields inherited from class es.tid.pce.pcep.objects.PCEPObject

Ibit, log, object_bytes, ObjectClass, ObjectLength, OT, Pbit, Res

Constructor Summary

Constructors

Constructor and Description
Monitoring()
Monitoring(byte[] bytes, int offset)

Method Summary

Modifier and Type	Method and Description
void	decode() Decode the object.
void	encode() Encode the object.
boolean	equals(Object obj)
long	getMonitoringIdNumber()
RequestInfoTLV	getRequestInfoTLV()
int	hashCode()
boolean	isGeneralBit()
boolean	isIncompleteBit()
boolean	isLivenessBit()
boolean	isOverloadBit()
boolean	isProcessingTimeBit()
void	setGeneralBit(boolean generalBit)
void	setIncompleteBit(boolean incompleteBit)
void	setLivenessBit(boolean livenessBit)
void	setMonitoringIdNumber(long monitoringIdNumber)
void	setOverloadBit(boolean overloadBit)
void	setProcessingTimeBit(boolean processingTimeBit)
void	setRequestInfoTLV(RequestInfoTLV requestInfoTLV)
String	toString()

Methods inherited from class es.tid.pce.pcep.objects.PCEPObject

decode, decodeHeader, encode_header, getBytes, getLength, getObject_bytes, getObjectClass, getObjectClass, getObjectLength, getObjectType, getOT, getRes, isIbit, isPbit, setIbit, setObject_bytes, setObjectClass, setObjectLength, setOT, setPbit, setRes, supportedObject

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Monitoring

public Monitoring()

Monitoring

public Monitoring(byte[] bytes,
                  int offset)
           throws MalformedPCEPObjectException

Throws:

MalformedPCEPObjectException

Method Detail

encode

public void encode()

Description copied from class: PCEPObject

Encode the object. It is specific to the PCEP Object. Must be implemented in each object!!!!!

Specified by:

encode in interface PCEPElement

Specified by:

encode in class PCEPObject

decode

public void decode()
            throws MalformedPCEPObjectException

Description copied from class: PCEPObject

Decode the object. It is specific to the PCEP Object. Must be implemented in each object!!!!

Specified by:

decode in class PCEPObject

Throws:

MalformedPCEPObjectException

isLivenessBit

public boolean isLivenessBit()

setLivenessBit

public void setLivenessBit(boolean livenessBit)

isGeneralBit

public boolean isGeneralBit()

setGeneralBit

public void setGeneralBit(boolean generalBit)

isProcessingTimeBit

public boolean isProcessingTimeBit()

setProcessingTimeBit

public void setProcessingTimeBit(boolean processingTimeBit)

isOverloadBit

public boolean isOverloadBit()

setOverloadBit

public void setOverloadBit(boolean overloadBit)

isIncompleteBit

public boolean isIncompleteBit()

setIncompleteBit

public void setIncompleteBit(boolean incompleteBit)

getMonitoringIdNumber

public long getMonitoringIdNumber()

setMonitoringIdNumber

public void setMonitoringIdNumber(long monitoringIdNumber)

getRequestInfoTLV

public RequestInfoTLV getRequestInfoTLV()

setRequestInfoTLV

public void setRequestInfoTLV(RequestInfoTLV requestInfoTLV)

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class PCEPObject

equals

public boolean equals(Object obj)

Overrides:

equals in class PCEPObject