Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# OS_USER_LOCATIONS

TIBCO iProcess Workspace (Windows) Configuration

## Summary

This attribute defines where iProcess Engine should obtain the list of users when it populates the Possible iProcess User List in the User Manager tool of TIBCO iProcess Administrator.

Note: This attribute is only used on the Windows variant of iProcess Engine. It has no effect if it is set on a UNIX system.

## Applies To

This attribute must be set for ALL processes.

## Permissible Values

The attribute value must be a text string of 1024 characters or less, which consists of a comma-delimited list of machine and/or domain names in the following format:

    “machine[,machine[,M:machine][,D:domain]...]”

Each name in the list can be explicitly identified as either:

| • | a `machine`, by using the `M:` prefix.

| • | a `domain`, by using the `D:` prefix. A domain name can be specified either as a simple name (for example, `EMEA`), or as a fully qualified domain name (for example, `xyzCorp.dev.EMEA`).

A name is treated as a machine name in the absence of either prefix.

## Default Value

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

Machine ID | Process | Instance | Value
0 | ALL | 0 | See

The default value is:

`machine`, `user`

where:

| • | `machine` is the name of the computer hosting this iProcess Engine node installation.

| • | `user` is the location of the user that ran the Setup program to install this iProcess Engine node. (If `machine` is a standalone computer, rather than a member of a domain, `user` is blank.)

For example, if iProcess Engine was installed on a computer called SERVER_TIB3 using the domain user account \\EMEA\AJones, the default value for this attribute would be:

    SERVER_TIB3,D:EMEA

If SERVER_TIB3 was a standalone computer and AJones a local account, the default value would be:

    SERVER_TIB3

The existing attribute value is preserved when you upgrade iProcess Engine.

## Notes

When a user clicks the Possible iProcess User List button in the User Manager tool of TIBCO iProcess Administrator, the iProcess Engine node populates the displayed list of operating system (OS) logins with all the user names found in each location specified in this attribute value. User names are displayed in the format:

    location\user

where `location` is the machine or domain specified in the `OS_USER_LOCATIONS` attribute, and `name` is the user name found in that location.

Note: You can use the `plist -U` command to display the list of OS users that will be generated by the current setting of the `OS_USERS_LOCATION` value.

If iProcess Engine is unable to contact a specified machine or domain for any reason, it writes an appropriate error message (with message ID 1631) to the `sw_warn` file. For example:

    2006/11/30 14:07:47(plist:2784:2784:0:stevec:filosuvm.c:1.18:341): 1631-WARNING: <osuv_get_nxt_user (): NetQueryDisplayInformation(dev1) failed: Access is denied.><> <> <>
    2006/11/30 14:07:54(plist:2784:2784:0:stevec:filosuvm.c:1.18:341): 1631-WARNING: <osuv_get_nxt_user (): NetQueryDisplayInformation(invalid) failed: The RPC server is unavailable.> <> <> <>
    2006/11/30 14:08:06(plist:2784:2784:0:stevec:filosuvm.c:1.18:341): 1631-WARNING: <priv_GetLocationMachineName (): GetDomainController(ff) failed: The specified domain either does not exist or could not be contacted.> <> <> <>

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.