ISPF Primary Option Menu

The ISPF Primary Option Menu is the central navigation hub of ISPF. When you first enter ISPF (by typing "ISPF" at the TSO READY prompt), the Primary Option Menu appears, presenting you with numbered options that provide access to all ISPF functions. Understanding this menu is essential for effective mainframe work, as it's your starting point for editing files, managing datasets, submitting jobs, and customizing your environment.

The Primary Option Menu displays options numbered 0 through 9 (and sometimes additional options), each providing access to different ISPF capabilities. The menu is designed to be intuitive, with commonly used functions easily accessible. Learning what each option does and how to navigate the menu efficiently is fundamental to productive mainframe work.

Understanding the Menu Layout

The ISPF Primary Option Menu has a specific layout and structure. Understanding this layout helps you navigate efficiently and know what to expect when you see the menu.

Menu Structure

The Primary Option Menu typically displays:

• Menu Title: The top of the screen shows "ISPF PRIMARY OPTION MENU" or similar, identifying this as the main ISPF menu.
• Option List: The main body of the menu shows numbered options (0-9) with brief descriptions of what each option does. Options are typically displayed in a two-column format or a single-column list, depending on your terminal size and ISPF configuration.
• Command Line: At the bottom of the screen, there's a command line (often labeled "Option >>") where you type the number or letter of the option you want to select.
• Function Key Labels: The bottom of the screen may show function key labels indicating what each function key does. Common labels include PF1 (Help), PF3 (Exit), and others.
• System Information: The menu may display system information such as your userid, the current date and time, or other context information.

Menu Appearance Variations

The exact appearance of the Primary Option Menu can vary based on:

• ISPF Version: Different versions of ISPF may have slightly different menu layouts or option arrangements.
• Customization: Your organization may have customized the menu, adding options, modifying descriptions, or changing the layout.
• Terminal Size: The menu adapts to your terminal size, displaying options in one or two columns depending on available screen space.
• Color Settings: If your terminal supports color, the menu may use colors to highlight different elements or options.

Despite these variations, the core structure and functionality remain consistent across different ISPF installations.

ISPF Primary Option Menu Options

Each option on the Primary Option Menu provides access to specific ISPF functions. Understanding what each option does is crucial for effective navigation and productivity. Here's a detailed explanation of the standard options:

Option 0: Settings

Option 0 (Settings) allows you to customize your ISPF environment and personal preferences. This is where you configure how ISPF behaves and appears for your sessions.

What Option 0 provides:

• Terminal Characteristics: Configure your terminal settings including screen size, character encoding, and display options. These settings ensure your terminal emulator works correctly with ISPF.
• Function Key Assignments: Customize what each function key (PF1-PF24) does. You can assign commands or actions to function keys to speed up your work.
• Editor Preferences: Set default editor behavior including tab settings, auto-indent, column markers, and editing modes. These preferences affect how the ISPF Editor behaves when you edit files.
• Color Schemes: If your terminal supports color, you can customize color schemes for different ISPF components, making the interface more visually appealing and easier to navigate.
• List Settings: Configure how lists (like member lists or dataset lists) are displayed, including sort order, display format, and default actions.
• Profile Management: View and manage your ISPF profile settings, which are saved and persist across sessions.

When to use Option 0: Use Option 0 when you want to personalize your ISPF environment, change function key assignments, adjust editor behavior, or modify display settings. It's typically one of the first things you configure when you start using ISPF regularly.

Option 1: View (Browse)

Option 1 (View or Browse) opens the ISPF Browse function, which allows you to view the contents of datasets in read-only mode. Browse is useful for examining files without the risk of accidentally modifying them.

What Option 1 provides:

• Read-Only File Viewing: Display dataset contents without the ability to modify them. This is safer than Edit mode when you only need to view information.
• Search Capabilities: Search for text within browsed files, making it easy to find specific information in large files.
• Scrolling and Navigation: Navigate through files using function keys to scroll up, down, left, and right through file contents.
• Multiple File Support: Browse multiple files or members, switching between them as needed.
• Job Output Viewing: View spooled job output from batch jobs, including system messages, program output, and error messages.

