4.5.4 Executing a registered jobnet immediately
Immediate execution generates an execution schedule defined for the current time and runs the registered jobnet immediately. This operation is available for root jobnets registered for planned execution, and for jobnets that are registered for fixed execution and are scheduled for the next execution.
When you immediately execute a root jobnet that is scheduled for the next execution, you can choose to either leave the next execution schedule intact (Also in next schedule), or cancel it (Not in next schedule).
If the next execution schedule is kept and executed immediately, the actions differ depending on the execution registration method.
- When the root jobnet is registered for planned execution
-
The original execution schedule is immediately executed pushed ahead.
If the original execution schedule has already been changed temporarily, the temporary change information will be passed on to the accelerated execution schedule.
The temporary change information will not be passed on to the execution schedule generated at the original start time.
- When the root jobnet is registered for fixed execution
-
Leave the original execution schedule unchanged, and establish and add the new schedule that is to be executed immediately.
If the original execution schedule has already been changed temporarily, jobnet temporary change information will be replicated in the added execution schedule, but job temporary change information will not be replicated.
When you try to immediately execute a nested jobnet, if the upper-level jobnet does not have an execution schedule, the nested jobnet is not executed. The nested jobnet is not executed until the upper-level jobnet is executed.
When a root jobnet is executed immediately, whether the lower-level nested jobnets are executed depends on the method of execution specified when the root jobnet was registered, as follows:
- Immediate execution of a root jobnet registered for planned execution
-
Execution schedules are generated for the nested jobnets. Note that for nested jobnets whose execution schedules have been fixed by immediate execution, temporary change, or addition of execution schedule, the execution schedules are recalculated in the same way as Immediate execution of a root jobnet registered for fixed execution.
- Immediate execution of a root jobnet registered for fixed execution
-
Execution schedules are not generated because with the fixed execution method the schedule is preset.
If the execution date of a root jobnet changes, the scheduled start time of the nested jobnets is adjusted so that they execute within 48 hours of the base time on the day that the root jobnet is rescheduled to run.
If the execution time of a nested jobnet changes to an unexpected time, temporarily change the scheduled execution time of the nested jobnet.
If immediate execution is performed for a jobnet linked with lower-level jobnets#, the start time of each jobnet that belongs to the selected jobnet also changes accordingly.
For the execution time of a jobnet for which immediate execution was performed, you can also cancel the changes and return the jobnet to its original execution time. Furthermore, before the execution start time, if you push ahead the execution schedule of a root jobnet registered for fixed execution or immediate execution, and then add a new execution schedule, you can cancel the changes and restore the execution time of the execution schedule that you pushed ahead and added to its original execution time. However, because the execution schedule for which changes were canceled does not just disappear and return to the same execution start time that existed in the original execution schedule, two execution schedules are executed at the same execution start time. To cancel the execution schedule that you pushed ahead and added, prohibit execution for the execution schedule instead of canceling the changes.
- #
-
For JP1/AJS3 - View, this applies when the Change date and time of all lower jobnets check box is selected, and immediate execution is performed by selecting Execute Immediately from Change Plan. For a command, this applies when immediate execution is performed by executing the ajsplan command with the -i option specified.
- Cautionary note
-
An immediately executed root jobnet runs at the point in time that immediate execution is performed, even if it was defined using a 48-hour schedule. For example, if a jobnet due to start at 34:00 on August 1 is executed immediately at 8:00 on August 2, it will be executed as of 8:00 on August 2, not as of 32:00 on August 1.
The following figure shows an example of a jobnet definition. The example is used to explain operation of immediate execution performed for a jobnet registered for planned execution or fixed execution when the current time is 12:00 on August 1.
|
-
When the root jobnet is executed immediately
When the root jobnet is executed immediately, changes to the execution schedules of the lower-level nested jobnets depend on the method of execution specified when the root jobnet was registered, as follows:
-
Root jobnet registered for planned execution
The following figure shows how the time changes if the root jobnet registered for planned execution is executed immediately.
Figure 4‒34: When the root jobnet registered for planned execution is executed immediately
For root jobnet A, a schedule for execution at 12:00 on August 1 (8/1) is created. Root jobnet A is executed immediately based on this schedule.
Nested jobnet B is not executed because it has not been scheduled for execution on August 1 (8/1).
For nested jobnet C, the start day for the schedule definition is the registered day and overlaps the execution date of root jobnet A that is executed immediately. Therefore, a schedule for execution at 15:00 on August 1 (8/1) is created for nested jobnet C, and nested jobnet C is executed based on this schedule.
Nested jobnet D is not executed because it has not been scheduled for execution on August 1 (8/1).
If you want to execute nested jobnets B and D, select nested jobnets B and D, and execute them immediately before immediately executing the root jobnet.
-
-
Root jobnet registered for fixed execution
The following figure shows how the time changes if the root jobnet registered for fixed execution is executed immediately.
Figure 4‒35: When the root jobnet registered for fixed execution is executed immediately For root jobnet A, a schedule for execution at 12:00 on August 1 (8/1) is created. Root jobnet A is executed immediately based on this schedule.
For nested jobnets B and C, no execution schedule is created. However, because the time adjustment for root jobnet A is within 48 hours of the base time, execution of these nested jobnets is rescheduled for the last date and time (23:59:59 on August 2 (8/2)).
Nested jobnet D is not executed because it has not been scheduled for execution on August 1 (8/1).
If you want to execute nested jobnet D, select nested jobnet D, and execute it immediately before immediately executing the root jobnet.
-
When a root jobnet linked with lower-level jobnets is executed immediately
The following figure shows how the time changes if the root jobnet registered for planned execution or fixed execution is immediately executed with lower-level jobnets linked.
Figure 4‒36: When a root jobnet linked with lower-level jobnets is executed immediately For root jobnet A, a schedule for execution at 12:00 on August 1 (8/1) is created. Root jobnet A is executed immediately based on this schedule.
The start times of nested jobnets B and C are moved back in proportion to the time difference between the start time of root jobnet A and the current time. In the above figure, the execution time of root jobnet A changes by 46 hours. Accordingly, execution of jobnets B and C is rescheduled for 17:00 on August 1 (8/1), which is 46 hours earlier than the time they were originally scheduled.
Nested jobnet D is not executed because it has not been scheduled for execution on August 1 (8/1).
If you want to execute nested jobnet D, select nested jobnet D, and execute it immediately before immediately executing the root jobnet.
To this operation, you can use JP1/AJS3 - View, the Web GUI (Job Portal), the API function to change plan (immediate execution), or the ajsplan command. For details on using JP1/AJS3 - View, see 9.4 Immediately executing the execution schedule of a jobnet in the JP1/Automatic Job Management System 3 Operator's Guide. For details on using Web GUI (Job Portal), see 15.2.25 Execute Immediately dialog box in the JP1/Automatic Job Management System 3 Operator's Guide. For details on using the change plan (execute immediately) API, see 7.1.13 Change plan (execute immediately) API in the manual JP1/Automatic Job Management System 3 Command Reference. Alternatively, for details on the ajsplan command, see the description of ajsplan in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.