Specifying a data set and a member name

Many Z Data Tools panels require you to specify the data set that you wish to use for the current process. When the data set is a PDS or a CA-Panvalet or other external library, you must also specify the member name. These panels are collectively referred to as Entry panels, for example, the View Entry panel.

All Entry panels contain the following fields:

Figure 1. Data set/path name specification fields
ā‹®
Input Partitioned, Sequential or VSAM Data Set, or HFS file:
   Data set/path name . . . . . ______________________________________________+
   Member  . . . . . . . . . .  ________     Blank or pattern for member list
   Volume serial . . . . . . .  ______       If not cataloged
ā‹®

To specify your data set on any Entry panel:

  1. In the Data set/path name field, enter a path name, a fully-qualified data set name, or a name pattern. The name may include a member name or name pattern in parenthesis. If the member is specified here, the associated Member field must be empty.

    For details about rules for specifying a path name, see Specifying an HFS file.

    In the case of a copybook, this can be the name of a CA-Panvalet library or external library accessed using the Library Management System Exit.

    If you do not enclose the data set/path name in quotation marks, then the default High Level Qualifier (HLQ) is used. Typically, the default is the TSO PREFIX for your user ID.

    If you enter a pattern, when the Entry panel is processed, Z Data Tools displays a list of the data sets that match the pattern.

    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/path name as much as you can.

  2. If you specified the name of a partitioned data set (PDS) or a CA-Panvalet or other external library in the Data set/path name field (without including a member name or name pattern in parenthesis), then perform either of these actions:
    • Enter a name or 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/path whose name is four characters in length is displayed.
      If you perform either of these actions
      • Do not include a member name or name pattern in parenthesis in the Data set/path name field, and leave the Member field blank or you specify a pattern in the Member field,
      • Include a member name pattern in parenthesis in the Data set/path name field and leave the Member field blank,
      Z Data Tools displays a member name list when the Entry panel is processed and the data set has been specified or selected.
    • If the entry panel you are using includes the option, Advanced member selection, and you want to select a range of PDS(E) members based on one or more criteria,select that option to display the Advanced Member Selection panel.

      For details about selecting a range of PDS(E) members, see Selecting a range of PDS(E) members.

  3. For data sets which have not been cataloged, enter the serial number of the volume which contains the data set in the Volume serial field.
  4. Complete the remaining panel-specific fields, and then press Enter to process the panel function.

    If both the data set/path name and the member name have been fully specified, the panel action proceeds to its next stage.

    If you entered a pattern for the data set/path name or member name, the Data Set Selection panel is displayed, followed by the Member Selection panel, as needed. When you have made your selections from these panels, the Entry panel action proceeds to its next stage.

  5. When the Data Set Selection panel is displayed, select your data set by entering an S in the Sel field adjacent to the required data set. You can only select one name from this list.
  6. When the Member Selection panel is displayed, select your members by typing an S in the Sel field next to each member or with the SELECT primary command, and then pressing Enter.

    You can select as many names as required from this list. When the panel is processed, the first member on the list is used in the relevant function. When the function is completed, the next member on the list is used. For example, if you are selecting several members to be edited, the first member is displayed in the Edit Session panel. When you exit this panel, the next member is displayed, and so on, until all selected members have been processed.

    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.
  7. When you are selecting members, you might find it useful to sort the list of displayed members. To do this, perform either of these actions
    • 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.