When to use Option 1: Use Option 1 when you need to view file contents, read job output, examine reference materials, or check dataset contents without making changes. Browse mode is faster and safer than Edit mode for viewing operations.

Option 2: Edit

Option 2 (Edit) opens the ISPF Editor, which is one of the most frequently used ISPF functions. The editor allows you to create, modify, and save text-based datasets including source code, JCL, data files, and documentation.

What Option 2 provides:

• Full Editing Capabilities: Create new files, modify existing files, insert and delete lines, and make changes to dataset contents.
• Line Commands: Use single-character commands in the line number area to perform operations on specific lines (I for insert, D for delete, R for repeat, M for move, C for copy, etc.).
• Primary Commands: Enter commands on the command line to perform operations on entire files or large sections (FIND, CHANGE, COPY, MOVE, SAVE, CANCEL, etc.).
• Search and Replace: Powerful search capabilities including single searches, global replacements, pattern matching, and column-specific searches.
• Block Operations: Move, copy, or manipulate blocks of lines efficiently.
• Member Management: When editing partitioned datasets (PDS), manage individual members, create new members, and navigate between members.
• Split-Screen Editing: Edit two files simultaneously or view two parts of the same file side-by-side.

When to use Option 2: Use Option 2 whenever you need to create or modify files. This includes editing source code (COBOL, PL/I, Assembler, etc.), creating or modifying JCL, updating data files, writing documentation, or making any changes to text-based datasets.

Option 3: Utilities

Option 3 (Utilities) provides access to a comprehensive set of utility functions for dataset and library management. Utilities help you perform common operations like copying files, managing library members, allocating datasets, and searching for datasets.

What Option 3 provides:

• Library Utility (3.1): Manage partitioned datasets (PDS) and PDSE libraries. List members, browse members, edit members, copy members, delete members, rename members, and perform other member-level operations.
• Data Set Utility (3.2): Allocate new datasets, delete datasets, rename datasets, catalog and uncatalog datasets, and manage Generation Data Groups (GDG). This utility handles dataset-level operations.
• Move/Copy Utility (3.3): Copy or move datasets and members between locations. This utility is essential for backing up files, reorganizing datasets, and duplicating data.
• Data Set List Utility (3.4): Search for datasets using patterns, display dataset lists, view VTOC information, and perform dataset searches. This helps you find datasets when you don't know their exact names.
• Other Utilities: Additional utility functions may be available depending on your ISPF installation, including compression utilities, print utilities, and specialized management tools.

When to use Option 3: Use Option 3 for dataset management tasks like creating new datasets, deleting old datasets, copying files, managing library members, searching for datasets, or performing bulk operations on multiple datasets or members.

Option 4: Foreground

Option 4 (Foreground) allows you to execute programs interactively in the foreground, meaning the program runs in your current terminal session and you can interact with it in real-time.

What Option 4 provides:

• Interactive Program Execution: Run programs that require user interaction, such as interactive utilities, test programs, or programs that prompt for input.
• Real-Time Output: See program output immediately as the program executes, rather than waiting for batch job completion.
• Language Processors: Execute language processing programs interactively, such as compilers or interpreters that can run in foreground mode.
• Debugging Support: Run programs in foreground mode for debugging purposes, allowing you to see errors and output immediately.

When to use Option 4: Use Option 4 when you need to run programs interactively, test programs with immediate feedback, run interactive utilities, or execute programs that require user input during execution. Note that foreground execution uses your terminal session, so the program must complete before you can do other work.

Option 5: Batch

Option 5 (Batch) provides access to batch job submission and management. This is where you create, submit, and manage Job Control Language (JCL) jobs that run in the background.

What Option 5 provides:

• JCL Editing and Submission: Create and edit JCL files, then submit them for batch execution. Jobs run in the background, allowing you to continue working while they execute.
• Job Management: View submitted jobs, check job status, cancel jobs, and manage your batch job queue.
• Job Output Access: Access job output after jobs complete, view system messages, program output, and error messages from batch jobs.
• JCL Templates: Access JCL templates and examples to help you create proper JCL for common tasks.
• Job Scheduling: Some systems provide job scheduling capabilities through this option.

