Specifying a data set and a member name

Some FM/CICS panels require you to specify the data set that you wish to use for a copybook or template. When the data set is a PDS or a CA-Panvalet or other external library, you must also specify the member name.

Figure 1. Data set name specification fields
⋮
 Copybook or Template:
    Data set name  . .                                               
    Member . . . . . .              Blank or pattern for member list
⋮

To specify your copybook or template:

  1. In the Data set name field, enter 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.

    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 name in quotation marks, then the default High Level Qualifier (HLQ) is used. The HLQ is specified in the Prefix field on the File Manager for CICS Logon panel.

    If you enter a pattern, when the panel is processed FM/CICS 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 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 name field (without including a member name or name pattern in parenthesis), then 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 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 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 name field and leave the Member field blank,
    FM/CICS displays a member name list when the panel is processed and the data set has been specified or selected.
  3. Complete the remaining panel-specific fields, and then press Enter to process the panel function.

    If both the data set 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 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.

  4. 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.
  5. When the member selection panel is displayed, select a member by typing an S in the Sel field next to the member or with the SELECT primary command, and then pressing Enter.

    Because you are selecting a copybook or template, you select only one name.

    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 a member, you might find it useful to sort the list of displayed members. To do this, perform one 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.