ajsrgexport
- Organization of this page
Format
ajsrgexport [-F service-name] [-R] [-e {s|f}] [-o file-of-registered-execution-schedule-information-for-jobnet-name] [-m] unit-name...
Description
The ajsrgexport command exports registered execution-schedule information about the root jobnet registration for execution.
Execution privileges
You must have any of the following JP1 privileges:
-
JP1_AJS_Admin privilege
-
JP1_AJS_Manager privilege
-
JP1_AJS_Editor privilege
-
JP1_AJS_Operator privilege
-
JP1_AJS_Guest 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.
-R
If this option is specified, all root jobnets included in the specified units, in addition to the specified units themselves, are subject to exporting.
-e {s|f}
Specify the execution registration type or types of jobnets for which you want to export registered execution-schedule information.
-
s
The command exports registered execution-schedule information about root jobnets that have been registered for planned execution.
-
f
The command exports registered execution-schedule information about root jobnets that have been registered for fixed execution.
If you want to export registered execution-schedule information about root jobnets that have been registered for planned execution and also root jobnets that have been registered for fixed execution, specify -e sf.
If you omit this option, the command exports information about root jobnets that have been registered for planned execution and also root jobnets that have been registered for fixed execution.
If no root jobnets have been registered for the specified type of execution or if the specified root jobnets will no longer be executed, a message to that effect is output.
You can suppress this message output by specifying the -m option.
-m
Specify this option if you do not want a message to be output.
-o file-of-registered-execution-schedule-information-for-jobnet-name
Specify the name of the file to which registered execution-schedule information will be exported.
You can specify a character string of 1 to 255 bytes. If the length of the specified file name exceeds 255 bytes, an error message is output. If this option is omitted, the registered execution-schedule information is output to the standard output file. If the name of an existing file is specified, the existing file is overwritten.
Please do not modify this file. If a modified file is imported, the system might be unable to operate correctly.
unit-name...
Specify the names of root jobnets or job groups to be exported. The maximum total length of the names is 930 bytes.
Note that you can specify scheduler service names but cannot specify host names and execution IDs.
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 has the reference privilege for the unit to be exported
-
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 with Administrators or superuser privileges must have the reference privilege.
-
-
This command can export registered execution-schedule information about only root jobnets that have been registered for planned or fixed execution.
-
This command cannot be executed remotely.
-
If there is no information to be exported, the command outputs the following message: KAVS4837-I There is no information to be exported.
-
Do not export or 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.
-
If the target root jobnet is or contains a release target jobnet (a root jobnet for which release entry is made), and has been registered for fixed execution, the data to be exported changes on the release date. On and after the release date, the new jobnet definition (the definition of the release-source jobnet) is exported.
-
For details about how to back up and recover the execution registration status, see 3.4 Backing up and recovering the execution registration status of jobnets by using the ajsrgexport and ajsrgimport commands in the JP1/Automatic Job Management System 3 Administration Guide.
Example 1
The following command exports registered execution-schedule information about the root jobnets in job group /GROUPA.
ajsrgexport -F AJSROOT1 -o /tmp/unitreg.txt /GROUPA/*
Example 2
The following command exports registered execution-schedule information about root jobnet /GROUPA/JOBNETA only.
ajsrgexport -F AJSROOT1 -o /tmp/unitreg_net.txt /GROUPA/JOBNETA
Example 3
The following command exports registered execution-schedule information about the root jobnets in job group /GROUPA.
ajsrgexport -F AJSROOT1 -R -o /tmp/unitreg_net.txt /GROUPA