Specifies a policy that determines when message transmission occurs.
qaagent -policy policy-type ...policy-type: ondemand | scheduled[ interval-in-seconds ] | automatic | rules-file
QAnywhere uses a policy to determine when message transmission occurs. The policy-type can be one of the following values:
ondemand Only transmit messages when the QAnywhere client application makes the appropriate method call.
The QAManager PutMessage() method causes messages to be queued locally. These messages are not transmitted to the server until the QAManager TriggerSendReceive() method is called. Similarly, messages waiting on the server are not sent to the client until TriggerSendReceive() is called by the client.
When using the on demand policy, the application is responsible for causing a message transmission to occur when it receives a push notification from the server. A push notification causes a system message to be delivered to the QAnywhere client. In your application, you may choose to respond to this system message by calling TriggerSendReceive().
For an example, see System queue.
scheduled When a schedule is specified, every n seconds the Agent performs message transmission if any of the following conditions are met:
New messages were placed in the client message store since the previous time interval elapsed.
A message status change occurred since the previous time interval elapsed. This typically occurs when a message is acknowledged by the application. For more information about acknowledgement, see:
A push notification was received since the previous time interval elapsed.
A network status change notification was received since the previous time interval elapsed.
Push notifications are disabled.
You can call the trigger send/receive method to override the time interval. It forces message transmission to occur before the time interval elapses. See:
automatic Transmit messages when one of the events described below occurs.
The QAnywhere Agent attempts to keep message queues as current as possible. Any of the following events cause messages queued on the client to be delivered to the server and messages queued on the server to be delivered to the client:
Invoking PutMessage().
Invoking TriggerSendReceive().
A push notification.
For information about notifications, see Scenario for messaging with push notifications.
A message status change on the client. For example, a status change occurs when an application retrieves a message from a local queue which causes the message status to change from pending to received.
rules-file Specifies a client transmission rules file. The transmission rules file can indicate a more complicated set of rules to determine when messages are transmitted.
| Discuss this page in DocCommentXchange. Send feedback about this page using email. |
Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1 |