4.5.1 Canceling registration of a jobnet
You can cancel registration of a jobnet that is registered for execution.
You can only cancel registration of a jobnet that is not running at the time. If you want to cancel registration of a jobnet that is currently running, you can either wait for the jobnet to terminate, or kill the jobnet and then cancel it.
When you cancel a jobnet registration, you can choose to cancel all generations of the jobnet, or only those generations within a certain period. With the ajsleave command, you can also cancel registration of a specific generation by specifying the registration number.
When you cancel registration of a root jobnet, all nested jobnets are also canceled. You cannot cancel registration of a nested jobnet by itself.
If you cancel the registration of all jobnets, the execution results are erased up to the previous generation.
- Special note for planning groups
-
You can specify a cancellation period for canceling the registration of jobnets in a planning group. You can then add new jobnets for execution during that period.
- Cautionary note
-
The time that it takes to cancel registration increases in proportion to the number of units (including jobnets, lower-level nested jobnets and jobs) to be canceled, and the number of logs to keep. If the number of units multiplied by the number of logs to keep is in the tens of thousands, then cancellation will take more than 30 minutes. This can place a high I/O load on the scheduler service over a prolonged period, and could affect the execution of other jobnets. In order to minimize the load on the scheduler service, we recommend that you try either of the following methods when you need to cancel a very large jobnet.
-
Specify an execution ID or execution registration number in the ajsleave command, and delete past generations one by one.
-
Avoid peak operation times.
-
- Supplementary note
-
When a large number of jobnets are registered for immediate execution, and these jobnets remain registered, system performance may be adversely affected. We recommend that you periodically cancel the registration of jobnets when they terminate if you do not need to refer to the results.
To cancel jobnet registration, you can use JP1/AJS3 - View, the Web GUI, the API function to cancel jobnet registration, or the ajsleave command. For details on using JP1/AJS3 - View, see 7.3 Releasing the jobnet from registration for execution in the JP1/Automatic Job Management System 3 Operator's Guide. For details on using Web GUI, see 16.19 Cancel Registration dialog box in the JP1/Automatic Job Management System 3 Operator's Guide. For details on the registration cancellation API, see 7.1.8 Registration cancellation API in the manual JP1/Automatic Job Management System 3 Command Reference. Alternatively, for details on the ajsleave command, see the description of ajsleave in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.