Rational Developer for System z

Mapping data sets and partitioned data set members

About this task

A data set mapping associates the lowest level qualifier in each MVS™ data set to a file name extension that is used for the related workstation-based file in your subprojects.

Procedure

To add a data set mapping:

  1. Open the z/OS File System Mapping view.
  2. Select the remote system you want to modify mappings for from the System list.
  3. To add a data set mapping, right-click the table in the z/OS File System Mapping view and select Add Data Set Mapping. The Add Data Set Mapping window opens.
  4. To add a member mapping, right click a data set mapping in the z/OS File System Mapping view and select Add Member Mapping. The Add Member Mapping window opens.
  5. Specify a string in the Mapping criterion field. Data sets and members with names matching this string are included in the mapping.
    • Use ** as a wild card for matching one or more data set name segments or qualifiers:
      • **COBOL matches <any high-level qualifier>.<any middle qualifier>.COBOL. Some examples of data set names that match this mapping include:
        • USER.COBOL
        • USER.A.COBOL
        • USER.A.B.C.COBOL
        • USER.A.B.C.MYCOBOL
      • **ERROR** matches <any high-level qualifier>.ERROR.<any low-level qualifier>. Some examples of data set names that match this mapping include:
        • USER.ERROR.TEST
        • USER.A.B.MYERROR.ABC
        • USER.A.B.MYERROR2.ABC
    • Use * as a wild card for matching within a data set name segment or qualifier. For example, USER**COB* matches the following names:
      • USER.A.COB
      • USER.A.B.COBOL
      • USER.A.B.ACOBCOPY
    • You can also use a period as a delimiter in a mapping:
      • USER.*.TEST matches USER.A.TEST, but not USER.A.B.TEST
      • USER.**TEST matches USER.A.TEST, USER.A.B.TEST, and USER.A.B.CTEST.
  6. Fill in the properties for the rest of the fields as necessary.
  7. Click OK. The new mapping appears in the table. Member mappings are added as children of the data set mapping that you selected before clicking Add Member Mapping. You can sort this table by any of the headings shown in the view (such as Mapping Criterion, Workstation File Extension, Transfer Mode, and so on). To sort the table, click a table heading.
  8. Optional: You can override these system-wide mappings by defining mappings for specific data sets or members by following these steps:
    1. Right-click the data set or member in the Remote Systems view and click Properties.
    2. Click Mapping in the list on the left. The Mapping pane opens on the right. This pane is similar to the Add Data Set Mapping window.
    3. Leave the option to inherit values selected for each of the values you want to cascade from a higher level.

Feedback