Setting parameters for TSF operation

The Timed Screen Facility (TSF) schedules certain screen spaces at specified times of day or at specified intervals. For example, you can turn on bottleneck analysis automatically at 2:00 PM every weekday, and off again at 2:15 PM, or .invoke a screen space at regular intervals.

To use TSF, follow this procedure.

Create any screen spaces you want TSF to invoke.
You can use the .SGO or .FGO command to chain screens together, and .RTN to end the cycle. Special considerations for creating screen spaces in TSF are discussed later in this chapter.
Turn on TSF with the TSF keyword of the OPTN command.
Use the .TSF00 command to enter the names of the screen spaces and the times or time intervals when you want them invoked.
The .TSF00 command displays the current status of the TSF feature (ON/OFF), and lists all entries. The TSF table is shipped with 99 blank entries. For example:
```
 .TSF00  ON
         1  Time=0000  SS=*NONE*  DAY=DAILY
         2  Time=0000  SS=*NONE*  DAY=DAILY
         3  Time=0000  SS=*NONE*  DAY=DAILY
         4  Time=0000  SS=*NONE*  DAY=DAILY 
```
Enter .TSFnn to display entry nn in the TSF table. To define an entry, type .TSF followed by the number of the entry. For example, type .TSF01 to produce:
```
.TSF01  Time=0000  SS=*NONE*  DAY=DAILY 
```
You can type the new entry over the current entry, press ENTER, and the value is reset.

If you want to change an entry that doesn’t appear on the physical screen, you can specify an argument to skip nn entries. Type
```
.TSF00 20 
```
to display entries 21 through 99 in the TSF table, skipping the first 20.

Following are the keywords and valid entries.

Time: Specifies the time of day (from 0000 to 2400) to invoke the screen. TIME=+nn invokes the screen every nn minutes.
Note: The screen space will not execute while the TIME=+nn entry remains on your current screen.
SL or SS: Specifies the screen space to invoke if TSF is in effect. SS specifies the screen space to invoke, but does not turn on the log. SL automatically turns on the REPORT log when the exception trips, and screen space logging starts. You must specify either SS or SL for TSF to work.
DAY: The valid entries for day of week are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY, WEEKDAY, WEEKEND, and DAILY. The days of the month are also valid entries (numerals 1 through 31). The default value is DAILY. You may abbreviate the input as long as it is unique, and as long as the day of the week is recognized.
You may specify day combinations by enclosing the names of the days within parentheses, and by separating each day with either a comma or a blank.

This example shows five TSF entries.


  .TSF01   1   TIME=1800 SL=WENDSHFT  DAY=DAILY
  .TSF02   2   TIME=0600 SS=WEEKSTRT  DAY=MONDAY
  .TSF03   3   TIME=1200 SL=NOONTIME  DAY=(TH,F)
  .TSF04   4   TIME=0800 SS=MONTHEND  DAY=30
  .TSF05   5   TIME=+30  SL=STATUS    DAY=DAILY

TSF01: Executes and logs screen space WENDSHFT at 6:00 PM daily.
TSF02: Executes screen space WEEKSTRT at 6:00 AM every MONDAY.
TSF03: Executes and logs screen space NOONTIME at 12:00 PM every Thursday and Friday.
TSF04: Executes screen space MONTHEND on the 30th of each month at 8:00 AM.
TSF05: Executes and logs screen space STATUS every 30 minutes every day.