jssaclimport (imports access-permission information)
- Organization of this page
Description
This command sets access-permission information in JP1/IM - Service Support. You can also use a CSV file output by the jssaclexport command to set access-permission information.
Executing the jssaclimport command checks whether the contents of the access privileges input file are all correct, and then the processing for setting access-permission information starts. If there is invalid data in the access privileges input file, access-permission information is not set.
Format
jssaclimport -i access-privileges-input-file-name [-q]
Required execution permission
Administrator permissions
Storage folder
IM-SS-path\bin\
Arguments
-i access-privileges-input-file-name
Use 255 bytes or less to specify the characters for access-privileges-input-file-name (name of the CSV file in which access-permission information is input). Count half-width characters as 1-byte each and full-width characters as 2-bytes each. 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 is 255 bytes or less after it is converted to an absolute path. Note that you cannot specify a character string that begins with a hyphen (-) for the file name. For details about the access privileges input file, see Access privileges input file (Optional) in Chapter 12. Definition Files.
-q
Continues setting access-permission information without displaying a confirmation message.
Return values
Return value |
Meaning |
---|---|
0 |
Normal end |
1 |
Abnormal end |
Differences in the result of the command depending on the statuses of the system and process work board
The jssaclimport command acts differently depending on the statuses of the system and process work board. The following table describes the differences in the result of the jssaclimport command depending on the statuses of the system and process work board.
No. |
Status of the system |
Status of the process work board |
Result |
---|---|---|---|
1 |
Waiting to be deleted |
-- |
The command cannot set access-permission information. |
2 |
Operating |
In process |
The command sets access-permission information based on the access privileges input file specified with the -i option. |
3 |
Operating |
||
4 |
Under suspension |
||
5 |
Waiting to be deleted |
The command cannot set access-permission information. |
Prerequisites for executing the command
-
For details about the status of services when commands are executed, see Status of services when commands are executed in Chapter 11. Commands.
Remarks
-
If you cancel the jssaclimport command by using Ctrl+C while the command is being executed, access-permission information might not be output. For this reason, do not use Ctrl+C to cancel the command during execution. If you happen to do so, wait for a while, and then re-execute the command.
-
Do not change or delete a process work board, role, or user while the jssaclimport command is being executed. If any of them is changed or deleted, execution of the jssaclimport command might fail. Even if execution of the jssaclimport command successfully finishes, the contents of the access privileges input file might not be correctly applied.
-
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/IM - 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 set the access-permission information file (c:\accesspermission\accesspermissioninfo.csv) without displaying a confirmation message:
jssaclimport -i c:\accesspermission\accesspermissioninfo.csv -q