Job Management Partner 1/Automatic Job Management System 3 Command Reference 2

ajslocaldate

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.
• If you want to move the scheduler service local time to a time in the past, beforehand, check whether jobnets for which release entry is made exist. If such jobnets exist, only jobnet definitions in Release wait status remain after the time is changed. This might prevent JP1/AJS3 from operating correctly. If there are jobnets for which release entry is made, use the ajsdelete command to delete them before changing the scheduler service local time. After the scheduler service local time has been changed, use the ajsrelease command to make release entry again.

Return values

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

Additional informations

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

  Table 3-3 Example of the display format for the local date and time for a scheduler service

  Language type	Display format
  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.

[Contents][Back][Next]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.