Installing the FDR Dialogs

New installations

Although you can continue to use the ABRALLOC function shown in Invoking-the-ABR-Install-ISPF-Dialog to invoke the FDR dialogs during testing, you may want to install them for use by any user while you complete your testing, to simplify testing procedures and involve a larger group of users in testing. If not, you can perform this step after testing is complete.

Existing installations

If you have a previous version of the FDR dialogs in production, you will want to continue to use the ABRALLOC function shown in Invoking-the-ABR-Install-ISPF-Dialog to invoke the new dialogs during testing. Use the procedures below to install the new dialogs when the new version is installed for production.

You may invoke the FDR ISPF dialogs by adding an option on any ISPF menu of your choosing, and/or by entering an ISPF command on any ISPF panel. For the menu option, you can either have the FDR dialog libraries allocated at TSO log in time, or have them dynamically allocated on demand.

Adding the FDR option to an ISPF menu

You may add FDR as an option on the ISPF main menu or any menu of your choice. In the FDRSAMP data set, there are some sample panels showing how to add ABR to the ISPF main menu (ISR@PRIM):

• FDR@V5X - for ISPF V5.x main menu (CUA) using pre-allocated libraries.
• FDR@V5XL - for ISPF V5.x main menu (CUA) using dynamically allocated libraries.
• FDR@V6X - for ISPF V6.x main menu (CUA) using pre-allocated libraries.
• FDR@V6XL - for ISPF V6.x main menu (CUA) using dynamically allocated libraries.

Use the V6.x examples for the ISPF distributed with z/OS.

You can make similar modifications to any other ISPF menu following the instructions in FDR@V6X or FDR@V6XL.

Adding the FDR dialog libraries to the log in procedure

If you choose to have the FDR Dialog libraries allocated by the TSO log in procedure, instead of dynamically allocated on demand, then the FDR dialog libraries should be allocated as the first library of the concatenation of the following ddnames (the default data set name of each library is shown; if you have changed the names during installation, substitute your names):

SYSPROC - TSO command procedure libraries (CLISTs), add “high_level_qualifier.FDRCLIB”.

ISPPLIB - ISPF dialog panel libraries, add “high_level_qualifier.FDRLPIB”.

ISPMLIB - ISPF dialog message libraries, add “high_level_qualifier.FDRMLIB”.

ISPSLIB - ISPF dialog skeleton libraries, add “high_level_qualifier.FDRSLIB”.

ISPLLIB - ISPF TASKLIB library, add “high_level_qualifier.FDRLINK”. If your TSO log in proc contains a STEPLIB DD statement but does not contain an ISPLLIB DD statement, then add the FDR  load module library to the STEPLIB DD statement concatenation. However, there is no need to allocate the FDR load module library in the log in procedure if it has been placed in the system link list (LNKLST).

Panel A.I.11 – add FDR commands to an ISPF command table

You can add FDR commands to an ISPF command table, so that users are able to invoke the ABR dialogs and services by entering the command name (followed by any applicable parameters) on the command line of almost any ISPF panel. If you wish to do so, then from the FDR  Installation Options Menu (usually accessed by A.I), enter 11 (ADDISPF) to display this panel.

Add FDR Commands to ISPF Command Table – Panel A.I.11

How Are the FDR dialog libraries allocated?

Specifies whether the FDR dialog libraries are allocated at TSO log in time, by the log in proc or log in CLIST, or are allocated on demand, by the ABRALLOC CLIST.

ISPF table library to update

Specifies the name of a table library, allocated to the ISPTLIB ddname concatenation, where the command table is updated. The default is that the specified command table is updated in the first library in which it exists in the ISPTLIB concatenation for this TSO user id.

ISPF command table to update: application ID

Specifies the ISPF command table name prefix (omit the command table name suffix, CMDS). The default is ISP, for the ISPF system command table ISPCMDS. For ISPF version 4.2 or higher, it is preferable in most cases to specify the site command table, so that the FDR commands will not need to be re-installed for new releases of ISPF. The installation specifies the prefix for the site command table in the ISPF configuration table ISRCONFG, as documented in the IBM manual ISPF Planning and Customizing or equivalent. The Help for panel A.I.11 shows the prefix for the site command table at your installation, and whether the site command table is searched before or after ISPCMDS.

Sel

Specifies whether the entry is selected to be added: “S” or blank.

Command

Specifies the command name to be added to the command table.

Truncate

Optionally specifies the number of characters for abbreviation; the minimum value is 2.

Type

Specifies one of the following:

PRIM

if the command invokes the FDR primary options panel.

SRS

if the command invokes an SRS data set search.

S1

if the command invokes an SRS data set selection criteria.

S2

if the command invokes an SRS saved data set list.

S3

if the command invokes an SRS saved volume selection criteria.

S4

if the command invokes an SRS saved volume selection.

FF

if the command invokes an SRS function command.

Description

Optional command description.

The FDR ISPF commands (except for FDR, SRS, S1, S2, S3, and S4) invoke FDRSRS function commands. Each SRS function command contains a set of predefined parameters, which are fully customizable. The user may also create new SRS function commands as described in FDRSRS-ISPF-Fast-Paths-and-Commands.

Restricting the use of the installation panels

Since you probably want only certain users to be able to execute the FDR Installation dialogs, you can edit member ABRINPRI in the FDR Dialog CLIST library. ABRINPRI contains instructions for restricting user access.

To insure that users do not copy and modify ABRINPRI or other FDR CLISTs, you may be able to use your security system to grant execute-only access to the FDR Dialog CLIST library for unauthorized users.

Change data set names panel

The names of the FDR libraries that are used in the ISPF dialogs may be changed by using the DSNAMES dialog. From the FDR Installation Options Menu (usually accessed by A.I), enter 1A (DSNAMES) to display this panel:

Change Data Set Names

Panel A.I.1A change data set names used by dialogs

If the DSNAMES dialog is not available because the FDR data set names have already been renamed, invoke the CLIST directly, by entering the TSO command:

in TSO READY mode or in ISPF option 6.