jssaclimport (imports access-permission information)
- Organization of this page
Description
This command sets access-permission information and information about the initial person in charge of status in JP1/Service Support. You can also use a CSV file output by the jssaclexport command to set access-permission information and information about the initial person in charge of status.
The jssaclimport command first checks whether the contents of the access privileges input file are all correct. Then it processes and sets the access-permission information and information about the initial person in charge of status starts. If there is invalid data in the access privileges input file, access-permission information and information about the initial person in charge of status are not set.
Format
jssaclimport -i access-privileges-input-file-name
[-q]
Required execution permission
Administrator permissions
Storage folder
JP1/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 and information about the initial person in charge of status are 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 13. 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 and information about the initial person in charge of status. |
|
2 |
Operating |
In process |
The command sets access-permission information and information about the initial person in charge of status 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 and information about the initial person in charge of status. |
- Legend:
-
--: Not applicable.
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 12. 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.
-
When you use the jssaclimport command to register large quantities of access-permission information, processing can take a long time and place a great load on the Item management server and JP1/Service Support. We recommend that you execute the jssaclimport command when the load on the Item management server and JP1/Service Support is low, for example, at midnight.
-
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 set the access-permission information file (c:\accesspermission\accesspermissioninfo.csv) without displaying a confirmation message:
jssaclimport -i c:\accesspermission\accesspermissioninfo.csv -q