8.6.4 hcmdsunlockaccount (unlocking a user account)

Description

This command unlocks a user account. You use this command when all the user accounts are locked and the users cannot log in to JP1/AO.

Syntax

hcmdsunlockaccount
     /user user-ID
     /pass password

Arguments

/user user-ID: This option specifies the user ID of the user account that you want to unlock. You must specify the user ID with User Management permission.
/pass password: This option specifies the password of the user account that you want to unlock.

Located in

Common-Component-installation-folder\bin

Execute permission

Execute the command as a user with Administrator permissions.

Remarks

Only a user account with User Management permission has the ability to unlock user accounts by using the hcmdsunlockaccount command.
If the user name or password specified in the options includes characters, &, |, or ^, enclose the character with double quotation marks (") or escape the character with a caret (^). For example, if the password is ^a^b^c^, the command can be written as hcmdsunlockaccount /user system /pass "^"a"^"b"^"c"^" or hcmdsunlockaccount /user system /pass ^^a^^b^^c^^.

Return code

The following table lists the return codes from the command.

Return code	Description
0	The command succeeded.
251	An authentication error occurred due to login failure.
252	An authentication error occurred due to a lack of User Management permission.
253	The communication with the authentication server failed.
254	The command is executed on the secondary server.
255	The command terminated abnormally.

Example

The following command shows an example of how to unlock a user account:

hcmdsunlockaccount /user test01 /pass TTdate00

Related topic