This operation is used by the client to discover all the equipment protection groups currently in operation for the managed element.
Refer to the TMF 854 XML Solution Set document for details on the Message Exchange Pattern controls (multiple batch response).
Raises ProcessingFailureException
EXCPT_NOT_IMPLEMENTED - Raised when an OS is unable to support this service
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when meName does not reference a managedElement object
EXCPT_ENTITY_NOT_FOUND - Raised when meName references object which does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
the name of the managed element for which the request is made
This is the response of the getAllEProtectionGroups operation. See also getAllEProtectionGroups_T.
equipment protection groups
This operation gets the list of names of CTPs that are configured to carry Non-preemptible Unprotected extra Traffic. The result is independent of the current switch status.
Refer to the TMF 854 XML Solution Set document for details on the Message Exchange Pattern controls (multiple batch response).
Note that the response message is handled by getObjectNamesResponse_T.
Raises ProcessingFailureException
EXCPT_NOT_IMPLEMENTED - Raised when an OS is unable to support this service
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when pgName does not reference a protectionGroup object
EXCPT_ENTITY_NOT_FOUND - Raised when pgName references object which does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
Name of the protection group
This operation gets the list of names of CTPs that can carry preemptible extra traffic. The result is independent of the current switch status
Refer to the TMF 854 XML Solution Set document for details on the Message Exchange Pattern controls (multiple batch response).
Note that the response message is handled by getObjectNamesResponse_T.
Raises ProcessingFailureException
EXCPT_NOT_IMPLEMENTED - Raised when an OS is unable to support this service
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when pgName does not reference a protectionGroup object
EXCPT_ENTITY_NOT_FOUND - Raised when pgName references object which does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
Name of the protection group
This operation gets the list of CTPs that can carry protected traffic. The result is independent of the current switch status.
Refer to the TMF 854 XML Solution Set document for details on the Message Exchange Pattern controls (multiple batch response).
Note that the response message is handled by getObjectNamesResponse_T.
Raises ProcessingFailureException
EXCPT_NOT_IMPLEMENTED - Raised when an OS is unable to support this service
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when pgName does not reference a protectionGroup object
EXCPT_ENTITY_NOT_FOUND - Raised when pgName references object which does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
Name of the protection group
This operation is used by the client to discover all the protection groups currently in operation for the managed element.
Refer to the TMF 854 XML Solution Set document for details on the Message Exchange Pattern controls (multiple batch response).
Raises ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when meName does not reference a managedElement object
EXCPT_ENTITY_NOT_FOUND - Raised when meName references object which does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
the name of the managed element for which the request is made
This is the response of the getAllProtectionGroups operation. See also getAllProtectionGroups_T.
protection groups
This service returns the names of the Protection Groups containing the given PhysicalTerminationPoint.
Refer to the TMF 854 XML Solution Set document for details on the Message Exchange Pattern controls (multiple batch response).
Note that the response message is handled by getObjectNamesResponse_T.
Raises ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when pTPName does not reference a PTP object
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
The name of the PhysicalTerminationPoint
This operation is used to get the current status of a Equipment Protection Group. This service is needed so that even if a filter is established, the NMS can query the status of a protection group.
Raises ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_NOT_IMPLEMENTED - Raised when an OS is unable to support this service
EXCPT_INVALID_INPUT - Raised when ePGPName does not reference an equipment protection group
EXCPT_ENTITY_NOT_FOUND - Raised when ePGPName references an object which does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
name of the equipment protection group that the client is interested in.
This is the response of the getEProtectionGroup operation. See also getEProtectionGroup_T.
the returned equipment protection group.
This operation is used to get the current status of a Protection Group. This service is needed so that even if a filter is established, the NMS can query the status of a protection group.
Raises ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when pgName does not reference a protection group
EXCPT_ENTITY_NOT_FOUND - Raised when pgName references a PG object that does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
name of the protection group that the client is interested in.
This is the response of the getProtectionGroup operation. See also getProtectionGroup_T.
the returned protection group.
This service is used by the NMS to get the latest switch status on an equipment protection group.
For a retrieval of a revertive M:N group, N ESwitchData_T are returned as a result of retrieveESwitchData (one for each worker equipment instance).
For a retrieval of a non-revertive M:N group, N ESwitchData_T are returned as a result of retrieveESwitchData (one for each active equipment instance).
Raises ProcessingFailureException
EXCPT_NOT_IMPLEMENTED - Raised when an OS is unable to support this service
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when ePGPName does not reference an equipment object
EXCPT_ENTITY_NOT_FOUND - Raised when ePGPName references object which does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
This is the equipment protection group name for which the switch data is being requested.
This is the response of the retrieveESwitchData operation. See also retrieveESwitchData_T.
The current protection switch status of the equipment protection group provided.
This service is used by the NMS to get the latest switch status on a SNC or a MSP group.
It should be noted that although the term MSP was chosen as the original specific protection scheme to which the related behaviour applied was Multiplex Section Protection, the label is now more generally applied to any 1+1 or 1:N Trail protection scheme.
When used on the reliable CTP/FTP of an SNC, a single struct is returned and the group name is NULL. The switchToTP indicates the presently active source of the traffic to the protectedTP.
When used on a 1+1 MSP, a single struct is provided with the relevant data.
When used on a 1:N MSP, a struct per worker TP is presented with protectedTP being the worker TP Name and the switchToTP identifying the present source of the traffic.
When used on a 2F BLSR, two structs are returned, one per TP. In a stable state, the protectedTP and the switchToTP are the same TP. In a switched state, the switchToTP is the same for both protectedTPs.
When used on a 4F BLSR, two structs are returned, each one identifying a span with the protectedTP being the worker TP and the switchToTP identifying the present source of the ring traffic for that span.
Raises ProcessingFailureException
EXCPT_NOT_IMPLEMENTED - Raised when an OS is unable to support this service
EXCPT_INTERNAL_ERROR - Raised in case of non-specific OS internal failure
EXCPT_INVALID_INPUT - Raised when reliableSinkCtpOrGroupName does not reference a reliable CTP nor FTP nor PG object
EXCPT_ENTITY_NOT_FOUND - Raised when reliableSinkCtpOrGroupName references a CTP or FTP or PG or object that does not exist
EXCPT_COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost
This is the CTP/FTP that is the output of a service selector in case of the SNC or the group name for which the switch data is being requested. The termination point name must be explicit (a generic endpoint specification may not be used in this case).
This is the response of the retrieveSwitchData operation. See also retrieveSwitchData_T.
The current protection switch status of the CTP, FTP or PG provided.