6.1.13 Settings to change the last schedulable year for jobs
You can change the last schedulable year for jobs (maximum value: 2099).
The last schedulable year for jobs differs depending on the method that was used to install JP1/AJS3 - Manager.
The following table shows the last schedulable year for jobs in each case.
No. |
Installation method |
Last schedulable year set by default |
---|---|---|
1 |
New installation of JP1/AJS3 - Manager 13-00 or later |
2043 |
2 |
Upgrade installation from JP1/AJS3 - Manager 12-60 or earlier |
2036 |
You can use the SCHEDULELIMIT environment setting parameter to change the schedulable range. This section describes the procedures for extending and for reducing the range.
- Cautionary notes:
-
-
We recommend that you do not reduce the schedulable range because this requires a complex procedure.
-
In a cluster environment, set the same value for the SCHEDULELIMIT environment setting parameter on the active and standby servers.
-
- Organization of this subsection
(1) Procedure for extending the schedulable range
-
Terminate all JP1/AJS3 - View instances that are connected to the JP1/AJS3 - Manager for which you want to change the schedulable range.
You can check whether there are JP1/AJS3 - View instances connected to the JP1/AJS3 - Manager instance for which you want to change the schedulable range. To do this, execute the ajsstatus -v command on the target JP1/AJS3 - Manager host.
-
Stop the ajsinetd and ajscdinetd processes.
Execute the following commands to stop the ajsinetd and ajscdinetd processes of the JP1/AJS3 - Manager instance for which you want to change the schedulable range:
jajs_hstd_stop -n ajsinetd jajs_hstd_stop -n ajscdinetd
-
Stop the scheduler service.
Stop the scheduler service for which you want to change the schedulable range.
-
Execute the following command to set the environment setting parameter described in (3) below:
jajs_config -k definition-key "parameter-name"=value
-
Start the scheduler service.
Start the scheduler service for which you changed the schedulable range.
-
Start the ajsinetd and ajscdinetd processes.
Execute the following commands to start the ajsinetd and ajscdinetd processes of the JP1/AJS3 - Manager instance for which you changed the schedulable range:
jajs_hstd -n ajsinetd jajs_hstd -n ajscdinetd
(2) Procedure for reducing the schedulable range
(a) Tasks required before changing the environment setting parameter
-
Modify the JP1/AJS3 definitions.
If you reduce the schedulable range, information about times beyond the new range might be included in the following definitions. If such information is included, you must modify the definitions.
-
Calendar definition
-
Unit definition
-
-
Obtain the JP1/AJS3 definition information.
Obtain the following types of definition information:
-
Calendar definition
-
Unit definition
-
Release information#
-
Temporary change information#
- #
-
Obtain this information only if the relevant functions are used.
-
-
Cancel execution registration of root jobnets.
If there are root jobnets that are scheduled to run at a time beyond the new schedulable range, cancel execution registration of the root jobnets.
You can search for such root jobnets by using the following command:
ajsshow -i "%JJ %Pt" -b day-next-to-last-day-of-new-extent-to-which-jobs-can-be-scheduled -e current-extent-to-which-jobs-can-be-scheduled -T -R /*
-
Back up the registered execution-schedule information for jobnets.
(b) Changing the environment setting parameter
-
Terminate all JP1/AJS3 - View instances that are connected to the JP1/AJS3 - Manager for which you want to change the schedulable range.
You can check whether there are JP1/AJS3 - View instances connected to the JP1/AJS3 - Manager instance for which you want to change the schedulable range. To do this, execute the ajsstatus -v command on the target JP1/AJS3 - Manager host.
-
Stop the ajsinetd and ajscdinetd processes.
Execute the following commands to stop the ajsinetd and ajscdinetd processes of the JP1/AJS3 - Manager instance for which you want to change the schedulable range:
jajs_hstd_stop -n ajsinetd jajs_hstd_stop -n ajscdinetd
-
Stop the scheduler service.
Stop the scheduler service for which you want to change the schedulable range.
-
Execute the following command to set the environment setting parameter described in (3) below:
jajs_config -k definition-key "parameter-name"=value
-
Start the scheduler service.
Cold-start the scheduler service for which you changed the schedulable range.
-
Start the ajsinetd and ajscdinetd processes.
Execute the following commands to start the ajsinetd and ajscdinetd processes of the JP1/AJS3 - Manager instance for which you changed the schedulable range:
jajs_hstd -n ajsinetd jajs_hstd -n ajscdinetd
(c) Tasks required after changing the environment setting parameter
-
Overwrite the unit definition.
Use the following command to overwrite the unit definition by using the definition information that you obtained in (a) Tasks required before changing the environment setting parameter:
ajsdefine -F scheduler-service-name -f file-name
Before executing the command, confirm that yes is set for the UNITDEFDIVIDEUPDATE environment setting parameter. If no is set, overwriting a large unit definition might result in insufficient memory area for controlling locks. In such a case, divide the data and register it as multiple definitions.
-
Register the calendar definition.
Use the following command to register the calendar definition by using the definition information that you obtained in (a) Tasks required before changing the environment setting parameter:
ajscalendar -c -df file-name
-
Register the release information.
Reregister the release information by using the definition information that you obtained in (a) Tasks required before changing the environment setting parameter.
-
Import registered execution-schedule information.
Import registered execution-schedule information from the registered execution-schedule information that you backed up in (a) Tasks required before changing the environment setting parameter.
-
Reregister the root jobnets for execution.
Reregister execution of the root jobnets that you unregistered in step 3 in (a) Tasks required before changing the environment setting parameter. If there were root jobnets that were registered for immediate execution, also reregister them for immediate execution.
-
Temporarily change the execution registration.
Use a temporary change history to reperform a temporary change.
For root jobnets that were registered for fixed execution, the temporary change information will have been restored by importing the registered execution-schedule information. Therefore, perform this operation for only the jobnets that were registered for planned execution and for immediate execution.
(3) Environment setting parameter
Definition key |
Environment setting parameter |
Explanation |
---|---|---|
[{JP1_DEFAULT|logical-host}\JP1AJSMANAGER\scheduler-service]# |
"SCHEDULELIMIT"= |
Last year of the extent to which jobs can be scheduled |
- #:
-
The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.
For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT.