Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

ajsrgimport

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 a specified unit name is not found in the file, the KAVS4823-E message is output to the standard error output.

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

The JP1 user who can use this command to import a file of registered execution-schedule information for jobnets is the JP1 user who exported the file. However, a member of the Administrators group (in Windows) or a superuser (in UNIX) can import information about all units specified in the file regardless of the JP1 permission level.
If the file of registered execution-schedule information for jobnets contains information about a root jobnet that has been registered for fixed execution by multiple users, only a member of the Administrators group or a superuser can import the file. If a user who is not a member of the Administrators group or a superuser attempts to import the file, the attempt fails and the following message is output: KAVS4824-E The unit (unit-name) cannot be imported, because you are not the user who exported it.

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

[Contents][Back][Next]

[Trademarks]

0	Normal end
Multiple of 4 within the range from 4 to 124	Abnormal end