Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# BG_LEAVER_DESTINATION

Process Management Configuration

## Summary

This attribute specifies the destination queue to which work items are redirected when the owner of the work items has been deleted.

## Applies To

The attribute must be set for the `BG` processes.

## Permissible Values

This attribute value must be a valid name of the user-specified destination queue or the Admin user’s queue.

## Default Value

The attribute is assigned the following default value when an iProcess Engine node is installed.

Machine ID | Process | Instance | Value
1 | BG | 0 | 1

## Notes

If a user is deleted, the work items that are currently in the user’s queue can be redirected to a user-specified destination or the Admin user’s queue. This attribute is used with the BG_LEAVER_SUPER_AS_DEST attribute. Details of how to use these attributes are as follows:

| • | To redirect the work items to a user-specified queue when a user has just been deleted, follow these steps:

| a. | Set the value of the `BG_LEAVER_SUPER_AS_DEST` attribute to `0`.

| b. | Set the value of the `BG_LEAVER_DESTINATION` attribute to a user-specified destination queue.

| • | To redirect the work items to the Admin user’s queue when a user is deleted, set the value of the `BG_LEAVER_SUPER_AS_DEST` attribute to `0`.

Note: The deleted user’s work items are redirected to the Admin user’s queue by default, if the `BG_LEAVER_DESTINATION` attribute is not set. If the `BG_LEAVER_DESTINATION` attribute has been set, use the `swadm delete_attribute` command to delete this setting. For more information about this command, see Delete a Process Attribute.

| • | To redirect the work items to the first supervisor’s queue when a user is deleted, set the value of the `BG_LEAVER_SUPER_AS_DEST` attribute to `1`.

For more information about configuring the `BG_LEAVER_SUPER_AS_DEST` attribute, see BG_LEAVER_SUPER_AS_DEST.

If the name of the destination queue, which is specified in setting the `BG_LEAVER_DESTINATION` attribute, is currently removed, the work item will be redirected to the Admin user’s queue.

When a user is deleted, an entry is inserted into the `leavers` table, and a corresponding entry is also inserted into the `redir_defn` table. These records will be removed automatically when the following conditions are met:

| • | All work items of the deleted user are redirected.

| • | The period specified by the `WQS_LEAVER_PERIOD` attribute expires.

The `WQS_LEAVER_PERIOD` attribute is set by minutes, and its default value is `60`.

| • | Perform a `Movesysinfo` request or iProcess Engine shuts down.

Note: When iProcess Engine starts up, the timestamp column for all records in the leavers table are updated to the current time.

If the records in the `leavers` table and the `redir_defin` table are not removed, they will be removed when the deleted user is added to iProcess Engine again.

## See Also

BG_LEAVER_SUPER_AS_DEST

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.