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