nn::nex::ChangeDupSetOperation Class

Syntax

class ChangeDupSetOperation : public nn::nex::DOOperation

Description

DOOperation class that executes when a duplication master creates or deletes one duplica.

This operation can only be called by a duplication master object (DuplicatedObject::IsADuplicationMaster). It executes each time a duplica (DuplicatedObject::IsADuplica) of the duplication master is created or deleted.

When a duplica is added, the following sequence of events executes.

・The duplicated object receives a message needed for creating a duplica.
SafetyExecutive is called to inquire whether it is all right to create the object.
If there is a problem, execution aborts. If there is no problem, the process continues.
・The system calls DataSet::OperationBegin on all datasets.
・The system calls DuplicatedObject::OperationBegin.
・The duplication master creates a trigger for AddToStoreOperation on the station where the duplica will be created. ・The duplica is added to the duplication master's duplica location set.
・The system calls DataSet::OperationEnd.
・The system calls DuplicatedObject::OperationEnd.

When a duplica is deleted, the following sequence of events executes.

RemoveFromStoreOperation is called, targeting the station from which the duplica will be removed. ・The duplication master receives the message needed to delete one duplica.
SafetyExecutive is called to inquire whether it is all right to create the object.
If there is a problem, execution aborts. If there is no problem, the process continues.
・The system calls DataSet::OperationBegin on all datasets.
・The system calls DuplicatedObject::OperationBegin.
・The duplica is deleted from the duplication master's duplica location set.
・The system calls DataSet::OperationEnd.
・The system calls DuplicatedObject::OperationEnd.

If the station is currently leaving the session, this operation aborts.

Enumerated Types

Type Enumerated type representing the types of operations called by the system. (Inherits Operation.)

Member Functions

GetTargetStation Gets the duplicated object handle of the station that is the target of this operation.
GetTargetStationPointer Gets a pointer to a duplicated object on the station that is the target of this operation.
IsADuplicaAddition Gets whether this operation is running in order to add a duplica.
IsADuplicaRemoval Determines whether this operation is running in order to remove a duplica.
GetAssociatedDOHandle Gets the duplicated object handle associated with this operation. (Inherits DOOperation.)
GetOrigin Gets a duplicated object handle to a station that has called a function that generates an operation object as a result of the call. (Inherits DOOperation.)
GetAssociatedDO Gets a pointer to the duplicated object associated with an operation. (Inherits DOOperation.)
PV GetType Returns the type of this operation object.
GetUserData Gets user-defined values. (Inherits Operation.)
SetUserData Sets user-defined values. (Inherits Operation.)
PV GetClassNameString Gets the class name of this operation object.
S DynamicCast Uses runtime information for dynamic casting. (Inherits Operation.)
S SetTraceFilter Sets the callback function that specifies when to run traces on operation objects. (Inherits Operation.)

Class Hierarchy

nn::nex::RootObject
  nn::nex::Operation
    nn::nex::DOOperation
      nn::nex::ChangeDupSetOperation

Revision History

2011/03/04
Initial version.

CONFIDENTIAL