Rational Developer for System z

Finding members without filters

Use the Find Member action to find partitioned data set members in the MVS Files subsystem or in a partitioned data set, open a member in an editor, or create a new partitioned data set member.

About this task

This task explains how to find a member in the MVS Files subsystem or in a specific partitioned data set. For a quick way to find and open a member in an editor, see Finding and editing members.

Finding a member in MVS Files

Procedure

To find a partitioned data set member in the MVS Files subsystem:

  1. In the Remote Systems view, select MVS Files and then select Find Member from the pop-up menu or press Ctrl+F. The Find Member window opens. If you have performed previous searches, the last search pattern used is shown in the window.
  2. Optional: Press Enter. You can also type a fully qualified data set and member name pattern to find, for example, USERID.TEST.COBOL(MEM*).
    Tip:
    • The wild card character (*) is allowed only as part of the member name portion of the pattern and not as part of the data set name.
    • If the data set name does not exist then a message is displayed.
    • No more than one set of parentheses is allowed.
    • If there are extra characters entered after a valid data set and member name pattern then an invalid member name pattern message is displayed.
    • Normal data set name validation rules and member name validation rules apply for the specified data set and member name.
    • The host encoding (based on either the MVS™ Files subsystem or the selected data set) is used for the code variants to be used for data set name and member name validation.
    • If you type the data set name and press the Spacebar, parentheses with an asterisk are added to the pattern field. If you type the data set name followed by left parenthesis, an asterisk and the closing right parenthesis is added.
    Matching member names are listed in the window. The window also displays the number of matches.
    Note: If the search returns a large number of member names (the default threshold is 1000 members), a warning message is displayed. You can use the MVS Files preference page to specify the size of the result set to trigger this warning. See the related topics for more information about this preference.
  3. Optional: You can type a new search pattern to update the list of matches. If you type an invalid member name pattern, if you attempt to access a RACF-protected data set that you are not authorized to access, or if you receive a large number of matches, you can retype or refine the search pattern to try the search again or narrow down the list of matches.
  4. To add a member from this list to the Retrieved Data Sets filter of the MVS Files subsystem, select the member you want and click OK. The member selected is added to the Retrieved Data Sets filter in the MVS Files subsystem and highlighted in the view.
  5. To open a member in an editor, do one of the following actions:
    • Select a member from the list and click Open.
    • Type a partitioned data set member name, such as USERID.TEST.COBOL(MEMBER1) in the entry field and click Open.
    The Open button is always enabled to facilitate the quick editing of a data set member. This button is enabled even when an invalid name message displays.

Finding a member in a partitioned data set

About this task

You can also find a member in a specific partitioned data set in the MVS Files subsystem or in an MVS subproject in the z/OS Projects or Enterprise Projects view.

Procedure

  1. In the Remote Systems view or z/OS Projects view, select a partitioned data set and press Ctrl+F. The Find Member window opens with the data set name in the text field and an asterisk for the member name, for example, USERID.TEST.COBOL(*).
  2. Inside the parentheses, type a member name pattern to find, for example, MEM*, and press Enter. Matching member names are listed in the window. The window also displays the number of matches.
  3. Continue finding members as described in Finding a member in MVS Files. When you request the Find Member action for a specific data set, the member is highlighted under the data set name and not added to the Retrieved Data Sets filter.
    Note: If you request the Find Member action from the z/OS Projects view, but the member has not been added to the MVS subproject, it is highlighted in the Remote Systems view.

Creating a new member by using the Find Member window

About this task

You can use the Find Member window to create a new member in the selected partitioned data set.

Procedure

  1. In the Remote Systems view or z/OS Projects view, select a partitioned data set name and then press Ctrl+F. The Find Member window opens with the data set name in the text field and an asterisk for the member name, for example, USERID.TEST.COBOL(*).
  2. Type a new member name pattern in the parentheses, for example, MEMBER1 and click Open. A window opens asking you to confirm the creation of a new member.
  3. Click Yes to create the new member. The new member is created, opened in the editor, and highlighted in the Remote Systems view or z/OS Projects view.

Feedback