Copyright © Cloud Software Group, Inc. All rights reserved.

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.

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 below

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.

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

Copyright © Cloud Software Group, Inc. All rights reserved.