ISPF Navigation Basics

ISPF navigation is the foundation of working effectively with the Interactive System Productivity Facility. Understanding how to navigate ISPF panels, menus, and functions is essential for productive mainframe work. ISPF uses a menu-driven interface with panels, function keys, commands, and navigation patterns that allow you to access and use various ISPF capabilities efficiently.

Navigation in ISPF involves moving between panels, selecting menu options, using function keys, entering commands, and understanding how different parts of ISPF connect. This tutorial covers the fundamental navigation concepts and techniques you need to work effectively with ISPF, from basic menu selection to advanced navigation patterns. Mastering ISPF navigation will make you more efficient and confident when working on the mainframe.

Understanding ISPF Navigation

ISPF navigation is built around panels, menus, and commands that work together to provide a cohesive user interface. Understanding the navigation model helps you move through ISPF efficiently.

Panel-Based Navigation

ISPF uses a panel-based interface where each screen is a "panel":

• Panels as Screens: Each screen you see in ISPF is a panel—a structured display that shows information, collects input, or provides options. Panels are the building blocks of the ISPF interface, and navigation involves moving from one panel to another.
• Panel Connections: Panels are connected through navigation—selecting an option on one panel typically displays another panel. This creates a navigation flow where panels lead to other panels, building a hierarchical or sequential structure.
• Panel Stack: ISPF maintains a "panel stack" (history) of panels you've visited. Each time you navigate to a new panel, it's added to the stack. This allows you to navigate backward through your navigation history using PF3 (End).
• Panel Types: Different types of panels serve different purposes—menus provide options, input panels collect data, display panels show information, and utility panels provide specific functions. Understanding panel types helps you know what to expect and how to interact with each panel.

Menu-Driven Interface

ISPF is primarily menu-driven, meaning you select options from menus:

• Numbered Options: Most ISPF menus display numbered options (like "Option 1", "Option 2", "Option 3") that you select by typing the number and pressing Enter. This is the primary navigation method in ISPF.
• Option Selection: To select an option, type the option number on the command line (or in the option field if provided) and press Enter. For example, typing 2 and pressing Enter selects Option 2.
• Menu Hierarchy: Menus are organized hierarchically—selecting an option from a main menu may display a submenu with more options. This creates a navigation tree where you drill down into specific functions.
• Action Bars: Some panels include action bars—horizontal menus at the top with options you can select. Action bars provide additional navigation and function access beyond numbered options.

Command-Based Navigation

In addition to menus, ISPF supports command-based navigation:

• Command Lines: Most panels include command lines where you can type commands. Command lines are typically at the top of panels, and commands you type there perform operations or navigate to other functions.
• Primary Commands: Primary commands are full commands that perform operations. Commands vary by context—editor commands work in the editor, utility commands work in utilities, and navigation commands work across panels.
• Shortcuts: Some commands provide shortcuts for common operations. For example, typing a line number in the editor jumps to that line, and certain command abbreviations provide quick access to functions.
• Command Syntax: Commands follow specific syntax rules. Understanding command syntax helps you use commands effectively and avoid errors. Help (PF1) provides command syntax information.

The ISPF Primary Option Menu

The ISPF Primary Option Menu is the main entry point to ISPF functions and the foundation of ISPF navigation.

Accessing the Primary Option Menu

The Primary Option Menu is typically the first screen you see after logging into ISPF:

• After Logon: When you log into TSO and start ISPF, the Primary Option Menu is usually displayed automatically. This is your starting point for ISPF navigation.
• From Other Panels: You can return to the Primary Option Menu from other panels by pressing PF3 (End) multiple times to navigate back through the panel stack, or by using navigation commands that return to the main menu.
• Using Commands: Some ISPF versions allow you to type commands like "=X" or use function keys to return directly to the Primary Option Menu from anywhere in ISPF.

Primary Option Menu Structure

The Primary Option Menu displays numbered options for major ISPF functions:

