|
The CFS Event scheduling system is controlled via commands and offers the following facilities:
1) Formatted display of a monthly calendar within the period of January 1500 to December 2300. Events are marked.
2) Specification of events with date, time, short description, and full description. You may define up to 250 periodic events. Periodicity may be defined as yearly, monthly or weekly.
3) Updating of texts for existing events.
4) Display of all information for an event.
5) Display of a list of events for a specified date or beginning with a specified date. The list contains the date, time, 'executed'-mark, and short description .
6) Short Display of information in the system line about the days for which events are scheduled.
In the following we speak of an event as an "item". We say, an event (item) is executed, if it was marked as ok by the user.
The functions 1) to 6) correspond to the following commands:
CAL Show Calendar (by month)
II Insert Item (enter event)
MI Modify Item (update event text)
SI Show Item (display all information of an event)
SIL Show Item List (Event list)
SIS Short information about days with events scheduled.
IFILE Definition of a non standard event file.
Commands of the event scheduling system
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.
II [date [/time] ] Insert Item. An empty mask is displayed for the input of the short description and the full description.
date dd.mm. [yyyy]
Date of the event. The day and the month can be specified as one- or two-digit numbers.
yyyy: 1500 <= yyyy <= 2300. The year can be specified as a four-digit number or as a two-digit number. If the year is not specified (II dd.mm.), the current year is assumed by default.
dd.mm.Y Specification of a yearly repeated event for the date dd.mm. Character 'Y' must be specified as a substitute for the year.
dd.M.Y Specification of a monthly repeated event for the day dd. Characters 'M' and 'Y' must be specified as substitutes for month and year. Lower case letters are also valid.
day Specification of a weekly repeated event. day specifies the name of a day in the week: MON/TUE/WED/THU/FRI/SAT/SUN
D.M.Y Specification of an event repeated daily.
To delete a daily repeated event proceed as follows:
Display the list of all daily repeated events using command SIL D.M.Y. Then enter E into the marking column at the event you want to delete.
/time Time of day for the event in the format hh:mm or hh.mm (24 hour format).
Default: If no date is specified with the II command, the current date is assumed.
Command II will prompt the following mask for the full specification of the event:
You may enter a 50-character long short description for the even in field "Text :". This short description will appear in the event list (command SIL, Show Item List).
In "Comments" you may enter a full description for the event.
Input into the command field of the II-mask
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.
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 to the previous CFS mask.
F3 Record the current mask into the CFS hardcopy file.
Note:
The name of the item file used is evaluated according to certain rules, as described for command IFILE below.
Modify Item: Update event text
MI [date [/time] ] Modify Item. The existing text for the specified event is displayed in a mask and can be updated.
date dd.mm. [yyyy]
Specification of the date of the event. The day and the month may be specified as one- or two-digit numbers.
yyyy: 1500 <= yyyy <= 2300. The year can be specified as a four-digit number or as a two-digit number. If the year is not specified (II dd.mm.), the current year is assumed by default.
dd.mm.Y Modification of the text of a yearly repeated event for the date dd.mm. The character 'Y' must be specified as a substitute for the year.
dd.M.Y Modification of the text of a monthly repeated event for the day dd. The characters 'M' and 'Y' are substitutes for month and year. They can be specified as lower case letters, too.
day Modification of the text of a weekly repeated event. day specifies the name of a day in the week: MON/TUE/WED/THU/FRI/SAT/SUN
D.M.Y Modification of the text of a daily repeated event.
/time Time of day for the event in the format hh:mm or hh.mm (24 hour format).
Default: If no date is specified in the MI command, the first event for the current date is displayed for update.
The format for the MI mask is documented in the paragraph for command II (Insert Item, see above).
Possible input into the command field of the MI- map
M+ | M- Update next/previous event.
CAL/II/MI/SI/SIL/SIS
Commands of the event scheduling systems: Calendar/Insert Item/ Modify Item/Show Item/Show Item List/Show Item Short.
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 to previous CFS mask.
F3 Recording of current mask into the CFS hardcopy file.
Notes:
The date and time of a scheduled event can only be changed via input of C (Change Date) within the SIL mask (see 14-).
If more than one event exists for a date, MI date will display the first of these events for update. The following events can be accessed and updated via the command M+
Show Item: Display text for an event
SI [date [/time] ] Show Item. The full description for the specified event is displayed.
date dd.mm. [yyyy]
Specification of the date of the event. The day as well as the month can be specified as one- or two-digit numbers.
yyyy: 1500 <= yyyy <= 2300. The year can be specified as a four-digit number or as a two-digit number. If the year is not specified (SI dd.mm.), the current year is assumed by default.
dd.mm.Y Display of the text of a yearly repeated event for the date dd.mm. The character 'Y' must be specified as a substitute for the year.
dd.M.Y Display of the text of a monthly repeated event for the day dd. The characters 'M' and 'Y' are substitutes for month and year. They can be specified as lower case letters, too.
day Display of the text of a weekly repeated event. day specifies the name of a day in the week: MON/TUE/WED/THU/FRI/SAT/SUN
D.M.Y Display of the text of a daily repeated event.
/time Time of day for the event in the format hh:mm or hh.mm (24 hour format).
Default: If no date is specified in the SI command, the current date is assumed.
Possible input into the command field of the SI-mask.
+ | - go to next/previous event. Sending an empty command field has the same effect as +.
M Modify: Update the information text for the displayed event.
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.
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 to the previous CFS mask.
K3 Return to the previous SIL mask, if the current event was marked with S or M there.
F3 Recording of the current mask into the CFS hardcopy file.
Notes:
If more than one event exists for a date, MI date will display the first of these events for update. The following events of the same date can be updated via the command + or by sending the empty command field.
The command SILA displays executed events (events marked as OK) in the summary list also. If you specify code S (Show) in a SILA mask, the resulting mask will contain the date of the event's execution.
The name of the item file used is evaluated according to certain rules as described for command IFILE at the end of this chapter.
Show Item List: Display event list
SIL date [+|-] Show Item List. This command shows the short descriptions for all events at/until/ from the specified date.
SILA date [+|-] Show Item List All. Executed events (state=ok) are not displayed with command SIL. If you want to display executed events also, use command SILA instead of SIL.
Specification of the date of the event. The day and month can be specified as one- or two-digit numbers.
yyyy: 1500 <= yyyy <= 2300. The year can be specified as a four-digit number or as a two digit-number. If the year is not specified (SIL dd.mm.), the current year is assumed by default.
**.mm.Y Display all events repeated yearly in the specified month mm.
**.M.Y Display all events repeated monthly.
**.**.Y Display all events repeated yearly.
day Display the text of all weekly repeated events. day specifies the name of a day in the week: MON/TUE/WED/ THU/FRI/SAT/SUN .
All events repeated weekly are displayed by command SIL MO+. In the item list you may set a weekly event to OK. You may even delete that item by specifying Y or E in the marking column. It is not possible to move a weekly repeated event to another day in the week.
Default: If no date is specified in the SIL command, the current date is assumed.
+ Display all events scheduled later than the specified or the current date.
- Display all events scheduled until the specified or current date.
Default: If the option +/- was not specified after the date, only the event list for the date is displayed.
SIL +|- [n] Show Item List with relative date specification.
SILA +|- [n] Show Item List All with relative date specification
+ Display of all events starting from the current date (no 'until' limit).
- Display all events.
+n Display of all events starting with the current date for the next n days. n can be a one- to three-digit number.
-n Display all events starting n days before the current date (no 'until' limit). n can be a one- to three-digit number.
Notes:
Independent of absolute or relative date specification, periodic events happening in the specified period are also displayed.
Already executed events (State=ok) are not displayed by SIL. If you want to display these events also, please use the command SILA (Show Item List All).
Selection of events by a search string for the event text
SIL / SILA search The short and full texts of all events are searched for the specified search string. The events matching the search string are displayed.
SIL: This command displays only matching events that were not already executed.
SILA: This command displays all matching events, also those already executed (marked OK).
search [col] [r] item
simple search argument as documented on page 8-.
search [ vk search ] [...] ..... | ( ) | %name | ( s-dat )
complex search argument as documented on page 8-.
Notes:
Upper case and lower case letters are matched during the search process. Internally both the event texts and the search string are translated to upper case letters.
Examples:
SIL 'Appointment'
All events containing the specified search string within the short or long text are displayed.
SIL :14:'Y'
All events marked as executed (State=ok, see page 14-) are displayed (because 'Y' is specified as search string).
SIL :14:-'Y'
All events not yet executed are displayed.
The command SIL will display the event list in the following mask:
Monthly or yearly repeating events are represented as dd.mm.yy or dd.mm.yy .
Possible input into the command field of the SIL mask
+ | - previous/next page of the event list.
+n | -n position n lines forward/backward in the event list.
++ | -- position to the beginning/end of the event list.
Save List. The event list displayed on the screen is edited for printing and is then written into the specified file. With the parameter ALL, not only the short text but also the full text is written into the file.
If no filename was specified, the filename used by default is CFS.ITEM.LIST [.jobname] .
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.
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 to previous CFS mask.
F3 Recording of the current mask into the CFS hardcopy file.
You may specify the following action codes in the marking column of the event list:
C Change Date/Time. This Action Code allows to change an event's date and time. It is not allowed for events repeated daily or weekly.
D Display Item. With this Action Code, not only the short texts but also the full text (comments) are displayed for the event. Same as command SI, page 14-.
E Erase Item. The event is deleted from the item file.
I Insert (Copy Item). Similar function to the Action Code C (see above). The previous event remains unaltered. An additional event with the new date will be created.
M Modify Item. The same as S, except that event information may be updated. See also command MI, page 14-.
N State=not ok. This action code resets the 'executed'-mark for the event.
Y State=ok. This action code sets the 'executed'-mark for the event. The event is from now on regarded as executed.
Note:
The name of the item file used is evaluated according to certain rules as described for command IFILE at the end of this chapter.
Show Item Short: Display a comprised event list in the system line
SIS date [+|-] Show Item Short. This command displays the dates of events in the specified period of time in the system line of the screen. The SIS command is especially suitable for being used in CFS startup procedures.
date dd.mm. [yyyy]
Specification of the date of the event. The day and the month can be specified as one- or two-digit numbers.
yyyy: 1500 <= yyyy <= 2300. The year can be specified as a four-digit number or as a two-digit number. If the year is not specified (II dd.mm.), the current year is assumed by default.
Periodically repeated events are also retrieved with command SIS. Please refer to the description of date-parameter in the command SIL on page 14-.
Default: If no date was specified in the SIS command, the comprised event list for the current date is displayed.
+ Display all events from the specified or the current date onward.
- Display all events until the specified or current date.
Default: If the option +/- was not specified after the date, only the event list for the date is displayed.
SIS +|- [n] Relative date specification.
+ Display all events starting with the current date (no 'until' limit).
- Display all events.
+n Display all events starting with the current date for the next n days. n can be a one- to three-digit number.
-n Display all events starting n days before the current date (no 'until' limit). n can be a one- to three-digit number.
Caused by command SIS the screen's system line will contain a message of the following form:
Items present for 18.4.90 27.4. 2.5. 10.5.*2 16.5. 13.6. 22.8.
Notes:
Independently of absolute or relative date specification, periodic events scheduled in the specified period are displayed also.
IFILE file Item File. With this command the user defines the event file.
If no IFILE command was specified, CFS will search for the Item File according to the following hierarchy:
a) Was a FILE command given LINK=ITEM ?
b) If a job name was specified with the LOGON command (.name LOGON ...):
IFILE = CFS.ITEM.name
c) If no job name was specified with the LOGON command: IFILE = CFS.ITEM
d) If no file CFS.ITEM.name or CFS.ITEM exists:
IFILE = $user-id.CFS.ITEM. $user-id is the user-id under which the program CFS is stored.
e) If none of the above conditions a) to d) apply, the first command II/MI/SI/SIS/ SIL will create an Item File CFS.ITEM.name or CFS.ITEM .
Application example for event calendar in start up file
The following example explains the application of the event scheduling system in a startup file of CFS:
In the first step the centralised birthday file (IFILE $TSOS.CFS.ITEM.BIRTHDAY) is checked . Birthdays existing for the current date are displayed as an event list. In the second step the private event file of the user is assigned (IFILE CFS.ITEM. &LOGNAM). The summary displays all events that are due since the last CFS call and all events that are due in the future. In addition the system line displays all events for the current date. In the last state the job variable containing the date of the last CFS-call is updated.
*002 FILE=NO
* ****** * DISPLAY E V E N T C A L E N D A R * ******
IFILE $TSOS.CFS.ITEM.BIRTHDAY
SIL
*IF %OUT=C'S H O W I T E M L I S T' SKIP .GT
*SKIP .NGT
.GT
*ON %CMD CONTINUE
*DIA
.NGT
* DISPLAY OF EVENTS STARTING WITH THE DATE OF THE LAST
* CFS CALL
IFILE CFS.ITEM.&LOGNAM
/DCLJV CFS.JV.&LOGNAM..LAST.START
/DCLJV #X
/SETJV #X,CFS.JV.&LOGNAM..LAST.START
*ON %CMD CONTINUE
SIL &(#X) +
* DISPLAY ONLY EVENTS FOR CURRENT DATE IN SYSTEM LINE !
*DIA SIS
/SETJV CFS.JV.&LOGNAM..LAST.START,$SYSJV.DATUM
* ***** * END OF E V E N T C A L E N D A R * *****
*DIA