Put the Calendar on your TSO/ISPF home page

You want to put the calendar on your TSO/ISPF home page, that is, your ISPF Primary Option Panel ?

Yes, we're back to ISPF settings. There are so many!  The calendar is a popular one.

There are a couple of ways to do this.  First we'll do it the quick and easy way.

Go to the ISPF primary option menu, the default initial screen display in ISPF, the home page.

The very top line of the TSO/ISPF display, above the dotted line, is called the "Action Bar".
This is the line that starts where it says "Menu" at the upper left of the ISPF screen.
About the fifth choice from the left it says "Status".  Place your cursor over the word "Status" on that top line, and with the cursor positioned on "Status", press enter. 

  Menu  Utilities  Compilers  Options  Status  Help 
 ------------------------------------------------------------------------------ 
                            ISPF Primary Option Menu  
 Option ===>  
  
  0  Settings      Terminal and user parameters            User ID . : Your-ID  
  1  View          Display source data or listings         Time. . . : 17:33 
  2  Edit          Create or change source data            Terminal. : 3278T  

The "Status display" drop-down menu should appear.  Yes, that decorative display area on the right-hand side of your primary menu is called the Status display.

Looking at the drop-down list, you notice that option 3 in the list says "Calendar".

To select 3 for calendar, you type the number 3 in the itty-bitty entry area on the top line of the box, and press enter.

 Menu  Utilities  Compilers  Options  Status  Help 
 ------------------------------------ *----------------------------*
                            ISPF Prim | 3  *. Session              |
 Option ===>                          |    2. Function keys        |
                                      |    3. Calendar             |
 0  Settings      Terminal and user p |    4. User status          |
 1  View          Display source data |    5. User point and shoot |
 2  Edit          Create or change so |    6. None                 |
 3  Utilities     Perform utility fun *----------------------------*
 4  Foreground    Interactive language processing
 5  Batch         Language Processors
 6  Command       Enter TSO or Workstation commands
 __________________________________________________________________

Voila, the calendar appears on the screen! :

 Menu  Utilities  Compilers  Options  Status  Help 
 ------------------------------------------------------------------------------ 
 
                            ISPF Primary Option Menu  
 Option ===>  
  
 0  Settings      Terminal and user parameters            < Calendar >   
 1  View          Display source data or listings            May       2017 
 2  Edit          Create or change source data            Su Mo Tu We Th Fr Sa 
 3  Utilities     Perform utility functions                   1  2  3  4  5  6   
 4  Foreground    Interactive language processing          7  8  9 10 11 12 13 
 5  Batch         Language Processors                     14 15 16 17 18 19 20 
 6  Command       Enter TSO or Workstation commands       21 22 23 24 25 26 27 
 7  Dialog Test   Perform dialog testing                  28 29 30 31  
  
 				  	                  Time . . . . : 05:38 
                                                          Day of year. :   142 
Enter X to Terminate using log/list defaults  
______________________________________________________________________________ 

Okay, you might say, you're done here now.
But if you read a little further you'll see how you can set some fun options, like colors.

This brings us to method 2.

Yes, method 1 was the easy way, and method 2 is the way where you can set options.

Again starting from your ISPF Primary Option Menu, this time you select the "Menu" option in the "Action bar", that is, move your cursor up to where it says "Menu" in the top left corner of the ISPF screen, and then, with the cursor on "Menu", press enter.

When you press enter with the cursor on "Menu", you will see a drop-down selection box appear directly Under the word "Menu".

In that drop-down box, you select 8 for Status Area by typing the number 8 in the little bitty entry field at the left of the top line in the drop-down box, and again you press enter.

 Menu  Utilities  Compilers  Op 
 *-----------------------------*   
 | 8  1. Settings              |  
 |    2. View                  |  
 |    3. Edit                  |  
 |    4. ISPF Command Shell    |  
 |    5. Dialog Test...        |  
 |    6. Other IBM Products... |  
 |    7. SCLM                  |  
 |    8. Status Area...        |  
 |    9. Exit                  |  
 *-----------------------------*  

After you select 8, you will get still another drop-down box (or pop-up box, if you prefer to think of it that way).  The box will show a copy of your current "Status" display.

Focus on the top line inside that box where it says "Status Options" — that is where you want to place the Cursor over "Status" and press Enter.

 Menu  Utilities  Compilers  
   *-------------------------*  
   |   Status  Options       |   
   | ----------------------  |    
   |  ISPF Status            | 
   | Command ===>            |  
   |                         |  
   |                         |  

 

You will now get yet another box, overlaying most of the previous box. This newest box has numbered options.

Option 3 is Calendar, unless your choice has already been set to Calendar, in which case the 3 will be coverd by an asterisk, and you skip this step.