• Option 0 (Settings): Accesses ISPF settings and profile configuration. This is where you customize your ISPF environment, function keys, and preferences.
• Option 1 (View/Browse): Opens ISPF Browse mode for viewing datasets and files in read-only mode. Browse is used for examining files without the ability to modify them.
• Option 2 (Edit): Opens the ISPF Editor for creating and modifying datasets. The editor is one of the most frequently used ISPF functions.
• Option 3 (Utilities): Accesses ISPF utilities including library utility, dataset utility, move/copy utility, and DSLIST. Utilities provide dataset management and manipulation functions.
• Option 4 (Foreground): Provides foreground job execution capabilities, allowing you to run programs interactively.
• Option 5 (Batch): Accesses batch job submission and management functions.
• Option 6 (Command): Opens a command entry panel where you can enter TSO commands or ISPF commands directly.
• Option 7 (Dialog Test): Provides dialog testing capabilities for panel development (typically for developers).
• Option 8 (LM Utilities): Accesses library manager utilities for working with panel libraries and other ISPF libraries.
• Option 9 (IBM Products): Provides access to IBM product interfaces integrated with ISPF.
• Option T (Tutorial): Accesses ISPF tutorials and help (if available in your ISPF version).
• Option X (Exit): Exits ISPF and returns to TSO or logs you off.

Note: The exact options and their numbers may vary depending on your ISPF version and system configuration. Some options may be customized or unavailable in your environment.

Selecting Options from the Primary Menu

To select an option from the Primary Option Menu:

• Type the Option Number: Type the number (or letter) corresponding to the option you want on the command line. For example, type 2 to select Option 2 (Edit).
• Press Enter: After typing the option number, press Enter. ISPF processes your selection and displays the appropriate panel or function.
• Option Field: Some Primary Option Menu layouts may include a specific "Option ===>" field where you enter the option number. In this case, type the number in that field and press Enter.
• Function Keys: Some ISPF configurations may allow using function keys as shortcuts for common options, though typing the number is the standard method.

Function Keys (PF Keys) in Navigation

Function keys (PF keys) are essential for ISPF navigation, providing quick access to common operations without typing commands.

Understanding Function Keys

Function keys are labeled PF1 through PF24 (though most terminals support PF1 through PF12 or PF24):

• Function Key Labels: Each panel displays function key labels at the bottom of the screen showing what each PF key does in that context. These labels change based on the panel you're using, so always check the labels to see available functions.
• Context-Sensitive: Function key assignments are context-sensitive—the same PF key may do different things on different panels. For example, PF3 typically exits or returns, but its exact behavior depends on the panel.
• Physical vs. Logical: Function keys can be mapped differently on different terminal emulators. Your terminal emulator may map physical keys to logical PF keys, and ISPF uses the logical PF key numbers. Understanding this mapping helps you use function keys effectively.
• Customization: You can customize function key assignments in ISPF settings (Option 0), allowing you to tailor function keys to your preferences and workflow.

Common Function Keys

While function key assignments vary by context, some common patterns exist:

• PF1 (Help): Displays context-sensitive help for the current panel or function. Help provides information about available commands, function keys, and usage instructions. PF1 is one of the most important keys for learning and reference.
• PF3 (End/Return): Typically exits the current panel and returns to the previous panel in the panel stack. PF3 is the primary navigation key for going back. Pressing PF3 multiple times navigates backward through your navigation history.
• PF7/PF8 (Scroll): In list panels and editors, PF7 scrolls backward (up) and PF8 scrolls forward (down). These keys are essential for navigating through lists, datasets, and other scrollable content.
• PF4 (Return): Similar to PF3, PF4 may return to a previous panel or perform return operations. The exact behavior depends on context and ISPF version.
• PF12 (Cancel): Often cancels the current operation or exits without saving. PF12 is useful for backing out of operations you don't want to complete.
• Other PF Keys: Other function keys perform context-specific operations. Always check the function key labels at the bottom of each panel to see what's available.

Using Function Keys Effectively

To use function keys effectively:

• Check Labels: Always look at the function key labels at the bottom of each panel to see what functions are available. Labels change based on context, so don't assume a key does the same thing everywhere.
• Learn Common Patterns: While assignments vary, common patterns exist (like PF3 for return, PF1 for help). Learning these patterns helps you navigate more efficiently.
• Use Help: Press PF1 to see help that explains function keys and their assignments. Help is context-sensitive and shows relevant information for your current panel.
• Customize When Needed: If you find yourself frequently needing functions that aren't easily accessible, consider customizing function keys in ISPF settings to match your workflow.

