XREG – Unregister Users

Users should be deleted (unregistered) whenever they no longer need to use Dimensions. The XREG command enables the base database managers for a base database to delete users from it.

The syntax is as follows:

XREG <UserId> [/[NO]KEEP]

where:

Parameter | Description
<UserId> | Is the login id of the Dimensions user to be deleted, for example, USER_A. To disable "proxy" user login, specify * as the user-id. For details about proxy users, see the Administration Guide. NOTE After the proxy login is disabled, no user can to access the database without requiring to be registered.
/[NO]KEEP | Determines whether associated delegations and user role assignments are to be kept or deleted.

CAUTION! For this function to run successfully, it is important to ensure that no other Dimensions or RDBMS activity, which affects this user, should occur while it is running. The operation must also not be interrupted or terminated prematurely.

Prior to the XREG operation being started, the command will check to see if any users are currently connected to the database. The operation will not be attempted if the user is active. However, the XREG operation does not prevent users attempting to connect while the operation is in progress.

Once the XREG operation has completed, an advisory email message is sent to the user.

Although XREG retains the corresponding user profile information, unless /KEEP is specified associated delegations and user role assignments (specified by the Dimensions Define User Roles (DUR) command or the Process Modeler) are also deleted.

Upon completion of the delete operation, the deleted userretained within the base database, and such a user becomes Dormant.

Access the function in the Administration Console:

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

Credential Sets Considerations

XREG checks the credential set table for any matches. If a match is found:

- A warning stating credential set records exist is issued to the user.

- All corresponding credential set records are deleted.

- Any area definitions referencing the above credential sets have the credential set uid field (AREA_CATALOGUE.AREA_CS_UID) reset as well as the user name field (AREA_CATALOGUE.AREA_USERNAME).