When to use Option 5: Use Option 5 when you need to submit batch jobs for compilation, program execution, data processing, or any operation that should run in the background. Batch jobs are essential for production work, long-running processes, and operations that don't require interactive input.

Option 6: Command

Option 6 (Command) allows you to enter TSO commands directly while remaining within the ISPF environment. This provides access to TSO command-line functionality without leaving ISPF.

What Option 6 provides:

• TSO Command Execution: Execute any TSO command from within ISPF, including dataset allocation, system information commands, and utility commands.
• Command History: Access and reuse previously entered commands, making it easy to repeat operations.
• Command Output: View command output within ISPF, with the ability to scroll through results and interact with output.
• Integrated Environment: Execute TSO commands without leaving ISPF, maintaining your place in menus and panels.

When to use Option 6: Use Option 6 when you need to execute TSO commands that don't have ISPF menu equivalents, perform quick command-line operations, or access TSO functionality while working within ISPF. This is useful for operations that are faster via command line or for commands not available through ISPF menus.

Option 7: Dialog Test

Option 7 (Dialog Test) is a development and testing utility that allows you to test ISPF panels, messages, and dialog components before using them in production applications.

What Option 7 provides:

• Panel Testing: Display and test ISPF panels to verify they appear correctly and function as intended.
• Message Testing: Test ISPF messages to ensure they display properly with correct formatting and content.
• Dialog Validation: Validate dialog definitions and test dialog flows before deploying custom ISPF applications.
• Development Support: Essential tool for ISPF application developers who create custom panels and dialogs.

When to use Option 7: Use Option 7 primarily if you're developing ISPF applications, creating custom panels, or testing dialog components. Most end users don't need this option unless they're involved in ISPF development work.

Option 8: IBM Products

Option 8 (IBM Products) provides access to other IBM software products that are integrated with ISPF. This option serves as a gateway to additional IBM mainframe tools and utilities.

What Option 8 provides:

• Product Access: Access menus and interfaces for other IBM products installed on your system, such as database management systems, development tools, or specialized utilities.
• Integrated Tools: Use IBM tools that integrate with ISPF, providing a consistent interface across different IBM products.
• Product-Specific Functions: Access functions and utilities specific to installed IBM products that aren't part of core ISPF.

When to use Option 8: Use Option 8 when you need to access other IBM products that are integrated with ISPF. The specific products available depend on what's installed in your environment. This option may not be available or may show different options depending on your system configuration.

Option 9: SCLM (Software Configuration and Library Manager)

Option 9 (SCLM) provides access to IBM's Software Configuration and Library Manager, which is a version control and configuration management system for mainframe development.

What Option 9 provides:

• Version Control: Manage versions of source code, track changes, and maintain version history for development projects.
• Configuration Management: Manage software configurations, track which versions of components work together, and maintain build configurations.
• Library Management: Organize and manage source code libraries, object libraries, and load libraries in a structured way.
• Build Management: Manage software builds, track build dependencies, and coordinate compilation and linkage processes.
• Change Tracking: Track changes to source code, associate changes with requirements or issues, and maintain audit trails.

When to use Option 9: Use Option 9 if your organization uses SCLM for version control and configuration management. SCLM is typically used in larger development environments where version control and configuration management are important. If your organization doesn't use SCLM, this option may not be available or functional.

Additional Options

Depending on your ISPF installation and organizational customizations, you may see additional options beyond 0-9. These might include:

• Option 10 (Workplace): Some ISPF versions include a Workplace option that provides an object-oriented interface to datasets and volumes, offering alternative ways to navigate and manage mainframe resources.
• Custom Options: Your organization may have added custom options for organization-specific tools, applications, or utilities.
• Product-Specific Options: Additional options for third-party products or tools that integrate with ISPF.

The availability of additional options depends on your specific ISPF installation and organizational customizations.

