jbschgpasswd
- Organization of this page
Function
The jbschgpasswd command changes the password of a registered JP1 user. This command prompts you to enter the current password and a new password. You can enter a character string that is from 6 to 32 bytes for the password. The new password can be the same as the current one.
Format
jbschgpasswd [-h logical-host-name] [-s authentication-server-name] [-op old-password -np new-password] JP1-user-name
Required execution permission
In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
In UNIX: Superuser or JP1/Base administrator permission
Command directory
- In Windows:
-
installation-folder\bin\
- In UNIX:
-
/opt/jp1base/bin/
Arguments
-h logical-host-name
When using JP1/Base in a cluster system, specify the logical host for which you want to execute this command. The command changes the password of the JP1 user registered on the authentication server set for this logical host.
-s authentication-server-name
Specify the authentication server on which to change the JP1 user's password. When you set this option, the -h option is ignored.
-op old-password
Specify the old password you want to change. Specify this option together with the -np option. When you specify the -op and -np options, the system registers the password specified with the -np option without prompting for the entry of a password.
-np new-password
Specify the new password. Specify this option with the -op option.
JP1-user-name
Specify the JP1 user name whose password you wish to change.
Notes
-
Type the -h option and logical host name, the -s option and authentication server name, the -op option and old password, and the -np option and new password, before the JP1 user name.
-
The -s option takes precedence if you specify both the -h and -s options. If you omit both options, the host name set in the environment variable JP1_HOSTNAME is assumed as the logical host. If you omit both options and nothing is set in JP1_HOSTNAME, this command changes the password of the JP1 user registered on the authentication server set for the physical host.
-
The command prompt treats \, *, &, ?, ^, and %any-character% as special characters. Be aware that they may not be recognized as characters input as part of a password.
Return values
0 |
Normal end |
1 |
The user does not exist, the entered old password is incorrect, or you attempted to change a linked user's password. |
2 |
Invalid arguments |
4 |
Insufficient system resource such as memory |
8 |
The authentication server has not started or is not responding |
16 |
An error occurred in the authentication server side processing |
24 |
Invalid password |
32 |
An error occurred while initializing the communication functionality. |
128 |
Inconsistency in internal processing (a C++ exception) |
255 |
Other error |