ajslocaldate

Format

ajslocaldate
     [-F service-name]
     [-y]
     {[-d[[year/]month/]day][-t hours[:minutes]]|[-s seconds]|[-u]}

To Page Top

Description

Modifies the local date and time for a JP1/AJS3 scheduler service (date and time managed by JP1/AJS3).

If you execute this command, without specifying any arguments, the system outputs the local date and time for the JP1/AJS3 scheduler service to the standard output file.

To Page Top

Execution privileges

In Windows: Administrators privileges

In UNIX: Superuser privileges

To Page Top

Arguments

To Page Top

Notes

• To change the scheduler service local time, stop the scheduler service before executing this command. The new local time is applied to the system the next time the scheduler service is started. If you execute this command while the scheduler service is being started, schedule calculation results, display times, and other items might become incorrect.

• If you have set the scheduler service local date and time to a value in the past, you must use cold start to start a scheduler service. (If you modify the scheduler service local date and time, you cannot restore the information recorded in the schedule monitor information file, such as the job end time, preventing the jobnet from running as scheduled.)

  You can use the ajsstart command (with the -c option specified) to perform cold start for a scheduler service.

• The system generates local time based on the system time. If you modify the system time, make sure that the modification is correctly reflected in the local time.

• To use the local time in a cluster system, execute the ajslocaldate command so that both the active and standby machines operate at the same local time.

• If you need to change the local time when a jobnet with start condition is registered for execution, specify an option other than -c (-s, -n, -j, or -k) in the ajsstop command, stop the scheduler service, and then execute the ajslocaldate command. If you specify -c in the ajsstop command to stop the scheduler service, monitoring is not canceled at a time specified within the valid range of the start condition.

• Before changing the scheduler service local time to a time in the past by using this command, you need to check whether there are any jobnets for which a release entry has been made. If there are such jobnets, including jobnets for which a release entry was made in past results, use the ajsdelete command to delete the relevant jobnet before changing the time.

  If you change the time to a time in the past without deleting the jobnet, a problem might occur during operation. If this happens, restore the time that was set before you made the change, delete the relevant jobnet, and then change the time again.

  To restore the jobnet you deleted, you must back up the definition information of the jobnet that will be subject to release by using the ajsprint command before registering the release entry of the jobnet. Use the ajsdefine command to re-define the definition information of the jobnet you have backed up, and then specify the release source to register the release entry again. In this way, the jobnet subject to release can be restored.

To Page Top

Return values

0	Normal end
Multiple of 4 within the range from 4 to 124	Abnormal end

To Page Top

Additional information

• The following table shows an example of the display format for the local date and time for a scheduler service:

  Table 4‒1: Example of the display format for the local date and time for a scheduler service

  Language type	Display format
  Japanese	20XX/12/01 12:00:00
  English	Dec 01 20XX 12:00:00

• If there is a change in the local date and time for the scheduler service, the KAVS0210-I message is output to Windows event log or syslog.

To Page Top