PutMessageTimeToLive method

Prepares a message to send to another QAnywhere client.

Syntax
Visual Basic
Public Sub PutMessageTimeToLive( _
   ByVal address As String, _
   ByVal msg As QAMessage, _
   ByVal ttl As Long _
)
C#
public void PutMessageTimeToLive(
   string  address,
   QAMessage msg,
   long ttl
);
Parameters
  • address   The address of the message specifying the destination queue name.

  • msg   The message to put.

  • ttl   The delay, in milliseconds, before the message expires if it has not been delivered. A value of 0 indicates the message does not expire.

Remarks

The PutMessageTimeToLive method inserts a message and a destination address into your local message store. The time of message transmission depends on QAnywhere Agent transmission policies. However, if the next message transmission time exceeds the given time-to-live value, the message expires.

For more information, see Determining when message transmission should occur on the client.

The address takes the form id\queue-name, where id is the destination message store id and queue-name identifies a queue that is used by the destination QAnywhere client to listen for or receive messages.

For more information about QAnywhere addresses, see QAnywhere message addresses.

Exceptions