jbsadduser
- Organization of this page
Function
The jbsadduser command registers a JP1 user. This command prompts you to enter a password for the JP1 user you want to register. When you specify the -p option, the system registers the specified password without prompting you for the entry of a password. If you specify the -ds option, you do not need to enter a password when registering linked users.
The -ds option enables you to register linked users without passwords.
Format
jbsadduser [-h logical-host-name] [-s authentication-server-name] [-p password | -ds#] JP1-user-name
- #:
-
The -ds option can be specified in Windows only.
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 JP1 user will be registered on the authentication server set for this logical host.
-s authentication-server-name
Specify the authentication server on which to register the JP1 user. When you set this option, the -h option is ignored.
-p password
Specify the password for the standard user. This specification is case sensitive. You can enter a character string that is from 6 to 32 bytes to specify the password. For the password, you can use ASCII characters excluding tab characters, spaces, and some special characters (\ " :). When you specify this option, the system registers the specified password without prompting the entry of a password.
-ds
This option can be specified in Windows only.
You can register linked users by using this option. When a JP1 user who has been registered as a linked user by using this option, the JP1 user must use a password managed by the directory server.
JP1-user-name
Specify the user name to be registered as a JP1 user. You can use alphanumeric characters to specify a JP1 user name but the characters must be lower case. You can enter a character string that is from 1 to 31 bytes to specify the logical host. Note that you cannot use tab characters, space, or any of the following characters in the JP1 user name: * / \ " ' ^ [ ] { } ( ) : ; | = , + ? < >
Notes
-
Type the -h option and logical host name, the -s option and authentication server name, the -p option and password, and the -ds option and linked user, 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, the JP1 user is registered on the authentication server set for the physical host.
-
This command cannot be used for DS users. Create a user on a directory server.
-
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 has been already registered |
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 |