Penn Computing
Computing Menu Computing A-Z
Computing Home Information Systems & Computing Penn

TSO/ISPF
Features and Setup Instructions

This document describes new TSO/ISPF features and provides the recommended setup instructions for TSO/ISPF sessions. ISC recommends that you first familiarize yourself with the new features and functions. Once you are familiar with the new features, execute the setup instructions. Relevant sections of this document are:

 
Macintosh users:  Please substitute any instruction to right-click your mouse as follows: move your cursor to the field or option being described and press Enter.

 


New TSO/ISPF Features

Please familiarize yourself with the TSO/ISPF features described in this section. New terminology is introduced, enhanced features are explained, and examples are provided for you to follow. You'll want to understand the new terminology and features before performing the setup instructions.

 
Scrolling Note:  Scrolling on ISPF Panels is possible whenever you see "MORE +" or "MORE -" in the upper right corner of your panel.
"MORE +" indicates you can scroll down (PF8)
"MORE -" indicates you can scroll up (PF7)
 


Action Bars

Action Bars are choices that appear at the top of a panel. They provide an alternative to navigation within ISPF. When you select an Action Bar, ISPF displays a pull-down menu. The pull-down menu will contain a list of choices that extend from the Action Bar you selected.

Some of the pull-down menu's choices will contain an ellipsis (...), which means that selecting that choice will display a pop-up window instead of a full panel. Pop-up windows are bordered and display over another panel. Pressing Enter will not close a pop-up window. You must Exit (PF3) or Cancel (PF12) from pop-up windows.

There are several ways to select an Action Bar, for example:

  • Place your cursor directly before (or on top of) the action bar's text and press Enter.
  • Right-click the action bar's text with your mouse.

Once a pull-down menu is open, pressing Enter will automatically select the first choice (1) in the list. To select an alternative, type the number of the choice and press Enter.

To close a pull-down menu without making a selection:

  • Move your mouse pointer outside the pull-down menu area and right-click.
  • Press PF10 (Actions) or PF12 (Cancel); PF10 cannot be used to close a pull-down menu while editing a data set within Option 2.
 
Navigation feature:  PF10 will toggle your cursor between Action Bars & the command line.

 


Point-and-Shoot Fields

Point-and-shoot fields are cursor sensitive text fields. If you right-click a point-and-shoot field, the action it describes is executed. The action itself can be a single command or a string of commands. Try the examples below.

Example 1

  1. Type =3.1 and press Enter
  2. Type in the name of your ISPF Library. If you do not have an ISPF Library or cannot remember the name, temporarily use the PDS below:
           Project    P790635
           Group      YURI
           Type       CLIST
  3. Right click your mouse anywhere on the text "Data set Information." You should now see the Data Set Information panel displayed (it lists General Data, Current Allocation, and Current Utilization).
  4. Press PF3 (or right-click anywhere on the panel) to exit back to Option 3.1.

Example 2
  1. Type COLOR at the command line on any panel, then press Enter.
  2. Change any of the colors (e.g., BLUE to RED and GREEN to WHITE), then press Enter.
  3. To return your colors to their original defaults, either place your cursor anywhere on the word "Defaults" in the upper right corner of your screen and press Enter, OR right-click anywhere on the word "Defaults."

The cursor-sensitive portion of the point-and-shoot field often extends past the text itself. Until you become more familiar with this new feature, you can temporarily display these fields in reverse video to make them easily recognizable. To set reverse video:
  1. Type PSCOLOR on the command line, then press Enter.
  2. For the Point-and-Shoot panel element only, change NONE in the HIGHLIGHT column to REVERSE.
  3. To see the effect, press PF3 to exit 3.1 and then type =3.1 to re-enter.


Action Bars within Edit (Option 2)

Action Bars are available after you have entered a member set in EDIT (Option 2). They allow greater flexibility and new functions. The Action Bars are:

  • The File Action Bar can be used to Save or Cancel during your Edit session.

  • The Edit Action Bar can used to Reset, Undo, or Hilite.

    • Reset functionality has not changed.
    • Undo is a new command that reverses the most recent changes made. Undo only works with Recovery On.
    • Hilite lets you customize highlighting for each programming language. Right-click on Hilite and you will be taken to a panel where you can personalize your Edit Color choices.

  • The Compilers Action bar is used to select program compilers from an ISPF panel. These panels are not yet configured. If you select and execute a compile request, you will receive "MODULE NOT FOUND" messages.

  • The Test Action Bar is used for Dialog testing. This new function has some flexible features, such as defining your own Break Points, but not enough research has been completed to create usage tips or recommendations.


Sort Features

