Rational Developer for System z

Property groups

A property group is a set of property values that you can define for local COBOL and PL/I projects or specific remote systems. Once a property group is created and configured, it can be shared among various systems and resources that you would like the properties to be applied to. File Manager Integration uses property groups to define compilation options when creating templates from COBOL, PL/I, or HLASM source code. For more information on creating, editing, and working with property groups, see the following topic.

Defining resource options with property groups

During a template compile, File Manager Integration determines the proper compiler language to use automatically. This automation is based on the file extension of the source code being used to create the template. Specific compilation options can be defined and customized for COBOL, PL/I and HLASM languages using property groups in combination with File Manager Integration.

After creating a property group, ensure that the File Manager settings are enabled by performing the following steps:
  1. Open the property group to begin editing its settings.
  2. Select the Categories tab from the bottom of the Property Group Editor.
  3. In the Other category, place a check mark next to the File Manager Settings entry.
  4. Finally, in the Languages category, select the languages you would like to configure File Manager options for.
    Note: File Manager Integration only offers configuration options for the COBOL, PL/I, and HLASM languages.

Property groups can be assigned to a wide variety of resources within the Remote Systems view including entire file systems, data sets, or individual files. When a new template is created using the Create Template wizard, File Manager will determine the compilation options to use from the property group associated with the PDS that the template is being created from. If a property group has not been associated with a specific PDS, the property group associated with the MVS file system will be used. If no property groups are associated with the MVS file system, default values will be used. The default values for each compilation option can be found in the sections below.

To begin editing the language compilation options, select the File Manager tab from the bottom of the Property Group Editor.

COBOL processing options

The COBOL processing options can be selected from the left pane of the Property Group Editor when viewing the File Manager tab. It is important to note that these options will only be visible if the COBOL Settings were enabled from the Categories tab. For COBOL, options for processing, replacing, and the compiler are provided.

Table 1. COBOL Compiler Options
Option Description Possible Values (Default)
Use the DBCS compiler option. Instruct File Manager to use the DBCS compiler option. True or False (False)
Use the "decimal-point is comma" is SPECIAL-NAMES paragraph. Use the "Decimal-point is comma" SPECIAL-NAMES paragraph when compiling COBOL copybooks. True or False (False)
Use the arith(extended) COBOL compile option. Use the Arith(extend) COBOL compile option when compiling COBOL copybooks. True or False (False)
Retain the original case of the source code's field names. Retain the original case of the field name as it is coded in the COBOL copybook. True or False (False)
Maximum return code accepted from the compiler Sets the maximum warning/error code accepted from the compiler, when compiling a copybook. Any code higher than what is specified will cause File Manager to display a pop-up panel, in which you can review the compilation and decide about future processing. Integer between 0 and 99 (4)

PL/I processing options

The PL/I processing options can be selected from the left pane of the Property Group Editor when viewing the File Manager tab. It is important to note that these options will only be visible if the PLI Settings were enabled from the Categories tab. For PL/I, options for processing and the compiler are provided.

Table 2. PL/I Compiler Options
Option Description Possible Values (Default)
Use the GRAPHIC compiler option; if unselected, use NOGRAFFIC If selected, use the GRAPHIC compiler option. Otherwise, use NOGRAPHIC. True or False (False)
Use the LIMITS(FIXEDBIN(63)) compiler option; if unselected, use LIMITS(FIXEDBIN(31)) If selected, use the LIMITS(FIXEDBIN(63)) compiler option. Otherwise, use LIMITS(FIXEDBIN(31)). True or False (False)
Use the DEFAULT RANGE(*) UNALIGNED; language statement to change the default alignment If selected, use the DEFAULT RANGE(*) UNALIGNED; language statement to change the default alignment. True or False (False)
Use the LIMITS(FIXEDDEC(#!)) compiler option; if unselected, use LIMITS(FIXEDDEC(15)) If selected, use the LIMITS(FIXEDDEC(31)) compiler option. Otherwise, use LIMITS(FIXEDDEC(15)). True or False (False)
Maximum return code accepted from the compiler Sets the maximum warning/error code accepted from the compiler, when compiling a copybook. Any code higher than what is specified will cause File Manager to display a pop-up panel, in which you can review the compilation and decide about future processing. Integer between 0 and 99 (4)

HLASM processing options

The HLASM processing options can be selected from the left pane of the Property Group Editor when viewing the File Manager tab. It is important to note that these options will only be visible if the Assembler Settings were enabled from the Categories tab. For HLASM, options for processing and the compiler are provided.

Table 3. HLASM Compiler Options
Option Description Possible Values (Default)
Use the DBCS compiler option Instruct File Manager to use the DBCS compiler option. True or False (False)
Use the NOALIGN compiler option If selected, use the NOALIGN compiler option. True or False (False)
Maximum return code accepted from the compiler Sets the maximum warning/error code accepted from the compiler, when compiling a copybook. Any code higher than what is specified will cause File Manager to display a pop-up panel, in which you can review the compilation and decide about future processing. Integer between 0 and 99 (4)

Feedback