How to request a list

Use the search panels or the RMM TSO SEARCH subcommands to request that DFSMSrmm display a list of resources. You can request lists of shelf locations, volumes, software products, data sets, and vital record specifications. See Using RMM TSO subcommands for more information on the SEARCH subcommands.

DFSMSrmm allows you to specify generic names or numbers as search criteria. Therefore you can also use the search panels to get the specific name or number of a resource to request detailed information about it through the Display panels. For example, if all you know is a volume's owner you can use the search panels to request a list of all volumes owned by that owner. DFSMSrmm includes the volume serial number for each volume in the list, which you can then use to request detailed information about a specific volume on the Volume Display panel.

To request a list of resources defined to DFSMSrmm:

Select a Search panel. Table 1 describes how to select the various DFSMSrmm ISPF dialog search panels.

Table 1. How to display search panels
To display a search panel for:	Do one of the following:	And DFSMSrmm displays:
Shelf locations	Select option 5 (RACKS) on the Librarian Menu, followed by option 4 (SEARCH) on the DFSMSrmm Rack and Bin Menu. Select option 2 (RACKS) on the Command Menu, followed by option 4 (SEARCH) on the Rack and Bin Menu.	The DFSMSrmm Rack or Bin search panel.
Volumes	Select option 1 (VOLUME) on the Librarian Menu, followed by option 5 (SEARCH) on the Volume Menu. Select option 1 (VOLUME) on the Administrator Menu, followed by option 5 (SEARCH) on the Volume Menu. Select option 1 (VOLUME) on the User Menu.	The DFSMSrmm Volume search panel.
Software products	Select option 3 (PRODUCT) on the Librarian Menu. Select option 5 (PRODUCT) on the Command Menu, followed by option 5 (SEARCH) on the Product Menu. Select option 3 (PRODUCTS) on the User Menu.	The DFSMSrmm Product search panel.
Data sets	Select option 3 (DATA SET) on the Command Menu, followed by option 5 (SEARCH) on the Data Set Search Menu. Select option 2 (DATA SET) on the User Menu.	The DFSMSrmm Data Set search panel.
Vital record specifications	Select option 3 (VRS) on the Administrator Menu, followed by option 5 (SEARCH) on the Vital Record Specification Menu. Select option 6 (VRS) on the Command Menu, followed by option 5 (SEARCH) on the Vital Record Specification Menu.	The DFSMSrmm VRSs search panel.

Press ENTER.
Specify the search criteria you want DFSMSrmm to use to create the list. Press PF1 for field-specific help.
For example, to create a list of all empty shelf locations in the removable media library, use the Rack and Bin Search panel. Specify a status of EMPTY, a location of LIBRARY, and leave the rack number field blank.

You can specify either specific or generic names or numbers on the search panels. This applies to rack and bin numbers, volume serial numbers, data set names, location names, and software product number and names.

You can also specify how many entries you want DFSMSrmm to include in the list by entering a value in the Limit field.

To display pool IDs or media names for pools that are defined for your installation, type CONTROL VLPOOLS on the command or option line of any DFSMSrmm panel. You can also use the LISTCONTROL subcommand with the VLPOOL operand.

To display media names for storage locations that are defined for your installation, type CONTROL LOCDEF on the command or option line of any DFSMSrmm panel. You can also use the LISTCONTROL subcommand with the LOCDEF operand.
Press ENTER to build your list.

You might have to scroll to the right on some lists to see all the information. After DFSMSrmm builds your list, you can sort it using a different sort order. See How to sort a list for more information. You can also issue line operators against list items to access further information recorded by DFSMSrmm, or to request additional function. See How to Use Line Operators for information on how to issue line operators against list entries.

Sometimes when you use generic names or numbers as search criteria, the resulting list of resources exceeds the storage space available to DFSMSrmm. DFSMSrmm returns as many list items as possible, and a message, such as this example:

There is not enough storage available to list all the volumes.

To avoid problems with system resources, DFSMSrmm exploits the CONTINUE processing of the SEARCH subcommands. This is done transparently by the DFSMSrmm ISPF dialog when you specify a limit value of '*', or you specify a limit value larger than 2000. The DFSMSrmm ISPF dialog issues multiple commands and returns a resource list containing the results. If there are still problems with system resources, you can do one of the following to obtain all available records from a search:

When you use the CLIST option you can avoid the creation of a search results list.
Check to see if the TSO profile is set to use VARSTORAGE(HIGH).
Press PF3 to return to the panel where you specified the search criteria. Specify a generic volume serial number that limits the number of volumes to be searched.
For example, if you initially specified these values on the Volume Search panel:
```
Volume      ===>11*
Owner       ===>*
Limit       ===>*
```
you can divide the search by issuing several search requests by using a more specific volume serial number mask each time.
For example, you could replace the generic volume serial number, 11* with three generic volume serial numbers VOLUME(111*), VOLUME(112*), and VOLUME(113*).
Use one of the RMM TSO SEARCH subcommands instead of a panel to request the search. The results are in linemode messages.
If you prefer to use an RMM search panel, you can use the SAVE ON panel command to create TSO SEARCH subcommands that can be processed in batch mode. See Getting started with DFSMSrmm for information on the SAVE ON command.