Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved


Chapter 6 Administering Process Attributes : TIBCO iProcess Workspace (Windows) Configuration : OS_USER_LOCATIONS

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.
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.
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
Copyright © Cloud Software Group, Inc. All Rights Reserved