SW_SET_QUEUE

The SW_SET_QUEUE procedure forces all messages posted in the current database session to use the same background queue.

Syntax

SW_SET_QUEUE ()

Notes

By default, SSOLite stored procedures write messages to the BG processes using the default background message queues, using a round-robin allocation on a per-session basis. This allows the message load to be spread evenly across all of the available background queues. (See Processing Queues for more information.)

If required, you can use the SW_SET_QUEUE procedure to force all messages that are subsequently posted in the current session to use the same background queue.

After the SW_SET_QUEUE procedure has been called, the next message that is posted uses the next available background queue (as per normal round-robin allocation). Subsequent messages are then posted to the same queue, until either:

the SW_UNSET_QUEUE procedure is called, after which messages are again allocated on the default round-robin basis, or
the database session is terminated.