jbsmkumap
- Organization of this page
Function
The jbsmkumap command imports the user mapping definition file (jp1BsUmap.conf) and registers the contents in the common definition information. Executing this command deletes all the mapping information in the common definition information, and replaces it with the information set in the user mapping definition file (jp1BsUmap.conf). If the format of the user mapping definition file (jp1BsUmap.conf) is incorrect, the command returns an error.
Format
jbsmkumap [-h logical-host-name] [-f user-mapping-definition-file-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 register the user mapping information. 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.
-f user-mapping-definition-file-name
Specify the name of the definition file containing the mapping information. If you omit this option, the contents of the default user mapping definition file (jp1BsUmap.conf) are registered in the common definition information. For details on the format of the user mapping definition file, see User mapping definition file in 16. Definition Files.
Notes
-
At command execution, all the mapping information in the common definition information is deleted, and the information written in the mapping definition file is registered in its place. If you want to keep any of the previous mapping information, include that information in the mapping definition file.
-
To check the settings done by this command, use the jbsgetumap command.
-
When you register user mapping information by using a definition file that contains a large number of definitions, it might take a long time to apply the definition contents to the common definition information. While user mapping information is being updated, masked user functionality cannot be used, and therefore operations that require masked user functionality (such as JP1/AJS job execution and remote commands in JP1/IM - Manager) cannot be performed.
Therefore, if you intend to update a large amount of user mapping information at one time, execute the jbssetumap command in a maintenance period not during operation. If you want to update a large amount of user mapping information during operation, consider splitting the definition contents before executing the jbssetumap command. This minimizes the time required by the jbssetumap command to apply the definition contents to the common definition information. For details on the jbssetumap command, see jbssetumap.
Return values
1 |
Normal end |
0 |
Abnormal end |