RREG – Reassign User Registration

This command changes the operating system user account that is associated with a Dimensions user.

The syntax is as follows:

RREG <ExistingUserId> /USER=<NewUserId>

where:

Parameter | Description
<ExistingUserId> | Is the old operating-system login id currently associated to a Dimensions user.
<NewUserId> | Is the new operating system login to be associated to a Dimensions user.

For example, if user peter was registered as a Dimensions user and his operating-system account name has been changed to peter_rd, then the command is:

RREG peter /USER=peter_rd

NOTES

- If you change the operating system user account for a database to which you are currently connected, we recommend that you quit your client immediately after running the RREG command.

- RREG completely renames the user account and so will effect the change history. For example, audit trail records that refer to the old operating system account will be updated to the newly specified account.

No equivalent function is available in the Administration Console.

CCS – Create Credential Set

This command creates a credential set with the specified name, user-id, password, and owner. Each user creates their own credential set.

The syntax is as follows:

CCS <credential-spec> -

/USER =<userid> -

/PASSWORD=<password>

[/OWNER=<user or group>]

where:

Parameter | Description
<credential-spec> | Specifies the name of the credential set.
<user-id> | Specifies the operating-system user-id.
<password> | Specifies the operating-system password for the specified user-id.
<owner> | Specifies a user or group that owns the credential set.

No equivalent function is available in the Administration Console.

Overview

Prior to Dimensions CM 10.1.2, each Dimensions CM work or deployment area required a set of credentials (operating-system user-id and password) stored against it, which are then used for any operations performed against that area. When a password expires or changes with respect to a given user-id, the user had to search out the areas that use that set of credentials and update the credentials appropriately.

To facilitate managing credential sets, from Dimensions CM 10.1.2 onwards, user-id and password information is externalized into a user-owned table; this table can then be referenced by the various parts of Dimensions CM that require this type of information, for example, work or deployment areas. By externalizing this data into a user-owned table, the user will be able to update a given set of credentials in one location and have the effects seen across the system.

Features

- The credential set name is unique to each user—there are no global credential sets.

- Credential set names are unique within each base database. A base database upgrade automatically detects and renames duplicate credential set names.

- Credential sets can be owned by an explicitly named user or group. The owner of a credential set can update credential set details, delete the credential set, and associate it with an area or an item library (if they have the appropriate privileges).

- A user may only view, update, delete, or use credential sets that belongs to them.

- A user invokes a credential set by specifying the name wrapped in <> in any field that accepts a user-id. for example:

<my-credential-set>

- Blowfish encryption is used on all credential set passwords.

Related Commands

Command | Description
DCS | Delete Credential Set. See DCS – Delete Credential Set.
UCS | Update Credential Set. See UCS – Update Credential Set.
LCS | List Credential Sets for Current User. See LCS – List Credential Sets for Current User.
XREG | Unregister Users. See XREG – Unregister Users and DUSR in the Command-Line Reference.
AUTH | Authorize Access to Node. See the Command-Line Reference.
CA | Create Area. See the Command-Line Reference.
DUSR | Unregister Users. See the Command-Line Reference and XREG – Unregister Users.
REXEC | Execute a Job on a Network Node. For details, see the Command-Line Reference and the Administration Guide.
UA | Update Area. See the Command-Line Reference.

DCS – Delete Credential Set

This command will delete the specified credential set. Only the user who created a credential set can delete it.

The syntax is as follows:

DCS <credential-spec>

where:

Parameter | Description
<credential-spec> | Is the name of the credential set.

No equivalent function is available in the Administration Console.

UCS – Update Credential Set

Updates an existing credential set. Only the user who created a credential set can update it. If the credential set does not exist it will be added.

The syntax is as follows:

UCS <credential-spec> -

/NEW_NAME=<new credential set name>

/USER =<new user name>

/PASSWORD=<new password>

/OWNER=<new owner>

where:

Parameter | Description
<credential-spec> | Specifies the current name of the credential set.
<new_name> | Specifies the new name of the credential set.
<user-id> | Specifies a new user ID.
<password> | Specifies a new password.
<owner> | Specifies a new user or group that owns the credential set.

No equivalent function is available in the Administration Console.

LCS – List Credential Sets for Current User

This command will list the current credential sets defined for the current user. Only the set name and user-id will be displayed—no password.

The syntax is as follows:

LCS

<credential set name filter>

/OWNER=<user or group>

where:

Parameter | Description
<credential set name filter> | Lists all credential sets that match a pattern (suitable for SQL LIKE).
/OWNER=<user or group> | Lists all credential sets owned by the specified user or group. Use credential sets.

The listing will be similar to the following example:

Name | User ID
D3 | joe-user
N1 | juser
S1 | joeuser

No equivalent function is available in the Administration Console.