Assuming you do not currently have the Calendar option turned on, you now select 3 for "Calendar" by typing the number 3 in the itty bitty little entry field and then pressing enter. Doing this will turn on the Calendar display.

Now get back to that box that says "Status Options", put the cursor over the word "Options", and press enter.
You now get — Can you guess? — another drop-down box.
This one contains, unsurprisingly, options you can set. The first two choices are "1. Calendar Start day" and "2. Calendar Colors".

Select 2 for colors and you will get another little mini-display that lists the names of the Calendar fields you can change in the left-hand column. Each is followed by its own little tiny entry field, and there is another column showing the available color choices numbered 1 through 8.

 Menu  Utilities  Compilers  Options  Status  Help 
  *-------------------------* ----------------------------------------------  
  |   Status  Options       | F Primary Option Menu   
  | - *------------------------- Calendar Colors --------------------------*  
  | S |                                                          Defaults  | 
  | C |                                                                    | 
  |   |   Change one or more of the Calendar colors and press enter to     | 
  |   |   immediately see the effect. Clearing a field restores defaults.  | 
  |   |                                                                    |   
  |   | Field:            Color:    Valid Colors:    Sample:               | 
  |   | Scroll Button . . . 8       1. White         < Calendar >  | 
  |   | Heading Date  . . . 8       2. Red              July      1995     |  
  |   | Heading Text  . . . 8       3. Blue          Su Mo Tu We Th Fr Sa  | 
  |   | Weekday . . . . . . 8       4. Green                            1  | 
  |   | Saturday/Sunday . . 8       5. Pink           2  3  4  5  6  7  8  | 
  |   | Current Day . . . . 8       6. Yellow         9 10 11 12 13 14 15  | 
  |   |                             7. Turq          16 17 18 19 20 21 22  | 
  |   |                             8. CUA default   23 24 25 26 27 28 29  |  
  |   |                                              30 31                 |   
  |   |                                              Time . . . . : 10:10  | 
  |   |                                              Day of year. :   202  | 
  |   |                                                                    | 
  *-- |                                                                    | 
      |                                                                    | 
      *--------------------------------------------------------------------* 

Turq is short for turquoise, also known as aqua, aquamarine, peacock blue, sometimes called teal — that green-blue color with the power to inspire otherwise sane people to argue over whether it is "really" a shade of green or of blue. The particular shade of turquoise used for 3270 screens is noteworthy for being a bright pastel, so it stands out from a black background, like a softened shade of white.

Assuming you use the IBM 3270 emulator, you can actually manipulate the 3270 emulator settings to revise the color values, so you can adjust the value of fields currently designated as "Turq" to be closer to green or closer to a pale sky blue. Or maybe you don't like pink — you can adjust normally pink fields to be more of a plum purple or peach orange or any other color you like. If you're red-green color blind, and you don't use the newish corrective lenses for that, you can go into the 3270 emulator settings and pick out any shades of colors you can easily distinguish and assign your own personal color choices to be used for whatever fields are by default green, red, or anything else. Or if you see colors the same way most people do, but the only ones you like are red and grey, you can pick a set of variations on red and grey, though personally I wouldn't advise it in an office setting. But that's all a digression. The  point was that the "Turq" choice on the screen stands for turquoise — whatever turquoise might be.  Surely you don't think It was just a sneaky way to get you interested in exploring what you can do with your 3270 emulator settings.  Anyway, back to the Calendar settings.

If you've gotten to the screen shown just before the digression, you're in the ISPF Colors for Calendars place, and you can reassign colors to field types on the calendar display.

Let's say you want Weekdays to be Blue, which is color number 3 in the "Valid Colors" column, and you want Saturdays and Sundays, that is, weekends, to be Red, which is color number 2. You find the word "Weekday" listed in the left-hand column, the column titled "Field:". You type the digit 3 in the one-byte entry field just to the right of the word "Weekday". You then enter the digit 2 in the entry field that comes right after "Saturday/Sunday". You want the current day to be highlighted in white? You put the digit 1 in the entry field after "Current Day". Set any other color choices you want in a similar way. Press enter. At the far right of the little mini-screen, under the title "Sample:", you will see a copy of a calendar month display. It should change colors to reflect your chosen colors right after you press the enter key. You can hang around on this mini-screen revising the colors until you hit a pattern you like. Bingo, you're done.

Press F3 as needed to get back to the ISPF home page, aka the Primary Option Menu, and carry on with your day.

You can, of course, repeat the exercise, and this time choose to revise "1. Calendar Start day… " rather than "2. Calendar Colors… ", but I'll leave that to you to explore on your own.