Navigating the Primary Option Menu

Efficient navigation of the Primary Option Menu is essential for productive mainframe work. Understanding how to select options and use function keys speeds up your workflow.

Selecting Options

To select an option from the Primary Option Menu:

• Type the Option Number: Move your cursor to the command line (usually at the bottom of the screen, labeled "Option >>") and type the number of the option you want (0, 1, 2, etc.).
• Press Enter: After typing the option number, press Enter. ISPF processes your selection and displays the appropriate panel or function.
• Use Function Keys: Some options may have associated function keys for quick access, though the standard method is typing the option number.

For example, to open the editor, you would type "2" on the command line and press Enter. ISPF then displays the Edit Entry panel where you specify which file you want to edit.

Function Keys on the Primary Option Menu

Common function keys available on the Primary Option Menu include:

• PF1 (Help): Displays help information about the Primary Option Menu, explaining what each option does and how to use the menu.
• PF3 (Exit): Exits ISPF and returns you to the TSO READY prompt. This ends your ISPF session.
• PF7/PF8 (Scroll): If the menu is long or doesn't fit on one screen, these keys scroll up (PF7) or down (PF8) to show additional options or information.

Function key assignments can be customized through Option 0 (Settings), so your specific assignments may differ.

Returning to the Primary Option Menu

You can return to the Primary Option Menu from most ISPF panels by:

• Pressing PF3: Pressing PF3 (Exit) from most ISPF panels returns you to the previous menu level. Pressing PF3 multiple times eventually returns you to the Primary Option Menu.
• Entering "=": On many ISPF panels, typing "=" on the command line and pressing Enter returns you to the previous menu level.
• Using Menu Navigation: Some panels have explicit menu options or function keys that return you to the Primary Option Menu.

The Primary Option Menu serves as a home base that you return to frequently as you navigate through ISPF functions.

Customizing the Primary Option Menu

The ISPF Primary Option Menu can be customized to add options, modify existing options, change descriptions, or reorganize the menu layout. Customization is typically done by system administrators or advanced users who understand ISPF panel definitions.

Understanding Menu Customization

The Primary Option Menu is defined by a panel named ISR@PRIM (or similar, depending on your ISPF version). This panel is stored in an ISPF panel library and defines the menu's appearance, options, and behavior. To customize the menu, you need to:

• Locate the Panel: Find the ISR@PRIM panel in your ISPF panel library. The panel library location depends on your ISPF installation.
• Edit the Panel: Use ISPF Edit to modify the panel definition. Panel definitions use ISPF Panel Definition Language, which specifies layout, text, fields, and actions.
• Modify Options: Add new options, change option descriptions, modify option numbers, or reorganize the menu layout according to your needs.
• Test the Changes: Use Option 7 (Dialog Test) to test your modified menu before making it the default.
• Deploy the Changes: Once tested, deploy the modified panel to make it the active Primary Option Menu.

Common Customization Scenarios

Organizations commonly customize the Primary Option Menu for:

• Adding Custom Options: Add organization-specific options that provide quick access to custom applications, tools, or frequently used functions.
• Modifying Descriptions: Change option descriptions to be more specific to your organization's terminology or to provide additional guidance.
• Reorganizing Options: Rearrange options to put the most frequently used options in more prominent positions or to group related options together.
• Removing Options: Hide or remove options that aren't used in your environment to simplify the menu.
• Adding Help Text: Include additional help text or instructions specific to your organization's procedures or requirements.

Customization Considerations

Before customizing the Primary Option Menu, consider:

• User Impact: Customizations affect all users, so changes should be carefully planned and communicated. Users familiar with the standard menu may be confused by significant changes.
• Maintenance: Customized menus require maintenance when ISPF is upgraded, as IBM may change the standard menu. Customizations may need to be reapplied or updated after upgrades.
• Documentation: Custom menus should be documented so users understand what options are available and how to use them. Training may be needed if customizations significantly change the menu.
• Backup: Always backup the original menu panel before making changes, so you can restore it if needed.
• Testing: Thoroughly test customized menus in a test environment before deploying to production to ensure they work correctly and don't break existing workflows.

