Using the LEADTOOLS CCOW Context Manager
The LEADTOOLS CCOW Context Manager is a COM local server. Each request for a context management interface will return the same instance of the context management interface. As a result, only one copy of the LEADTOOLS CCOW Context Manager application will ever be running.
Local Server Registration
The context manager will have to be registered on the user’s machines before it can be used in a context management system.
- To register the context manager launch the Leadtool.Ccow.Server with the register command option:
directory\Leadtools.Ccow.Server /register
- To unregister the context manager launch the Leadtool.Ccow.Server with the register command option:
directory\Leadtools.Ccow.Server /unregister
The server can be started in two ways:
- The context manager executable will be automatically started when an application requests that a COM object be created with “CCOW.ContextManager” progid. If the application is created in this way it will automatically close when the last reference is a context manager is closed.
- Clicking on the application icon. If the application is started this way it will not go away when the last reference is closed. It will be up to the user to close the application by right clicking on its tray icon ( ).
Configuring the LEADTOOLS CCOW Context Manager
To configure the LEADTOOLS CCOW Server right-click the tray icon and click Configuration. The Configuration menu choice will bring up the following dialog:
The Configuration dialog has the following tabs for configuration:
- Applications - Associate applications with the context manager. In order to join the common context an application will have to be registered with the context manager.
- Subjects – List the subjects that the context manager supports. At installation the following subjects are supported: User, Patient, Encounter, Observation, DICOMStudyComponent, DICOMSeries, DICOMInstance and DICOMStudy
- Advanced - Controls advanced settings for the context manager.
Context Manger Configuration Application Tab
Commands:-
Add - Add a new application to the Context Manager. The following information will need to be provided:
- Name - The name of the application. If you have multiple instances of an application use the "%" symbol to indicate that additional characters may come after the primary application name. For example, if Application% is specified, the following applications will be able to join the context: Application1, Application2, etc.
- Passcode - If the application will be setting secure subject they it will need a passcode. This passcode is used for passcode base authentication.
- Allowed - Check to allow the application to join the context.
- Edit - Edit the selected application.
- Delete - Delete the selected application. The application will no longer be able to join the context.
- Allow All - Allow all the applications to join the context.
- Allow None - Do not allow any of the applications to join the context.
Context Manger Configuration Subject Tab
Commands:-
-
Add - Add a new subject to the context manager. The Add command button will open the following dialog:
- Name - The name of the subject.
- Secure - Select if the subject is secure.
- Items - The subject item names.
- Dependent Subjects - Select the subjects that this subject is dependent on.
- Allowed Applications - If the subject is secure, select applications that are allowed to set the subject context data.
- Edit - Edit the selected subject.
- Delete - Delete the selected subject.
Context Manger Configuration Advanced Tab
Commands:
-
-
Apply - Applies the current settings
- Max Participants - The maximum number of participants allowed to connect to the context manager. To specify no limit set the value to -1 .
- Transaction Timeout - The maximum amount of time to wait for a context transaction to complete.
- Action Timeout - The maximum amount of time to wait for an action to time out.
- Notification Timeout - The maximum amount of time to wait for a response from a participant that has been notified of a context change.
- Notification Retry Interval - The amount of time to wait before retrying to notify an unresponsive participant of a context change.
- Ping Notification Timeout - The maximum amount of time to wait for a response to a ping request.
- Ping Interval - The amount of time to wait before attempting to ping context participants. If an application fails to respond to a ping request, it will be removed from the context manager.
- Ping Participants - Select to instruct the context manager to ping the participants using the Ping Interval.