Job Management Partner 1/Base User's Guide

jbsadduser

Function

The jbsadduser command registers a JP1 user. Use this command when using the local host as the authentication server. 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 only be specified in Windows (except Windows Vista).

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

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 only be specified in Windows (except Windows Vista).

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, and the -s option and authentication server name, 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.

Return values

0 Normal end

1 The user has been already registered

2 Invalid arguments

4 Insufficient system resource such as memory

32 Invalid password

128 Inconsistency in internal processing (a C++ exception)

255 Other error

[Contents][Back][Next]

[Trademarks]

0	Normal end
1	The user has been already registered
2	Invalid arguments
4	Insufficient system resource such as memory
32	Invalid password
128	Inconsistency in internal processing (a C++ exception)
255	Other error