Panel Stack and Navigation History

Understanding the panel stack is crucial for effective ISPF navigation, as it determines how backward navigation works.

What is the Panel Stack?

The panel stack is ISPF's history of panels you've visited during your session:

• Navigation History: Each time you navigate to a new panel (by selecting a menu option, entering a command, or using a function key), that panel is added to the stack. The stack maintains the sequence of panels you've visited.
• Stack Order: The most recent panel is at the "top" of the stack, and earlier panels are "below" it. When you press PF3, you return to the panel that's just below the current one in the stack.
• Backward Navigation: Pressing PF3 (End) removes the current panel from the stack and displays the previous panel. You can press PF3 multiple times to navigate backward through your entire navigation history.
• Forward Navigation: Once you navigate backward, if you then select a new option, you create a new navigation path. You can't navigate "forward" through the stack—only backward using PF3.

How the Panel Stack Works

Understanding stack behavior helps you navigate predictably:

• Adding to Stack: When you select Option 2 (Edit) from the Primary Option Menu, the Edit Entry panel is added to the stack. The Primary Option Menu remains in the stack below it.
• Navigating Deeper: If you then open a file in the editor, the editor panel is added to the stack. Now the stack contains: Editor (top), Edit Entry, Primary Option Menu (bottom).
• Going Back: Pressing PF3 from the editor returns you to Edit Entry. Pressing PF3 again returns you to Primary Option Menu. Each PF3 removes one panel from the stack and shows the previous one.
• New Paths: If you're at Edit Entry and select a different option (like Option 1 for Browse), you create a new path. The Browse Entry panel is added to the stack, but the editor path is no longer accessible through simple backward navigation.

Navigation Patterns

Common navigation patterns help you work efficiently:

• Drill-Down Pattern: Select an option from a menu, which displays a submenu or input panel. Enter information or select another option, which displays another panel. Continue drilling down to reach your destination. Use PF3 to navigate back up the hierarchy.
• Hub-and-Spoke Pattern: Use the Primary Option Menu as a hub. Navigate to different functions (spokes) from the hub, and return to the hub using PF3. This pattern is common when you need to access multiple different functions.
• Linear Pattern: Navigate through a sequence of panels in order (like a wizard). Each panel leads to the next, and you can use PF3 to go back to previous steps if needed.
• Context Switching: Navigate to one function, perform work, return to the menu, navigate to another function, and so on. This pattern is common when working on multiple tasks.

Command Line Navigation

Command lines provide another navigation method, allowing you to enter commands that perform operations or navigate to functions.

Understanding Command Lines

Command lines are input areas where you type commands:

• Location: Command lines are typically at the top of panels, often labeled "Command ===>" or similar. Some panels may have command lines in other locations or multiple command lines.
• Purpose: Command lines accept text commands that perform operations. Commands vary by context—editor commands work in editors, utility commands work in utilities, and navigation commands work across panels.
• Entering Commands: Type the command text on the command line and press Enter to execute it. Commands are case-insensitive in most cases, though some may be case-sensitive depending on ISPF version and command type.
• Command Syntax: Commands follow specific syntax rules. Understanding syntax helps you use commands correctly. Help (PF1) provides command syntax information for available commands.

Common Navigation Commands

Some commands work across multiple panels for navigation:

• Return Commands: Commands like "=X" or "EXIT" may return you to the Primary Option Menu or exit ISPF, depending on context and ISPF version. These provide shortcuts for returning to the main menu.
• Option Selection: On menus, you can often type option numbers on the command line to select options. For example, typing 2 on the Primary Option Menu selects Option 2.
• Panel Names: Some ISPF versions allow you to navigate directly to panels by name using commands. This is an advanced feature that may not be available in all environments.
• Command Shortcuts: Some commands have shortcuts or abbreviations. Learning these shortcuts can speed up navigation and command entry.

Context-Specific Commands

Many commands are specific to certain contexts:

