Menu:
AngeliaSchedulerTM - On-Line Help - Remote Queue Manager
The Remote Queue Manager - (AngeliaSchedRQM.exe) is a Windows desktop application that is used to monitor and control the operation of the AngeliaScheduler Service either locally or via a network connection. If the AngeliaScheduler Service is running under a Personal Edition license then the Remote Queue Manager must be run on the system hosting the service.
The Remote Queue Manager communicates via a TCP/IP connection to the AngeliaScheduler Service host, even if the Remote Queue Manager is running on the same system as the AngeliaScheduler Service. When running locally, you can connect using your computer's network computername, or you can use either "LocalHost" or "127.0.0.1" as the host address.
When the Remote Queue Manager starts up, the user is prompted for a host address, a user-id, and a password. The AngeliaScheduler Service at the specified host address validates the user-id and password using its Configuration Database and allows the connection to continue or issues a rejection error message. The host address may be specified as a network computer name (assuming network name resolution is available), or as an IP Address of the form "nnn.nnn.nnn.nnn:pppp" where nnn is a number from 0 to 255 and pppp is a TCP Port number (1 to 65535). If the TCP Port number (":pppp") is omitted then the default port number of 61762 is used. Port number can also be appended to a host name (for example - "MyComputerName:61762").
Whenever a successful AngeliaScheduler connection is made, the host address used is added to the Remote Queue Manager Connection History List and will appear in the drop down list whenever the Connect Dialog is invoked. The most recent successful connection will be selected by default. You may remove obsolete hosts from the list by using the Remote Queue Manager Client Configuration dialog (click "Modify" on the Remote Queue Manager tool bar and then select "Client Configuration"). You can also change the default TCP Port that the client will use when making connections. The default port for the client must match your choice of port in the AngeliaScheduler Service configuration for a successful connection to be made. The initial default value for TCP Port 61762. Changing the TCP Port should only be necessary in the unlikely event another of your applications is already using port 61762.
Since the Remote Queue Manager operates in a stateless mode, no "logical connection" information is maintained by the AngeliaScheduler Service – which means there is no such thing as "orphan sessions" to be cleared in the event of communications failures. It also means that all messages received by the AngeliaScheduler Service must be authenticated; a process that is handled automatically by the AngeliaScheduler Service and the Remote Queue Manager once the initial authentication exchange has been successfully accomplished.
If more than one AngeliaScheduler Service is available on your network, you can either switch to a different host by selecting "Connect" and authenticating with that host; or you can run multiple instances of the Remote Queue Manager and connect each to a different host. Note that each host has its own user access rights database, so a user might have a different privilege level on different host systems.
When the Remote Queue Manager has successfully authenticated with an AngeliaScheduler Service, a list of the queues configured on that host will be shown. Select a queue in the list and the tasks on that queue will be displayed in a second list. Double-click on the queue to show a list of queue attributes, some of which may be changed assuming you have been granted adequate access rights to do so. Double-click on an attribute to see that item in a modification form that includes a description of the data item. The "Apply" button will be disabled if you lack the necessary access rights to change that value. See the Configuring Queues help section to review specific queue configuration options. Core Service Configuration items and Users And Access Rights may also be modified via the Remote Queue Manager by clicking the "Modify" tool bar item and then clicking the desired selection in the drop down list.
To add a task to a queue, select the queue by highlighting it in the list, and then click "New Task" on the tool bar. Details of Task Configuration are discussed in another help section.
A Note On Licensing: AngeliaScheduler Licenses apply to the AngeliaScheduler Service and Configuration Database -- in other words, you must have a license for each instance of the AngeliaScheduler Service that you are running (ie - one per AngeliaScheduler Service host system). An AngeliaScheduler License at any Product Edition level entitles you to install the Remote Queue Manager on as many desktops as you require.