Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 » QAnywhere » QAnywhere Reference » QAnywhere Agent utilities reference » qaagent utility


-policy option

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.

    See Client transmission rules.

See also