• Editor Commands: In the editor, commands like FIND, CHANGE, SAVE, CANCEL, TOP, BOTTOM perform editor operations. These commands only work in editor contexts.
• Utility Commands: In utilities, commands perform utility-specific operations like sorting, filtering, or dataset operations. Utility commands vary by utility type.
• List Commands: In list panels (like DSLIST or member lists), commands may filter, sort, or manipulate the list. Line commands in lists perform operations on specific items.
• Help for Commands: Use PF1 (Help) to see available commands for your current context. Help provides command syntax, descriptions, and usage examples.

Action Bars and Menu Options

Action bars provide additional navigation options beyond numbered menu options.

Understanding Action Bars

Action bars are horizontal menus typically at the top of panels:

• Location: Action bars appear at the top of panels, often below the title or as part of the panel header. They display as a row of options you can select.
• Selection Method: Action bar options are typically selected by typing the option name or abbreviation, or by using function keys or cursor positioning depending on your terminal and ISPF version.
• Additional Functions: Action bars provide access to functions beyond the main numbered options. They may include help, settings, navigation, or context-specific operations.
• Context-Sensitive: Action bar options change based on the panel you're viewing, providing relevant functions for each context.

Using Action Bars

To use action bars effectively:

• Check Available Options: Look at the action bar to see what options are available. Action bars typically show option names or abbreviations.
• Select Options: Select action bar options using the method appropriate for your terminal—typing the option name, using function keys, or cursor positioning. The exact method depends on your ISPF version and terminal configuration.
• Common Options: Common action bar options include Help, Settings, Exit, and context-specific functions. Learning common options helps you use action bars efficiently.
• Help for Action Bars: Use PF1 (Help) to see information about action bar options and how to use them. Help explains available action bar functions.

Navigation Best Practices

Following best practices helps you navigate ISPF efficiently and avoid getting lost:

• Understand the Panel Stack: Know that PF3 returns you to the previous panel in the stack. Understanding the stack helps you navigate predictably and know where you'll go when pressing PF3.
• Use Help Frequently: Press PF1 to access help whenever you're unsure about a panel, command, or function. Help is context-sensitive and provides relevant information. Don't hesitate to use help—it's there to assist you.
• Check Function Key Labels: Always look at function key labels at the bottom of panels to see what functions are available. Labels change based on context, so check them on each panel.
• Learn Common Patterns: While navigation varies, common patterns exist. Learn these patterns (like PF3 for return, numbered options for menus) to navigate more efficiently.
• Use the Primary Menu as a Hub: Use the Primary Option Menu as a central hub. Navigate to functions from the menu, and return to the menu when you need to switch to different functions.
• Navigate Backward When Needed: Don't be afraid to use PF3 to navigate backward if you go to the wrong place or need to return to a previous panel. The panel stack makes backward navigation easy.
• Read Panel Titles: Always check panel titles to understand what panel you're viewing. Titles help you orient yourself and understand the current context.
• Pay Attention to Instructions: Panels often include instructions or helpful text. Read these instructions—they explain how to use the panel and what options are available.
• Learn Command Syntax: As you use ISPF, learn command syntax for common operations. Understanding syntax helps you use commands effectively and avoid errors.
• Practice Navigation: Practice navigating through ISPF to become comfortable with the interface. The more you navigate, the more natural it becomes.

Common Navigation Scenarios

Understanding common scenarios helps you apply navigation skills in real-world situations.

Scenario 1: Opening a File for Editing

To open a file for editing:

• Start at Primary Menu: Begin at the ISPF Primary Option Menu.
• Select Option 2: Type 2 on the command line and press Enter to select Option 2 (Edit). The Edit Entry panel is displayed and added to the panel stack.
• Enter Dataset Information: On the Edit Entry panel, enter the dataset name and member name (if applicable) in the appropriate fields.
• Press Enter: Press Enter to open the file. The editor panel is displayed and added to the stack.
• Return When Done: When finished editing, use SAVE and exit, or press PF3 to return to Edit Entry. Press PF3 again to return to Primary Option Menu.

Scenario 2: Browsing a File

To browse a file:

• Start at Primary Menu: Begin at the ISPF Primary Option Menu.
• Select Option 1: Type 1 on the command line and press Enter to select Option 1 (Browse). The Browse Entry panel is displayed.
• Enter Dataset Information: Enter the dataset name and member name (if applicable) in the Browse Entry panel.
• Press Enter: Press Enter to open the file in Browse mode. The browse panel is displayed.
• Navigate and Search: Use PF7/PF8 to scroll, FIND to search, and other browse commands to examine the file.
• Return: Press PF3 to return to Browse Entry, then PF3 again to return to Primary Option Menu.

