Connectors User Control Mode

Each individual connector can be placed in a user control mode using either the *CE_SetSpecificDetailById or *CE_SetSpecificDetail commands.

This user control mode is most useful for automated Tcl scripts. Once in user control mode, the following procedures are possible for a given connector:
  • Pre-existing FE can be registered as a given connector’s realization by using the *CE_FE_Register command.
  • Connectors can be edited without automatically unrealizing, as happens most notably when a link is added or removed from a connector, or when an FE realization entity is deleted.
  • A connector’s state can be manually changed from realized to failed, or from failed to realized by using either the *CE_SetSpecificDetailById or *CE_SetSpecificDetail commands. A connector’s state will not change to or from the unrealized state using this method.
Once a connector is placed into your control mode, your control mode remains active until an unrealize command is called, such as *CE_Unrealize, an already realized connector is re-realized, or your control mode is manually turned off with either the *CE_SetSpecificDetailById or *CE_SetSpecificDetail commands. While a given connector is in user control mode, it may not behave the same as a normal connector. Specifically, there are a number of scenarios where a user-controlled connector will not auto unrealize in response to database changes that would cause a normal connector to auto unrealize.
Note: It is strongly recommended that when FE is registered to a user-controlled connector, that the connector links and other necessary details should also be set with a given connector, so that the connector can properly re-realize if you interactively request it to. At the bare minimum, connectors should know which links they are to connect.