Members of a PDS can be sorted using the cursor-sensitive column field. For example:

  1. Type =2 and press Enter.
  2. Press Enter again to display the member list for your PDS.
  3. Place your cursor on the CREATED column heading and press Enter or right-click the CREATED column heading.
The member list is now displayed in descending create-date order. CREATED is now your primary sort column. The LOCATE (L) command is always associated with the primary sort column. If you wish to locate a member by name, re-sort using the name column before issuing the LOCATE command.

Here is how to make NAME your permanent sort order:

  1. Type =3.1 and press Enter
  2. Press Enter to display a Member List of your PDS
  3. Right-Click on "Functions" Action Bar
  4. Select Initial Sort View (3)
  5. Enter 1 in both columns (you probably have 6?)


View and Browse

View is a new function. View lets you edit a dataset and make changes within the dataset, but will not let you save the dataset with its original name. When you attempt to exit after updating a dataset, a pop-up window will appear with the View Warning Message. The warning asks if you want to Exit without saving changes. It also prompts you to use the CREATE or REPLACE command to save the member to another name.

Many panels now offer both View and Browse options. The Option 1 panel defaults to View -- not Browse as it used to do. In Option 3.1 notice that you can now select View (V) as a new function.


TSO/ISPF Setup Instructions

When you first enter a TSO/ISPF session, you will find that panels display basic IBM defaults. Follow the instructions below to modify your screen display. Your new configuration and setup options will automatically be saved when you log off.


Move the Command Line to the Top of the Screen

  1. Select the "Menu" action bar from the ISPF Primary Menu
  2. Select "Settings" from the pull-down menu
  3. Set the ISPF settings as follows:
    _ Command line at bottom
    _ Panel display CUA mode
    _ Long message in pop-up
    _ Tab to action bar choices
    _ Tab to point-and-shoot fields
    / Restore TEST/TRACE options
    / Session Manager mode
    / Jump from leader dots
    _ Edit PRINTDS Command
    / Always show split line
  4. Press PF3 to exit
Tip: You can also type  Settings   from any screen to bring up the settings panel.


Remove the PF-Key Display

  1. Select the "Menu" action bar from the ISPF Primary Menu
  2. Select "Settings" from the pull-down menu
  3. Select Function Keys from Settings action bar
  4. Type "6" (Remove function key display)
  5. Press Enter
  6. Press PF3 to exit
Tip: You can also type PFSHOW from any screen to see Pfkey displays. You can modify your Pfkeys by typing ZKEYS from any screen.


Remove Underscores on Panels

  1. Select the "Menu" action bar from the ISPF Primary Option Menu
  2. Select "Settings" from the pull-down menu
  3. Select Colors/CUA Attributes (2) from the Settings action bar
  4. Scroll to the next page
  5. Modify 'Normal Entry Field" by entering NONE in Highlight column
  6. Press PF3 to exit
Tip: You can also type CUAATTR from any panel to go directly to CUA Attributes.


Display the Calendar

  1. Select the "Status" action bar from the ISPF Primary Option Menu
  2. Select Calendar (3) from the pull-down menu
  3. Press Enter

All fields on the calendar are point-and-shoot fields that function as follows:
  • Click the right bracket ( > ) and the months go forward
  • Click the left bracket ( < ) and the months go backwards
  • Click the month (e.g. February) and the Calendar Month pop-up lets you specify the month to be displayed
  • Click the year (e.g., 1998) and the Calendar Year pop-up lets you specify the year to be displayed
  • Click Saturday, Sunday, or Monday to specify the start day for your calendar week
  • Click any Day (e.g., Mo, Tu, We) to display the Start-Day pop-up
  • Click any number in the month and the Julian Date pop-up displays (but you cannot enter anything in this pop-up)
  • Click "Time" to display the pop-up for 12 or 24 hour format
  • Click "Day of Year" to translate the Julian Date to a standard date (ccyy/mm/dd)

The colors of the calendar can be changed, for example:

  1. Select the Menu action bar.
  2. Select Status Area (9) from the list.
  3. Select the Options action bar (on the Status Area pop-up).
  4. Select Calendar colors (2).
  5. Select 2 (Red) for Heading Date and Current Day, then press Enter. You'll see your changes immediately on the sample calendar.
  6. After modifying the colors, Press PF3 twice to exit the two pop-ups
  7. You must now exit the Main Menu for your color choices to be displayed. Go to another option and then return to the Main Menu.


Change the View Entry panel (Option 1) to default to Browse

  1. Type =1 and press Enter.
  2. Scroll or tab down (press PF8).
  3. Place a slash (/) in front of the "Browse Mode" option.


Remove the Warning for Recovery

