ajsrgimport
- Organization of this page
Format
ajsrgimport [-F service-name] [-f] [-u unit-name] [-o unit-name] -i file-of-registered-execution-schedule-information-for-jobnet-name
Description
The ajsrgimport command imports jobnet registered execution-schedule information, and registers root jobnets for execution based on the imported information.
Execution privileges
You must have any of the following JP1 privileges:
-
JP1_AJS_Admin privilege
-
JP1_AJS_Manager privilege
-
JP1_AJS_Operator privilege
Arguments
-F service-name
Specify the name of the target scheduler service.
You can specify a character string of 1 to 30 bytes. If you omit this option, the system assumes the default scheduler service name.
-f
Specify this option if you do not want to execute jobnets that have been scheduled for execution on the current day and the execution time has already passed. This option is valid for all jobnets specified in the file of registered execution-schedule information for jobnets regardless of whether the type of execution registration is planned execution or fixed execution.
-u unit-name
Specify the unit name of a root jobnet or job group you want to import. You can use a maximum of 930 bytes to specify the unit name. Note that you cannot use wildcard characters. Also, you cannot specify a scheduler service name, host name, or execution ID.
You can specify multiple -u options in the -u unit-name -u unit-name ... format.
If root jobnets that have the same name as the specified unit names are found in the registered execution-schedule information file, these root jobnets are registered for execution. Similarly, if root jobnets belonging to job groups that have the same name as the specified unit names are found in the registered execution-schedule information file, these root jobnets are registered for execution.
If you specify neither the -o option nor this option, registered execution-schedule information about all units specified in the file of registered execution-schedule information for jobnets specified in the -i option is imported.
You cannot specify the -u option together with the -o option.
-o unit-name
Specify the unit name of a root jobnet or job group you do not want to import. You can use a maximum of 930 bytes to specify the unit name. Note that you cannot use wildcard characters. Also, you cannot specify a scheduler service name, host name, or execution ID.
You can specify multiple -o options in the -o unit-name -o unit-name ... format.
If root jobnets that have the same name as the specified unit names are found in the registered execution-schedule information file, the other root jobnets are registered for execution. Similarly, if root jobnets belonging to job groups that have the same name as the specified unit names are found in the registered execution-schedule information file, the other root jobnets are registered for execution. If a specified unit name is not found in the file, this option is ignored.
If you specify neither the -u option nor this option, registered execution-schedule information about all units specified in the file of registered execution-schedule information for jobnets specified in the -i option is imported.
You cannot specify the -o option together with the -u option.
-i file-of-registered-execution-schedule-information-for-jobnet-name
Specify the name of the file to which registered execution-schedule information has been exported.
You can specify a character string of 1 to 255 bytes. If the length of the specified file name exceeds 255 bytes, the following message is output: KAVS4829-E Specified file name (file-name) is too long.
Return values
0 |
Normal end |
Multiple of 4 within the range from 4 to 124 |
Abnormal end |
Notes
-
Either of the following users can execute this command:
-
A user who is the same JP1 user as the export JP1 user and who has the operation privilege for the units that are in the root jobnet to be imported and that are coded in the registered execution-schedule information file
-
A JP1 user mapped to the OS user who has Administrators or superuser privileges
Note, however, that if yes is set after changing the ADMACLIMIT environment setting parameter from its default, even a JP1 user who was mapped to an OS user who has Administrators or superuser privileges must have the operation privilege.
-
-
When fixed execution of the root jobnet is performed by multiple users, only the JP1 user who is mapped to an OS user with Administrators or superuser privileges can execute this command. Note, however, that if yes is set after changing the ADMACLIMIT environment setting parameter from its default, even a JP1 user who was mapped to an OS user who has Administrators or superuser privileges must have the operation privilege.
If a JP1 user who cannot execute the ajsrgimport command performs import, the KAVS4824-E message appears, and registered execution-schedule information cannot be imported.
-
You can import registered execution-schedule information about only root jobnets registered for planned or fixed execution.
-
You cannot execute this command remotely.
-
Do not export and import registered execution-schedule information between systems that use different time zones. Before you execute the ajsrgexport or ajsrgimport commands, make sure that the time zone settings on the systems on which you execute these commands are the same.
Example 1
The following command imports all contents of the file of registered execution-schedule information for jobnets.
ajsrgimport -F AJSROOT1 -i unitreg.txt
Example 2
The following command imports information about a specific unit (/GROUPA/JOBNETA) specified in the file of registered execution-schedule information for jobnets.
ajsrgimport -F AJSROOT1 -i unitreg.txt -u /GROUPA/JOBNETA