com.apama.position.tracker
Event PSTrackerFactory


This is the main factory event used by applications to create a Position Tracker Interface object.

This interface is then used to register Position Tracker objects, to query what Trackers exist and their state, and also so that the Position Management Service can create and delete Position Tracker instances based on subscriptions.

A set of Position Trackers have been provided with the CMF in the Position Trackers bundle. These Position Trackers monitor the quantity and cash position of orders that are placed in the application. These Position Tracker implementations must be created in the context that is receiving the orders in the application.

Alternatively, applications with different requirements may choose to implement a custom Position Tracker using the Position Tracker Interface. This will allow a custom implementation to be used within the CMF Position Service architecture, which provides a framework for subscription management, publication of position information and persistence/recovery.
See Also:
com.apama.position.tracker.PSTrackerInterface - The set of user callbacks that will be called by the Position Service Manager when new Tracker instances are required
com.apama.position.tracker.PSTrackerManagerInterface - The user-level interface that can be used to update and query the Position Tracker instances
com.apama.position.tracker.OpenPositionTrackerFactory - The factory to create a Position Tracker to track completed orders
com.apama.position.tracker.PendingPositionTrackerFactory - The factory to create a Position Tracker to track orders pending (IE not completed) in the market
com.apama.position.tracker.ReservedPositionTrackerFactory - The factory to create a Position Tracker to track reservation orders pending (IE not completed) in the market

Action summary
 voidregisterTracker(string psTrackerName, string psTrackerType, context mainContext, com.apama.position.PositionConfigSchema configSchema, com.apama.position.tracker.PSTrackerInterface trackerCbIface, action<com.apama.position.tracker.PSTrackerManagerInterface, boolean, string> cbRegistered)

This action registers a new Position Tracker with the Position Service, and provides a set of callbacks that the Position Service will call to create/delete Position Tracker instances.
 voidregisterTrackerWithConfig(string psTrackerName, string psTrackerType, context mainContext, com.apama.position.PositionConfigSchema configSchema, com.apama.position.tracker.PSTrackerInterface trackerCbIface, action<dictionary<string, string>, action<>> cbOnConfig, action<com.apama.position.tracker.PSTrackerManagerInterface, boolean, string> cbRegistered)

This action registers a new Position Tracker with the Position Service, and provides a set of callbacks that the Position Service will call to create/delete Position Tracker instances.
 
Action detail

registerTracker

void registerTracker(string psTrackerName, string psTrackerType, context mainContext, com.apama.position.PositionConfigSchema configSchema, com.apama.position.tracker.PSTrackerInterface trackerCbIface, action<com.apama.position.tracker.PSTrackerManagerInterface, boolean, string> cbRegistered)
This action registers a new Position Tracker with the Position Service, and provides a set of callbacks that the Position Service will call to create/delete Position Tracker instances.

A Position Tracker Manager Interface (com.apama.position.PSTrackerManagerInterface), is returned which can be used to query or modify existing Position Trackers, and to query the current state of the Position Service.
Parameters:
psTrackerName - The name of the Position Tracker that is being registered
psTrackerType - The type of the Position Tracker that is being registered
mainContext - The main context where the Service Framework has been created
configSchema
trackerCbIface - An interface object that defines the set of action callbacks the Position Tracker is registering
cbRegistered - The user-defined callback action that will be called when the Position Tracker Manager Interface has been created
See Also:
com.apama.position.tracker.PSTrackerInterface - The set of user callbacks that will be called by the Position Service Manager when new Tracker instances are required
com.apama.position.tracker.PSTrackerManagerInterface - The user-level interface that can be used to update and query the Position Tracker instances

registerTrackerWithConfig

void registerTrackerWithConfig(string psTrackerName, string psTrackerType, context mainContext, com.apama.position.PositionConfigSchema configSchema, com.apama.position.tracker.PSTrackerInterface trackerCbIface, action<dictionary<string, string>, action<>> cbOnConfig, action<com.apama.position.tracker.PSTrackerManagerInterface, boolean, string> cbRegistered)
This action registers a new Position Tracker with the Position Service, and provides a set of callbacks that the Position Service will call to create/delete Position Tracker instances.

A Position Tracker Manager Interface (com.apama.position.PSTrackerManagerInterface), is returned which can be used to query or modify existing Position Trackers, and to query the current state of the Position Service. This action is the same as the registerTracker() action, but also requires an extra action callback that will be called when the Position Tracker needs initial configuration. For example, if the Position Tracker implementation has its own persistence mechanism.
Parameters:
psTrackerName - The name of the Position Tracker that is being registered
psTrackerType - The type of the Position Tracker that is being registered
mainContext - The main context where the Service Framework has been created
configSchema
trackerCbIface - An interface object that defines the set of action callbacks the Position Tracker is registering
cbOnConfig - The user-defined callback action that will be called when the Position Tracker Interface needs to be initially configured
cbRegistered - The user-defined callback action that will be called when the Position Tracker Interface has been created
See Also:
com.apama.position.tracker.PSTrackerInterface - The set of user callbacks that will be called by the Position Service Manager when new Tracker instances are required
com.apama.position.tracker.PSTrackerManagerInterface - The user-level interface that can be used to update and query the Position Tracker instances