CAL Display monthly calendar

CAL [mm. [yyyy] ] Calendar. The screen displays the calendar for the specified month. An "x" is displayed for each day with one event scheduled, a "xx" is displayed for each day with more than one event scheduled. If weekly, monthly or yearly events are scheduled, a "w", a "m" or a "y" is displayed. Within the current month the current day is displayed blinking.

mm. 1 <= mm <= 12: one- or two-digit specification for the month. Please note, that the month must have a period at the end.

yyyy 1500 <= yyyy <= 2300: Year specification. The year may be also specified as a two-digit number yy . The following rule applies: yy >= 80: 19yy, yy < 80: 20yy.

Defaults: If month and year are not specified (command CAL without parameter), the current month of the current year is displayed. If only the year is not specified (CAL mm. ) the specified month of the current year is displayed.

The monthly calendar is displayed on the screen in the following form:

x/xx: one/more than one event exists for the day marked.

w/m/y: weekly/monthly/yearly periodic event

Events with a 'executed'-mark set (see page 14-) are not displayed in the calendar.

Underlined day = public holiday.

Possible input into the command field of the calendar

+ | - position one month forwards/backwards.

Sending an empty command field has the same effect as +.

CAL/II/MI/SI/SIL/SIS

 Commands of the event scheduling system: Calendar/Insert Item/ Modify Item/Show Item/Show Item List/Show Item Short.

For an explicit description see below.

HC | NHC Switch hardcopy on/off.

/cmd any BS2000-command.

=arith arithmetic expression or hexadecimal <--> character conversion.

For an explicit description see page 7-.

K1 Return from the calendar to the previous CFS-screen.

F3 Record the current calendar display into the CFS hardcopy file.

Example:

A calendar display for May 1990 is achieved by the following command CAL 5.1990 or CAL 5.90

Note:

Because the monthly calendar also displays existing events, it is necessary to access the item file of the event scheduling system when processing the CAL command. The name of the item file used is evaluated according to certain rules, as described for command IFILE below.

Holidays are underlined in the monthly calendar. The user can define additional holidays, or cancel holidays pre-defined by CFS. The definition of these holidays is done in the so-called IFREE (Item Free) file.

The CFS.IFREE [.logon-name|.account] (Fcbtype=SAM) file should be created in the userid of each user. The file can also be allocated with a /FILE file,LINK=IFREE command. A central CFS.IFREE file under the CFS userid can be created in addition to each users own IFREE file. In this case, the data from both files will be merged.

The records contained in the holiday files should conform to the following format: ddmm (dd = Day, mm = Month).

Records with the format ddmm- are also allowed. This designates that day as not being a holiday.