Scenario 3: Using Utilities

To use ISPF utilities:

• Start at Primary Menu: Begin at the ISPF Primary Option Menu.
• Select Option 3: Type 3 and press Enter to select Option 3 (Utilities). The Utilities menu is displayed.
• Select Utility: Select a specific utility (like 3.1 for Library Utility, 3.2 for Dataset Utility). The utility panel is displayed.
• Use Utility: Perform operations in the utility using its commands and options.
• Navigate Back: Use PF3 to return to the Utilities menu, then PF3 again to return to Primary Option Menu.

Scenario 4: Getting Help

To get help while navigating:

• Press PF1: From any panel, press PF1 to access context-sensitive help. Help is displayed in a new panel or overlay.
• Read Help Information: Help provides information about the current panel, available commands, function keys, and usage instructions.
• Navigate Help: Use PF7/PF8 to scroll through help if it's lengthy, or use help navigation options if available.
• Return from Help: Press PF3 to exit help and return to the panel you were viewing. Help doesn't change your position in the panel stack.

Explain Like I'm 5: ISPF Navigation

Think of ISPF navigation like navigating through a building with many rooms:

• The Primary Option Menu is like the main lobby of the building. It's where you start, and it has signs pointing to different areas (like "Room 1: Viewing", "Room 2: Editing", "Room 3: Utilities"). You choose which area to go to by telling the receptionist the room number.
• Selecting Options is like telling the receptionist "I want to go to Room 2" (typing 2 and pressing Enter). The receptionist shows you the way, and you go to that room. Each room might have more rooms inside it, creating a path through the building.
• The Panel Stack is like leaving breadcrumbs as you walk through the building. Each room you visit, you drop a breadcrumb. If you want to go back, you follow the breadcrumbs backward to return to previous rooms.
• PF3 (End) is like following your breadcrumbs backward. Each time you press PF3, you go back one room (following one breadcrumb). If you press PF3 multiple times, you keep going back through all the rooms you visited.
• Function Keys are like special buttons in each room. Each room has different buttons that do different things. The buttons are labeled so you know what they do. For example, there's always a "Help" button (PF1) that explains what the room is for, and usually a "Go Back" button (PF3).
• Commands are like speaking special words to the room. You say a command (type it), and the room does something—like "show me the top" or "find this word" or "go to line 100".

So navigating ISPF is like exploring a building where you can go to different rooms (panels), use special buttons (function keys) and words (commands) to do things, and always follow your breadcrumbs (PF3) to go back to where you came from!

Practice Exercises

Complete these exercises to reinforce your understanding of ISPF navigation:

Exercise 1: Basic Menu Navigation

Practice basic menu navigation: start at the Primary Option Menu, select different options (like Option 1, Option 2, Option 3), observe how panels change, and use PF3 to navigate back. Practice navigating forward and backward through the panel stack until you're comfortable with the navigation flow.

Exercise 2: Function Key Exploration

Explore function keys: on different panels, check the function key labels at the bottom, press PF1 to see help about function keys, and practice using common function keys like PF3, PF7, PF8. Document what each function key does on different panels to understand context-sensitive assignments.

Exercise 3: Panel Stack Navigation

Practice panel stack navigation: navigate through a sequence of panels (like Primary Menu → Edit → Editor), then use PF3 multiple times to navigate backward. Observe how each PF3 returns you to the previous panel. Practice this with different navigation paths to understand stack behavior.

Exercise 4: Command Line Usage

Practice using command lines: on different panels, locate command lines, try entering commands (like option numbers on menus, or editor commands in the editor), and observe command behavior. Use PF1 to get help about available commands and their syntax.

Exercise 5: Complete Navigation Workflows

Practice complete workflows: navigate from the Primary Menu to a function (like editing a file), perform operations, navigate to another function (like browsing a file), and return to the menu. Practice switching between different functions and returning to the menu as a hub. This helps you understand real-world navigation patterns.

Related Concepts