Enabling ISPF data set list (DSLIST) support

To enable direct entry into the DFSMSrmm ISPF dialog from the ISPF Data Set List Utility, use the ISPF Configuration Utility to update the ISPF Configuration Table. To enable this function, select the Enable RM/Tape Commands option. For details of how to use the ISPF Configuration Utility, refer to z/OS ISPF Planning and Customizing. Figure 1 shows that the data set list support is enabled, as well as showing the default values for the RM/Tape Command EDGRPD34 and Command APPLID EDG. You do not need to change these values.

Figure 1. Enabling ISPF data set list (DSLIST) support

ISPPMOD3              Modify PDF Configuration Settings
Command ===>
                                                                   More:   -
  When to use COPY or COPYMOD
  2  1. Use COPY if the target block size is equal to or greater than the
        source block size, COPYMOD otherwise
     2. Use COPY if the target block size is equal to the source block size,
        COPYMOD otherwise
     3. Always use COPYMOD

DSLIST Removable Media Settings
  Enter "/" to select option
  /  Enable RM/Tape Commands

  RM/Tape Command  . . %EDGRPD34
  Command APPLID . . . EDG

Other PDF Settings
  Default PDF Unit . . . . . . . . . . . . SYSALLDA
  Volume for Migrated Data Sets  . . . . . MIGRAT
  Delete Command for Migrated Data Sets    HDELETE
  Allowed Allocation Units . . . . . . . . ANY
  Maximum IEBCOPY Return Code  . . . . . . 0

The line commands supported by DFSMSrmm are I, S, M, and D.

I - Displays a search results list showing all data sets in the multivolume set for the selected data set.
S - Displays the individual data set details. DFSMSrmm determines the first file on the selected volume that matches the selected data set. If other data sets of the same name exist on the volume, the wrong details could be displayed. In that case, use the M line command and then the DFSMSrmm I line command from that results list.
M - Displays a search results list showing all data sets defined to DFSMSrmm that match the selected data set name.
D - Releases the volume. If the volume is part of a multivolume set, there is the option to release all volumes in the set.

There is additional capability provided in the EDGRMAIN exec to customize how the ISPF Data Set List line commands are handled by DFSMSrmm. You can apply any of the DFSMSrmm results to any of the line commands, as well as these options:

Display the volume details for the selected entry.
Display the search results for all the volumes in the same set as the selected entry.
Display a search results list showing all data sets on the same volume as the selected data set.

Once you see the DFSMSrmm results, you are in the DFSMSrmm ISPF dialog and can use any of the available functions including fast path commands.

You can use the DFSMSrmm support either by enabling the support and using the DSLIST line commands, or you can use the EDGRPD34 exec as a command directly in the DSLIST results or in the ISMF data set and mountable tape volumes lists results. For example:

EDGRPD34 I

This command executes the DSLIST I line command. You can use one of the exec aliases (RMMI or TI), or you can rename it to any value you wish. However you choose to run the command outside of the ISPF DSLIST built-in capability, the exec expects that optionally the first parameter might be a line command, such as I, S, M or D. If you do not specify an optional line command:

When EDGRPD34 is used, the default line command is "I".
When any other exec or alias name is used, the exec or alias name is used as the line command.

You can also customize the EDGRPD34 exec to handle your selected ISPF environment. If you plan to use ISPF LIBDEF, you must edit EDGRPD34 to use EDGRMLIB instead of EDGRMAIN to enter the DFSMSrmm dialog. Update this line in the exec:

UseIspfLibdef = false           /* <<   true or false                */

When you use ISPF LIBDEF, whether for normal entry to the DFSMSrmm dialog or from the ISPF DSLIST utility, you must copy, or make available, the EDGRMLIB and the EDGRPD34 execs in an exec library normally available to ISPF users.