IOABLCAL Parameters

Parameters are supplied to the utility either using DD statement DABCLIN (or SYSIN) or using PARM. You can specify any number of parameter statements. The parameter statement syntax is

calendar1 operator calendar2=calendar3

where

Table 16 IOABLCAL parameters

If the operation is +, calendar3 contains all days scheduled in calendar1 and additionally all days scheduled in calendar2.

If the operation is –, calendar3 contains all days scheduled in calendar1 excluding those days scheduled in calendar2.

If the operation is *, calendar3 contains all days scheduled in calendar1 that are also scheduled in calendar2. The day has to be marked for execution in both calendars in order to be marked for execution in calendar3.

If calendar2 is a relative calendar, additional logic is required to handle the * operation mentioned above. (A relative calendar is a calendar that contains days marked + or - instead of, or in addition to, days scheduled or not scheduled.) Each day in calendar2 that contains a + or – sign is checked against the same day in calendar1. If the day is marked for execution in calendar1, it is marked for execution in calendar3. However, if the day is not marked for execution in calendar1, the result depends on how the day was marked in calendar2:

• If the day was marked + in calendar2, the closest next day marked for execution in calendar1 is marked for execution in calendar3.
• If the day was marked – in calendar2, the closest previous day marked for execution in calendar1 is marked for execution in calendar3.

Operations <W nn and >W nn create a new calendar (calendar3) by shifting the days in an old calendar (calendar1) a specified number of working days according to the specified workdays calendar (calendar2):

• Symbol < indicates that days are shifted to the left (meaning, to preceding days).
• Symbol > indicates that days are shifted to the right (meaning, to subsequent days).
• The number of working days to shift is nn.

The logic for operations <W nn and >W nn is as follows:

• Each day marked for execution in calendar1 is checked against calendar2.
  • If the same day is a working day in calendar2, nn working days in calendar2 are counted in the direction of the shift and the resulting day is marked as a working day in calendar3.
  • If the same day is not a working day in calendar2, the closest working day in the direction of the shift is identified in calendar2. From that working day, nn working days in calendar2 are counted in the direction of the shift and the resulting day is marked as a working day in calendar3.
• If operation <>W or ><W is specified, then for each working day (meaning, day marked for execution) in calendar1
  • If the same day is a working day in calendar2, it is marked as a working day in calendar3.
  • If the same day is not a working day in calendar2, the closest working day (in either direction) is marked as a working day in calendar3.
  • If two working days are equally close (meaning, the same number of days before and after), the day selected depends on the parameter specified:
    • If <>W was specified, the earlier working day is selected as the working day for calendar3.
    • If ><W was specified, the later working day is selected as the working day for calendar3.

Note: If specifying operator *,<W nn, >W nn, <>W, or ><W, calendars must be defined in year order, must contain the same years, and must not contain more than 15 years.