ajscalendar

Format

ajscalendar
     [-F service-name]
     [-lt {hour:minute|none|no}]
     [-ld {day|none|no|{sun|su|mon|mo|tue|
          tu|wed|we|thu|th|fri|fr|sat|sa}:n}]
     [-md {this|th|next|ne|none|no}]
     [-c]
     [-op {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|
          {year/month/{day|
          {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa}[:n]}}}]
     [-cl {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|
          {year/month/{day|
          {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa}[:n]}}}]
     [-no {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|{year/month/{day|
          {sun|su|mon|mo|tue|
          tu|wed|we|thu|th|fri|fr|sat|sa}
          [:n]}}}]
     [-of open-day-information-file-name]
     [-cf closed-day-information-file-name]
     [-nf canceled-day-information-file-name]
     [-df calendar-information-file-name]
     [-d year/month/day]
     [-R]
     job-group-name...

To Page Top

Description

Defines calendar information for a job group.

To Page Top

Execution privileges

You must have any of the following JP1 privileges:

• JP1_AJS_Admin privilege

• JP1_AJS_Manager privilege

• JP1_AJS_Editor privilege

To Page Top

Arguments

To Page Top

Notes

• Either of the following users can define calendar information:

  • A user granted the update privilege when a job group was defined or when its attributes were changed. If the job group has higher job groups, the user must have the reference privilege for all of the groups.

  • A JP1 user mapped to the OS user who has Administrators or superuser privileges

    Note, however, that if yes is set after changing the ADMACLIMIT environment setting parameter from its default, even a JP1 user who was mapped to an OS user who has Administrators or superuser privileges must have the reference privilege and the update privilege.

• If an open day information file, closed day information file, canceled day information file, or calendar definition file contains calendar information which does not conform to the specified format, the ajscalendar command ignores that information and continues processing. Make sure that a line feed is specified at the end of the information file. If there is no line feed, the last line will be treated as external format information and ignored. In addition, the calendar information specified on the last line will not be defined even if the ajscalendar command has been successfully executed.

• If you simultaneously specify an open day information file, closed day information file, canceled day information file, and calendar definition file, any error encountered during the processing of one of the files causes the ajscalendar command to stop processing for the erroneous file and continue processing for other files.

  Note that the ajscalendar command defines only the calendar information in successfully processed files, and then abnormally terminates.

• If nothing is defined in the open day information file, closed day information file, canceled day information file, or calendar definition file, the system does not modify the corresponding calendar information.

• If you modify the calendar information for a job group simultaneously with ajscalendar command and the Edit Monthly Calendar or Edit Annual Calendar window of JP1/AJS3 - View, the results will be unpredictable.

• Always separate an option and its value by at least one space character.

• For ajscalendar command, you cannot specify more than one option.

  Correct use: ajscalendar -c -F AJSROOT1 /GROUP

  Incorrect use: ajscalendar -cF AJSROOT1 /GROUP

• If the open day information file, closed day information file, canceled day information file, or calendar definition file contains no valid calendar information, and if no valid calendar definition option is specified, ajscalendar command ends abnormally.

• If any invalid calendar definition option is specified, the command ends abnormally.

• Make sure that the ajscalendar command is executed when the amount of processing is small. Execution of the command might affect operation because execution of root jobnets registered in the same scheduler service as the job group for which calendar information is defined is suppressed. However, a jobnet with start conditions placed in Now monitoring status before the definition is changed is executed when the start conditions are satisfied during execution of the ajscalendar command.

• If calendar information for the current day is changed from closed day to open day, the schedule is recalculated. As a result, the current day's execution schedule might be created for a jobnet registered for planned execution, and then jobs might be executed according to this execution schedule.

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 schedule is recalculated if the following conditions are satisfied:

  • A scheduler service of the specified job group is running.

  • This command has terminated normally.

• The following shows the formats of a standard-week value and open, closed, and canceled days, which are calendar information stored in open day information, closed day information, and canceled day information files. The three types of information files use the same format. Make sure that a line feed is specified at the end of the information file. If there is no line feed, the last line will be treated as external format information and ignored. In addition, the calendar information specified on the last line will not be defined even if the ajscalendar command has been successfully executed.

  Format of standard-week values:

  sun|su: Specifies Sunday.

  mon|mo: Specifies Monday.

  tue|tu: Specifies Tuesday.

  wed|we: Specifies Wednesday.

  thu|th: Specifies Thursday.

  fri|fr: Specifies Friday.

  sat|sa: Specifies Saturday.

  Format of open, closed, and canceled days:

  YYYY/MM/{DD{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}[:n]}

  • YYYY

    You can specify a value between 1994 and the value of the SCHEDULELIMIT environment setting parameter for the year. For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.

  • MM

    You can specify value between 1 and 12 for the month.

  • DD

    You can specify a value between 1 and 31 for the day.

  • n

    Specify the week for the day; a value between 1 and 5 (specifying 1 for Sunday, for example, indicates the first Sunday of the month).

    If you specify 5 for a month which does not have the fifth week, the system invalidates the calendar information.

• Calendar information options (-op, -cl, and -no) specified later take precedence over those specified earlier (for example, if you specify -op mon -cl mon -no mon, the system places a higher priority on -no mon, thus handling Monday as a canceled day).

• If you specify a standard-week value and open, closed, and canceled days simultaneously, the open, closed, and canceled days take precedence (for example, if you specify -op 2010/10/25 -cl sun, the system places a higher priority on -op 2010/10/25, thus handling October 25, 2010 as an open day).

• If you specify the day of the week for an open, closed, or canceled day, the day is converted to the corresponding date and then stored as calendar information.

• If you do not set calendar information for a job group, JP1/AJS3 references the calendar information of the upper-level job group or the scheduler service. If calendar information is not set for the upper-level job group and the scheduler service, open days are assumed.

To Page Top

Example 1

The following command deletes the calendar information for job group /Sales, and then sets the closed days for October 2010 (Saturdays and Sundays). This example assumes that the closed days are defined in the closed day information file (/tmp/calendar).

ajscalendar -c -cf /tmp/calendar /Sales

Contents of the closed day information file (/tmp/calendar)

2010/10/sat
2010/10/sun

To Page Top

Example 2

The following command sets the calendar information for job group /Sales. (Saturdays and Sundays are set to closed days according to the standard-week values. In October 2010, however, Saturdays are assumed to be open days.)

ajscalendar -cl su -cl sa -op 2010/10/sa /Sales

To Page Top