ajslocaldate
- Organization of this page
Format
ajslocaldate [-F service-name] [-y] {[-d[[year/]month/]day][-t hours[:minutes]]|[-s seconds]|[-u]}
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.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Arguments
-F service-name
Specify the name of the target scheduler service.
You can specify a character string of 1 to 30 bytes.
If you omit this option, the system assumes the default scheduler service name.
-y
Does not display a message with a confirmation prompt before modifying the scheduler service local date and time.
-d [[year/]month/]day
Specify the scheduler service local date.
-
year
You can specify a value between 1997 and 2036.
-
month
You can specify a value between 1 and 12.
-
day
You can specify a value between 1 and 31.
-t hours[:minutes]
Specify the local time for a scheduler service.
-
hours
You can specify a value between 0 and 23.
-
minutes
You can specify a value between 0 and 59.
-s seconds
Specify the difference between the local time for the current scheduler service and the time set in the host.
You can specify a value between -2,147,483,647 and 2,147,483,647 (seconds).
-u
Reset the local date and time for the scheduler service to the initial value (the date and time set in the host).
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.
Return values
0 |
Normal end |
Multiple of 4 within the range from 4 to 124 |
Abnormal end |
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.