jbsumappass (Windows only)
- Organization of this page
Function
The jbsrmumappass command registers an OS user or an information-search user in the JP1/Base password management information. This command also enables you to change the registered OS user's or information-search user's password.
Format
jbsumappass [-h logical-host-name]
-u { OS-user-name | information-search-user-name }
[-p password]
Required execution permission
Administrators. (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
Command directory
installation-folder\bin\
Arguments
-h logical-host-name
When using JP1/Base in a cluster system, specify the logical host for which you want to register the OS user or change an OS user's password. If you omit this option, the host name set in the environment variable JP1_HOSTNAME is assumed. If the environment variable JP1_HOSTNAME is not set, the physical host name is assumed.
-u { OS-user-name | information-search-user-name }
Specify the OS user name or information-search user name that you want to register or change in the password management information.
As the OS user name, you can specify not only a user name but also the name of the domain to which the local host belongs or the local host name. To specify a domain name or local host name, use a backslash (\) as a separator between the domain or local host name and user name (for example, domain\user1 or server\user1). If you specify a domain name, JP1/Base checks if the specified OS user is a user who belongs to that domain. If the specified OS user name is not a user of the domain, you cannot register the user under the OS user name. If you specify a local host name, JP1/Base checks whether the OS user name you entered is a local user. If the specified OS user name is a local user, you cannot register the user under the OS user name.
If you do not specify a domain name or local host name, JP1/Base checks whether the specified OS user is a local user. If the entered OS user is not a local user, JP1/Base checks whether it is a user in a domain containing a trusted domain. If the specified OS user name is not a local user or a user of the domain, you cannot register the user under the OS user name.
To register an OS user name with the Windows domain controller, use the format domain-name\user-name. As the domain controller does not differentiate between a domain user and local user, the user name will be treated as a domain user.
To register an information-search user, type it in the format of aduser/OS-user-name-used-as-the-information-search-user.
-p password
Specify the password for the OS-user-name. Omit this option if the OS user has no password.
Note
In Windows, you need to grant specific Windows user permissions to the OS user who is to execute this command, and to the OS user specified in the user mapping, respectively. For details, see 8.1.5 Assigning user permissions to OS users before setting user mapping.
Return values
|
0 |
The OS user's password was updated. |
|
1 |
The OS user has been registered. |
|
Other than 0 or 1 |
Abnormal end |