UREG – Register Users

Registers a Dimensions CM user. A base database manager may only register users in base databases for which they have such privileges. See also Managing Privileges.

The syntax is as follows:

UREG <UserId> -

[/WORKSET=<project_spec>]

[/[NO]PASSWORD_SAVE] -

[/LOCALE=<locale>] -

[/ATTRIBUTES=(site=<site>,group_id=<group_id>, -

Dept=<dept>,full_name=<full_name>,phone=<Phone>, -

<attribute_id>=<value>,email_addr=<email_addr>)]

[/[NO]PROXY]

Parameter | Description
<UserId> | Is an existing operating system login id for the new Dimensions user, for example, usera. To register a user as a "proxy" user, specify * as the user-id. For details on proxy users, see the Administration Guide. NOTE After the proxy login is enabled, any user can access the database without requiring to be registered.
<project_spec> | Is the specification (in the form <product_id>:<project_name>) of the user's initial default project/stream. If this is not specified, no initial default project/stream is defined for the user.
<locale> | Is the UNIX-style local string, for example, en_US.
<site> | Is the location or site of the new Dimensions user, for example, St. Albans. NOTE You can specify as many or as few of the attribute (this and below) as you want.
<group_id> | Is the group_id of the new Dimensions user, for example, Testing.
<dept> | Is the department of the new Dimensions user, for example, Finance.
<full_name> | Is the full User name of the new Dimensions user, for example, A. N. User
<Phone> | Is the new Dimensions User's telephone number, for example, 01727 812812
<attribute_id> | Is a predefined user-specified attribute and associated value, for example, country_orig=UK NOTE If you subsequently want to update a user’s attributes, you can either do that through the Administration Console or through the dmcli "Update User Attributes" command UUA. For details, see the Command-Line Reference. For details on updating attributes in the Administration Console, see Editing or Removing Attributes.
<email_addr> | Is a free text value for your email address. As the character is the default dmcli escape character, you will need to specify your email address in a form such as myemail@@mycomapny.com. All your Dimensions emails will be sent to this address.
/PASSWORD_SAVE or /NOPASSWORD_Save | Certain Dimensions client tools have a "remote automatic login" facility (see, for example, the clients' online help). To be able to utilize this facility, the user's operating system password on the remote Dimensions server must be saved locally on the client. When you create a Dimensions user: This facility is permitted by specifying the /PASSWORD_SAVE qualifier. Subsequently, the first time a client tool is invoked the user will have the option in the Login dialog of storing their remote login password in an encrypted format on the client (under the existing connection specific key with an Access Control List (ACL) applied to it for added security). Further remote logins will than be automatic unless the CTRL or Shift key is kept depressed during client invocation. This facility is deactivated by specifying the /NOPASSWORD_SAVE qualifier. If neither the /PASSWORD_SAVE nor the /NOPASSWORD_SAVE is specified, then the latter is the assumed default. If the user subsequently changes their remote login password: The next time they try an automatic remote login from one of the specified client tools, they will receive a message informing them that their stored remote login password is incorrect. The Login dialog will be displayed prompting them for their (new) remote login password. Once connection has been established, the new remote login password will get stored as described above. From then on, subsequent remote logins will again be automatic.
/[NO]PROXY | /PROXY enables a user to login as a proxy user, which restricts the actions they can perform. /NOPROXY upgrades a non-proxy user to a full user.

IMPORTANT! The length of each item of information about the new user is limited, and any excess will be truncated. Base database names and passwords are limited to 25 characters and logins IDs to 64 characters.

An advisory email message is sent to the user giving details on changes to the appropriate environment for running Dimensions. The Dimensions Batch Log is mailed to the DBA.

Access the function in the Administration Console:

Users and Roles | User & group registration | Users | Users and Groups tab | New button