The following sequence of commands will set RECOVERY OFF. With recovery set to off, the "UNDO not available" message will not be displayed

  1. Type =2 and press Enter.
  2. Edit any dataset or PDS member.
  3. At the Command line type   rec off nowarn.
  4. Press Enter.


Set Log/List Defaults

The Log dataset used by ISPF should be deleted at the end of each session. To delete the log:

  1. Select the Menu action bar from the ISPF Primary Option Menu
  2. Select "Settings" from the pull-down list
  3. Select Log/List action bar from ISPF Settings panel
  4. Select "Log Data Set Defaults" (1) and enter:
    Process option          2
    SYSOUT class            A
    Local Printer ID        blank
    Lines per page          60
    Primary pages           1
    Secondary pages         1
    Log Message ID          blank
  5. PF3 to exit

The List dataset used by Option 3.1 should be printed before it is deleted.

  1. Select the Menu action bar from the ISPF Primary Option Menu
  2. Select "Settings" from the pull-down list
  3. Select Log/List action bar from ISPF Settings panel
  4. Select "List Data Set Defaults" (2.) and enter:
    Process option          1
    SYSOUT class            A
    Local Printer ID        blank
    Lines per page          60
    Primary pages           10
    Secondary pages         20
  5. PF3 to exit

Define the LRECL and format for the List dataset

  1. Select the Menu action bar from the ISPF Primary Option Menu
  2. Select "Settings" from the pull-down list
  3. Select Log/List action bar from ISPF Settings panel
  4. Select "List Data Set characteristics" (3.) and enter:
    Record Format           1
    Logical Record Length   121
    Line Length             120
  5. PF3 to exit

Create JCL for use with all ISPF print options

  1. Select the Menu action bar from the ISPF Primary Option Menu
  2. Select "Settings" from the pull-down list
  3. Select Log/List action bar from ISPF Settings panel
  4. Select JCL and enter:
    //anyname  JOB  (######,M999,,99),'TSO 3.1 LIST',CLASS=A,
    //         MSGCLASS=A,NOTIFY=PXXXXXX,TIME=(2,0)
    /*ROUTE PRINT TSO
    Note that M999 is your bin number and PXXXXXX is your TSO Logon-Id

  5. PF3 to exit


Set IOF Defaults

The way in which you save IOF Profile options has changed. The new instructions are provided below.

  1. Type =i. to get to the IOF Menu

  2. P from the IOF Option Menu allows you to set default characteristics.

  3. SAVEPROF entered on the COMMAND line on the IOF Menu will save the defaults that you type in for JOBNAMES, SCOPE, and DEST.

    • Tab down to SCOPE and type P790010 (do not press ENTER)

    • Press the HOME key on the keyboard to move the cursor to the COMMAND line

    • Type SAVEPROF

    You now have your SCOPE option set to default across IOF sessions. Whenever you use IOF, the SCOPE option will remain set to P790010 (shows jobs by this user).

    You can also enter something in JOBNAMES and DEST and then use the SAVEPROF command to permanently save the values.

    Instead of using the SAVEPROF, you can also enter default options by using the COMMAND line at the top of the IOF Menu

    1. type scope all on COMMAND line
      press ENTER

      You have saved the value of ALL in your profile for SCOPE. It will be used across IOF sessions.

      To turn SCOPE back to blank, type 'scope' and press ENTER.

    2. type prefix iebgener on COMMAND line
      press ENTER

      You have saved IEBGENER as your JOBNAMES default. Just remember to use the word prefix instead of jobnames on the COMMAND line whenever you are setting JOBNAMES defaults.

      To turn the prefix off, type prefix and press ENTER.

    3. type dest local on COMMAND line
      press ENTER.

    Destination numbers, remote numbers, and routing destinations can be used in this field. Separate multiple destinations by commas or spaces (e.g. dest local,remote9)

  4. To review the new features for a release:

    type NEW on COMMAND line from the IOF Menu and press ENTER

  5. It is recommended that you familiarize yourself with the Job List Menu Commands by accessing the Quick Trainer (QT) option.

    • type qt on COMMAND line from IOF Menu and press ENTER
    • type 6 to select Index of IOF Features and press ENTER
    • type 2 to access documentation on available IOF commands
  1. All Operations staff should read and review documentation on DEVICES and CONSOLE:

    • type qt on COMMAND line from IOF Menu and press ENTER
    • type 6 to select Index of IOF Features and press ENTER
    • type 9 to access and review documentation on DEVICES (return to index of major IOF functions)
    • type 11 to access and review documentation on CONSOLE
top

Information Systems and Computing
University of Pennsylvania
Comments & Questions


University of Pennsylvania Penn Computing University of Pennsylvania Information Systems & Computing (ISC)
Information Systems and Computing, University of Pennsylvania