Change User

This instruction adds or deletes a user. It consists of the single character U followed by either + to add, or - to delete the user:

U-name

Delete the name user.

U+name[@location]

Add the name user.

If iProcess Engine is running on a Windows system, you can optionally include a location (a single valid machine name or domain name) which will be used to check if the user is a valid Windows operating system user. See Validating New Users on a Windows iProcess Engine.

location is ignored on UNIX platforms or when using UVAPI to perform user validation.

The new user is given default attribute values, which may subsequently be changed with the change attribute value instruction.

For example,

U-keith
U+peter
U+fred@EMEA

Validating New Users on a Windows iProcess Engine

Unless an alternative user validation system has been implemented using the UVAPI, an iProcess Engine user must also exist as an operating system user. On Windows, when iProcess Engine processes a U+ instruction to add a new user, it will only create the user if it can find the named user on the following search path:

1.

the location specified in the location parameter in the U+ instruction.

2.

the location defined by the value of the LOGON_OS_LOCATION process attribute.

3.

the search path provided by the Windows LookupAccountName function.

If the user cannot be found in any of these locations, the add user instruction fails.

For more information about:

•

UVAPI, see TIBCO iProcess User Validation API User's Guide.

•

LOGON_OS_LOCATION, see "Administering Process Attributes" in TIBCO iProcess Engine Administrator’s Guide.