jssuserimport (imports user information)
- Organization of this page
Description
This command registers new user information in the JP1/Service Support database.
Format
jssuserimport -i user-information-entries-file-name
[-f]
Required execution permission
Administrator permissions
Storage folder
JP1/SS-path\bin\
Arguments
-i user-information-entries-file-name
Use 255 bytes or less to specify the name of a File for user 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 Files for user information entries, see File for user information entries (Optional) in Chapter 13. Definition Files.
-f
Continues processing even if some of the data in the File for user information entries is incorrect. When you specify the -f option, the command skips the piece of information about a user in the File for user information entries if the information item is improper and proceeds to register the next user information item.
If you do not specify the -f option and the command fails to register even a single user information item in the File for user information entries, the command is canceled and the remaining user information will not be registered.
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.
-
While the jssuserimport command is being executed, do not execute other JP1/Service Support commands.
Remarks
-
If you cancel the jssuserimport command while it is being executed, the remaining user information will not be registered.
-
If you cancel the jssuserimport command by using Ctrl+C while the command is being executed, the user information specified in the File for user information entries might not be registered. 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 user information entries, the command ends normally without registering any user information.
-
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 user information entries (c:\user\user01.csv) to register user information in the Item management database without stopping even if the file contains incorrect user information.
jssuserimport -i c:\user\user01.csv -f