Rational Developer for System z

Set the mapping extension to cbl for a data set with the low-level qualifer SRCLIB

The mapping extension property should be set to cbl for a data set whose name has the low-level qualifier SRCLIB (for example, USER25.SFP1.USER.SRCLIB).

The mapping extension property of a data set specifies the extension that the Remote Systems view attaches to the name of a member that is uploaded to the data set from a local workstation. (For more about the properties of data sets see Properties for remote data sets and data set members in the Remote Systems view.) For example, if the value of the mapping extension property of a data set is cbl, then a member uploaded to the data set is given the extension cbl (for example, MAINMENU.cbl).

Elsewhere in the online help (see Tips for naming partitioned data sets) it is suggested that you use the low-level extension SRCLIB in the name of a data set that is to contain COBOL source code members (for example, USER25.SFP1.USER.SRCLIB).
Note: The reason that the low-level extension SRCLIB is suggested is that by default "SRCLIB" is used as the low level qualifier value in the DFHMAXCJ template. If the value in the template has been changed to something else, such as "COBOL", then setting the mapping extension may not be required.

By default the Remote Systems view does not define a mapping extension for a data set having the low-level qualifier SRCLIB. (More specifically, the default value of the mapping extension for such a data set is Inherit from system mapping (undefined)). The result is that when the Generate Runtime Code wizard uploads a file (such as MAINMENU.cbl) from the local workstation to a data set having the low-level qualifier SRCLIB, then the Remote Systems view attaches no extension to the name of the new member (for example, MAINMENU).

Unfortunately, when a COBOL source file member of a data set has no file extension, problems can occur when you try to compile and link the member.

Therefore, when you create a data set with the low-level qualifier SRCLIB, you should also set the mapping extension of the data set to cbl. (Alternatively, you could rename each member after it is uploaded to the data set, so that each name has the extension cbl.)

To set the mapping extension to .cbl:

  1. In the Enterprise Service Tools perspective, in the Remote Systems view, right-click the data set (for example, USE25.SFP1.USER.SRCLIB).

  2. Select Properties. The Properties window opens.

  3. In the Properties window:
    1. In the left pane, click Mapping.
    2. In the right pane, in the group Extension:
      1. Select the radio button Other.
      2. In the input field Other, type cbl (with no preceding period ".").

  4. Click OK.


Feedback