Specifying a Library data set

Many FM/IMS panels require you to specify a PDS Library that you want the function to use.

To specify a data set, follow these steps:

1. In the Data set name field, enter a data set name or a data set name pattern. In the case of a copybook library, this can be the name of a CA-Panvalet library. When there is a Member field immediately below the Data set name field, the name may include a member name or member name pattern in parentheses. If the member is specified in the Data set name field, the associated Member field must be left blank.

   If you do not enclose the data set name in quotation marks, then the TSO prefix for your user ID is used as the high-level qualifier.

   Data set name patterns can contain a percent sign (%) to represent a single character, and an asterisk (*) to represent any number of characters within one qualifier. Two asterisks (**) represent any number of characters within any number of qualifiers.

   For performance reasons, you should qualify the data set name as much as you can.

2. If there is a Member field immediately below the Data set name field and you have not specified a member name or a member name pattern in the Data set name field, then enter a member name or member name pattern in the Member field.

   A member name pattern can consist of any characters that are valid in a member name and the following two special pattern characters:

   asterisk (*)

   Represents any number of characters. As many asterisks as required can appear anywhere in a member name. For example, if you enter *d*, a list of all members in the data set whose name contains “d? is displayed.

   percent sign (%)

   A place-holding character representing a single character. As many percent symbols as necessary may appear anywhere in a member name. For example, if you enter %%%%, a list of all members in the data set whose name is four characters in length is displayed.

3. Press Enter. According to what you entered in the fields, one or both of these panels may be displayed in the order they are listed:
   • Data Set Selection panel
     • Displayed when you enter a data set name pattern.
     • Displays a list of the data sets whose names match the specified data set name pattern.
   • Member Selection panel
     • Displayed when the specified data set is partitioned and you enter no member name or a member name pattern.
     • Displays either a list of all the members in the data set (when you enter no member name) or a list of the members whose names match the specified member name pattern (otherwise).
4. To select a data set from the data set selection list, enter S in the Sel field adjacent to the required data set and press Enter. You can only select one name from this list.
5. To select a member from the member selection list, enter S in the Sel field adjacent to the required member and press Enter.
   Note:

   1. To reset values entered in the prefix area that have not yet been processed, use the RESET primary command.
   2. To re-read the directory and display the current member list, use the REFRESH primary command.
6. When you are selecting members, you might find it useful to sort the list of displayed members. There are two different ways to do this:
   • Use the SORT primary command to sort the member list by up to two of the displayed columns. The field names are the column headings. For example, SORT SIZE CREATED sorts the list of members first by size and then by the date created.
   • Place the cursor on the column header of the column you want to sort and press Enter.
   Note: When you sort members, the sequence (ascending or descending) for a given column is predetermined and consistent with ISPF.