Personal Customization vs. System Customization

It's important to distinguish between personal customization and system-wide customization:

• System Customization: Changes to the ISR@PRIM panel affect all users system-wide. These changes are typically made by system administrators and require appropriate authorization.
• Personal Customization: Individual users typically cannot customize the Primary Option Menu directly, as it's a system-level component. However, users can customize their ISPF profile (Option 0) to personalize their experience within the constraints of the system menu.

Most users work with the system-provided or organization-customized Primary Option Menu and personalize their experience through ISPF settings rather than menu modifications.

Best Practices for Using the Primary Option Menu

Following best practices helps you use the Primary Option Menu efficiently and effectively:

• Learn the Standard Options: Familiarize yourself with what options 0-9 do so you can quickly navigate to the functions you need. Memorizing common options speeds up your work.
• Use the Command Line: Type option numbers directly on the command line rather than using the mouse or arrow keys. This is faster and more efficient.
• Use PF3 to Navigate Back: Remember that PF3 returns you to previous menu levels. Use it to navigate back through menus efficiently.
• Customize Settings First: When you first start using ISPF, spend time in Option 0 (Settings) to configure your environment. Proper customization improves productivity.
• Use Help: Press PF1 for help if you're unsure what an option does or how to use a function. ISPF help is context-sensitive and provides useful information.
• Learn Your Organization's Customizations: If your organization has customized the menu, learn what custom options are available and how to use them. Custom options may provide shortcuts to frequently used functions.
• Return to Menu Regularly: Use the Primary Option Menu as a navigation hub. Return to it when switching between different types of work or when you're unsure where to find a function.

Explain Like I'm 5: The ISPF Primary Option Menu

Imagine the ISPF Primary Option Menu is like a big control panel with numbered buttons:

• Button 0 is like the "Settings" button on a remote control. It lets you change how things look and work, like adjusting the volume or changing the channel layout.
• Button 1 is like a "Look" button. It lets you look at files and read them, but you can't change anything—just like looking at a picture in a frame.
• Button 2 is like a "Write" button. It opens a notebook where you can write, erase, and change things. This is where you do most of your work creating and editing files.
• Button 3 is like a "Toolbox" button. It gives you lots of tools for organizing files, copying things, deleting old stuff, and finding files when you can't remember where you put them.
• Button 5 is like a "Do Work in Background" button. You tell the computer what job to do, and it does it while you can do other things, like setting a timer that works while you play.
• Button 6 is like a "Special Commands" button. It lets you type special commands that do specific things, like magic words that make things happen.

So the Primary Option Menu is like a big remote control with numbered buttons, and each button takes you to a different room (or function) where you can do different types of work!

Practice Exercises

Complete these exercises to reinforce your understanding of the ISPF Primary Option Menu:

Exercise 1: Menu Navigation Practice

Practice navigating the Primary Option Menu by selecting each option (0-9) and exploring what each one does. Document what you see when you select each option, what functions are available, and how to return to the Primary Option Menu from each option. Create a navigation map showing how to get to common functions.

Exercise 2: Option Functionality Documentation

For each option (0-9), document its primary purpose, when you would use it, and what functions it provides access to. Include examples of specific tasks you would perform using each option. This documentation will serve as a personal reference guide.

Exercise 3: Customization Research

Research whether your organization has customized the Primary Option Menu. If customizations exist, document what custom options are available, what they do, and how to use them. If no customizations exist, identify what customizations might be useful for your work and document your ideas.

Exercise 4: Navigation Efficiency

Time yourself performing common tasks using the Primary Option Menu. Practice navigating to frequently used options (like Edit, Browse, and Utilities) and measure how quickly you can access them. Work on improving your navigation speed through practice and memorization of option numbers.

Exercise 5: Help System Exploration

Use the PF1 (Help) function on the Primary Option Menu to explore the help system. Document what help information is available, how to navigate help, and what information is most useful. Practice using help to answer questions about ISPF functions.

Related Concepts