Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# 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.

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.