jssroleimport (imports role information)
- Organization of this page
Description
This command registers new roles in the JP1/Service Support database.
Format
jssroleimport -i role-information-entries-file-name [-f]
Required execution permission
Administrator permissions
Storage folder
JP1/SS-path\bin\
Arguments
-i role-information-entries-file-name
Use 255 bytes or less to specify the name of a File for role information entries. Count two bytes for full-width characters in the file name. You can use an absolute path or a relative path to specify the file name. When you use a relative path, make sure that it will be 255 bytes or less after it is converted to an absolute path. For the file name, you cannot specify a character string beginning with a hyphen (-). For details about File for role information entries, see File for role information entries (Optional) in Chapter 13. Definition Files.
-f
Continues processing even if some of the data in the File for role information entries is incorrect. When you specify the -f option, the command skips a role in the File for role information entries if the information about the role (role ID, role name, or comment) is incorrect and proceeds to register the next role.
If you do not specify the -f option and the command fails to register even a single role in the File for role information entries in the Item management database, the command is canceled and the remaining roles will not be registered in the Item management database.
Return values
Return value |
Meaning |
---|---|
0 |
Normal end |
1 |
Abnormal end |
Prerequisites for executing the command
-
For details about which services need to be active or inactive when this command is executed, see Status of services when commands are executed in Chapter 12. Commands.
-
Only one jssroleimport command can be executed at a time.
Remarks
-
If you cancel the jssroleimport command while it is being executed, the remaining roles will not be registered in the Item management database.
-
If you cancel the jssroleimport command by using Ctrl+C while the command is being executed, roles might not be registered in the Item management database. For this reason, do not cancel the command during execution by using Ctrl+C. If you happen to do so, wait for a while and then re-execute the command.
-
If you specify an empty File for role information entries, the command ends normally without registering any roles in the Item management database.
-
Make sure that the input file you specify is created with a character encoding that is compatible with the system locale of the machine on which JP1/Service Support is installed. The character encodings that can be used are as follows:
-
In a Japanese environment: MS932
-
In an English environment: ISO-8859-1
-
In a Chinese environment: GB18030
-
Example
The following example shows how to use the File for role information entries (c:\role\role01.csv) to register roles in the Item management database without stopping even if the file contains incorrect data.
jssroleimport -i c:\role\role01.csv -f