Defining Calendars

A calendar definition is a collection of parameters, in calendar form, that is used to indicate on what dates of the year scheduling should occur.

Calendars can be very useful for providing basic scheduling criteria, especially when

scheduling dates do not follow a pattern, or follow a pattern that is not easily specified using regular basic scheduling criteria
An example might be a WORKDAYS calendar that schedules jobs on all weekdays, Monday through Friday, that are not holidays. Creating this schedule using basic scheduling parameters would be problematic. Defining the weekdays is simple enough, but excluding the holidays will be a problem.
identical detailed and complex scheduling criteria are used for many jobs
Instead of detailing the scheduling criteria in the job scheduling definition of each job, the scheduling criteria can be specified once in a calendar, and then only the calendar name need be specified in each the job scheduling definition. An example might be a HOLIDAYS calendar that consists of a number of disparate dates. Specifying this once in a calendar is easier and less error-prone than specifying the same set of dates in many job scheduling definitions.

You can now define a calendar for use in your job scheduling definition.

Enter =8 in the COMMAND field. The IOA Calendar Definition Facility entry panel is displayed.
In the LIBRARY field is the name of the default calendar library at your site. For purposes of illustration, you will call this library IOA.TEST.CAL.

Figure 51 IOA Calendar Definition Facility - Entry Panel

--------------------- IOA CALENDAR FACILITY - ENTRY PANEL ------------------(8)

COMMAND ===>







SPECIFY LIBRARY, CALENDAR, YEAR



   LIBRARY  ===> IOA.TEST.CAL

   CALENDAR ===>                 (Blank for calendar selection list)

   YEAR     ===>                 (Blank for year selection list)



























USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                           11.28.41
In the CALENDAR field, enter the name IDCAL1 and press Enter.
SPECIFY LIBRARY, CALENDAR, YEAR



   LIBRARY  ===> IOA.TEST.CAL

   CALENDAR ===> IDCAL1          (Blank for calendar selection list)

   YEAR     ===>                 (Blank for year selection list)



The Calendar Definition screen is displayed for the current year, as indicated by the label under the COMMAND field.

Figure 52 IOA Calendar Definition Screen

--------------------------- IOA CALENDAR - IDCAL1   ----------------------(8.Y)

COMMAND ===>                                                    SCROLL===> CRSR

YEAR 2001  -



-----S-------------S-------------S-------------S-------------S-------------S---

       1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1

01

-----S-------------S-------------S-------------S-------------S-------------S---

             1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8

02

-----S-------------S-------------S-------------S-------------S-------------S---

             1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1

03

-----S-------------S-------------S-------------S-------------S-------------S---

     1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +

04

-----S-------------S-------------S-------------S-------------S-------------S---

         1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1

05

-----S-------------S-------------S-------------S-------------S-------------S---

               1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +

06

-----S-------------S-------------S-------------S-------------S-------------S---

TYPE  Y  IN ALL THE EXECUTION DAYS                                     11.35.33
Tab to the field next to the year label, and specify GETTING STARTED. The following screen is displayed:
--------------------------- IOA CALENDAR - IDCAL1   ----------------------(8.Y)

COMMAND ===>                                                    SCROLL===> CRSR

YEAR 2001  -  GETTING STARTED



Notice the layout of the screen:

It is sectioned according to months. Only the first six months are displayed. You can page down to display the next six months.
Each section contains three lines:
- A number line contains up to 31 digits indicating the dates in the month. A plus sign indicates the 10th, 20th and 30th.
- Directly below the number line is a blank line used for entering a Y value for each date on which scheduling should occur.
- Directly above the number line is a line containing Ss. Each S indicates either Saturday or Sunday, depending on the defaults defined at your site.
Normally, you would try to create a logical, useful calendar. However, to keep the definition as simple as possible, you will specify Y only for the date on which you are performing these exercises.

Specify Y in the field that represents the current working date. The Calendar definition should have only one entry:
--------------------------- IOA CALENDAR - IDCAL1   ----------------------(8.Y)

COMMAND ===>                                                    SCROLL===> CRSR

YEAR 2001  -  GETTING STARTED



-----S-------------S-------------S-------------S-------------S-------------S---

       1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1

01

-----S-------------S-------------S-------------S-------------S-------------S---

             1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8

02

-----S-------------S-------------S-------------S-------------S-------------S---

             1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1

03

-----S-------------S-------------S-------------S-------------S-------------S---

     1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +

04

-----S-------------S-------------S-------------S-------------S-------------S---

         1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1

05           Y

-----S-------------S-------------S-------------S-------------S-------------S---

               1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +

06

-----S-------------S-------------S-------------S-------------S-------------S---

TYPE  Y  IN ALL THE EXECUTION DAYS                                     11.35.33
Exit the Calendar Definition screen. The Year List screen is displayed, listing only the definition you just created.
Figure 53 Year List Screen

LIST OF YEARS IN IOA.TEST.CAL                                 CALENDAR IDCAL1

COMMAND ===>                                                    SCROLL===> CRSR

OPT  YEAR ----------------- DESCRIPTION ---------------------------------------

     2001       GETTING STARTED

======= >>>>>>>>>>>>>>>>  NO MORE YEARS IN CALENDAR     <<<<<<<<<<<<<<<< ======



































OPTIONS:  S SELECT   D DELETE   I INSERT   W INSERT BY WEEK DAYS C COPY12.02.36

Exit the Year List screen. The Exit Option window is displayed. Type Y in the CREATE field and press Enter to save this newly created calendar. You can now use this calendar in your job scheduling definition.
From the IOA Calendar Facility – Entry Panel, type =2 in the COMMAND field and press Enter to enter the Scheduling Definition facility.
Edit the job scheduling definition of IDJOB10. In the DCAL field, type IDCAL1 and press Enter, and exit the job scheduling definition.
Order IDJOB10. The job is scheduled, and executed, because the basic scheduling criteria defined in calendar IDCAL1 were satisfied.
Although you specified only a calendar name in this exercise, calendars can be used in conjunction with other basic scheduling parameters.

The relationship between DAYS values and the DCAL calendar depends on the format of values specified for DAYS parameter. The same holds true of the relationship between WDAYS values and the WCAL calendar. For details, refer to the description of parameters DAYS and WDAYS in the parameters chapter of the Control-M for z/OS User Guide.

Parent Topic

Additional Features