PASSWORD

Changes or removes the password for a user or account.

Syntax

PASSWORD {(options}

Command Class

TCL-I command.

Options

A Sets an account password, rather than a user password.  This option is effective in the SYSMAN account only; otherwise, it is ignored.

X Displays the password in hexadecimal characters.

Prompts

Please enter user id: (From SYSMAN account only)

Enter Account name: (From SYSMAN account only, with A option)

Enter current password: (Not from SYSMAN account)

Enter new password:

Please re-enter your new password to verify:

Restrictions

Used from SYSMAN to change or remove a user or account password. Used from other accounts to change the password of the current user.

A minimum password length may be specified by the PasswordLength database configuration parameter.

Error Messages

If a password that is shorter than the minimum length is entered at the Enter new password: prompt, the following message is displayed:

Your password is too short, please try again!

If an incorrect password is entered at the Please re-enter your new password to verify: prompt, the following message is displayed:

Your password does not verify!

In either case, the system redisplays the prompt

Enter new password:

If the PASSWORD command is entered from the SYSMAN account and an invalid account name is entered, the following message is displayed:

Invalid Account

Examples

Assume an existing account "TESTACC" with a password "TST". The password is to be changed to "PASSTEST" as shown in examples 1 and 2. These examples illustrate changing the password with and without the hexadecimal X option, respectively. The A option is required to change an account password. 

Example 1 From SYSMAN Account

:PASSWORD (A)

Enter Account name: TESTACC

Enter new password: PASSTEST

Please re-enter your new password to verify: PASSTEST

Example 2 From SYSMAN Account

:PASSWORD (XA)

Enter Account name: TESTACC
                     54695354656767
Enter new password: PASSTEST
                     5065535354695354
Please re-enter your new password to verify: PASSTEST
                     5065535354695354

Example 3 From a User Account

This example shows the PASSWORD command being used to remove a user password (not the account password).

:PASSWORD

Enter current password: RETURN

Enter new password: RETURN

Please re-enter your new password to verify: RETURN

Example 4 From SYSMAN Account

This example shows changing a user's password from the SYSMAN account.

:PASSWORD

Please enter user-id: EMP7158   Enter new password: RETURN

Please re-enter your new password to verify: RETURN