6.1.13 Settings to change the last schedulable year for jobs

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.

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

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.