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