Setting the target environment properties for files

You can use the Target Environment properties page to customize a target environment for the selected file.

About this task

Tip: You can customize only target environments that are displayed in the Applicable target environments list in the parent subproject. Overriding a target environment customizes the definition of the target environment for the selected file only.

Procedure

To customize a target environment definition for a file, complete the following steps:

  1. Switch to the z/OS Projects perspective.
  2. In the z/OS Projects view, double-click the z/OS® UNIX subproject that contains the file you want to set up the properties for. The list of files in the selected z/OS UNIX subproject is displayed.
  3. Right-click the file that you want to set up the properties for, and select Properties from the menu to open the Properties window.
  4. In the left navigation pane, click Target Environments to open the Target Environments properties page.
    Target Environments file properties page
    The options that are available in this properties page are dependent on the type of file that you select. For example, if you select a .c file, the following options are available:
    • Build and Link Options
    • Menu Options
    • Target Environment Variables

Customizing the target environment for C and CPP files

Procedure

To customize the target environment for C and CPP source files, complete the following steps:

  1. From the Select a target environment to customize list, select the target environment that you want to customize for the selected file.
  2. Expand the Build and Link Options twistie and do one of the following actions:
    1. Click Use subproject level settings to specify that you want to use build and link options settings that are defined in the parent subproject of the selected file.
      Tip: You can examine the specific settings within each set of build and link options to help you decide which set you want to use. To view these settings, select the build and link options set that you want to examine, and then click View.
    2. Click Use custom settings for this file to specify that you want to use custom build and link options settings for the selected file. This option overrides the selected target environment for the file. When the associated target environment is set as the current target environment for the parent subproject, the selected file always uses the custom build and link options regardless of which build and link option set the parent subproject uses.
      Tip: to remove the override and revert to the target environment definition used by the parent subproject, click Use subproject level settings or click Restore Defaults to revert the override for all sets of options.
      From the Available build and link options list, select the set of build and link options that you want to use.
      Tip: The Available build and link options list is populated with all known sets of build and link options. You can examine the specific settings within each set of build and link options to help you decide which set you want to use. To view these settings, select the build and link options set that you want to examine, and then click View. Use the Build and Link Options preference page to define or import new sets of build and link options.
  3. Expand the Menu Options twistie and do one of the following actions:
    1. Click Use subproject level settings to specify that you want to use the menu options settings that are defined in the parent subproject of the selected file.
      Tip: You can examine the specific settings within each set of menu options to help you decide which set you want to use. To view these settings, select the menu options set that you want to examine, and then click View.
    2. Click Use custom settings for this file to specify that you want to use custom menu options for the selected file. This option overrides the selected target environment for the file. When the associated target environment is set as the current target environment for the parent subproject, the selected file always uses the custom menu options regardless of which menu option set the parent subproject uses.
      Tip: To remove the override and revert to the target environment definition used by the parent subproject, click Use subproject level settings or Restore Defaults to revert the override for all sets of options.

      When this target environment is set as the current target environment for the parent subproject of the selected file, the custom menu options you selected customize the menu of this file. As a result, this file might display a menu that is different from all other files in the subproject.

      From the Available menu options list, select the set of menu options that you want to use.
      Tip: The Available menu options list is populated with all known sets of menu options. You can examine the specific settings within each set of menu options to help you decide which set you want to use. To view these settings, select the menu options set that you want to examine, and then click View. Use the Menu Options preference page to define or import new sets of menu options.
  4. Expand the Target Environment Variables twistie and do one of the following actions:
    1. Click Use subproject level settings to specify that you want to use the target environment variables that are defined in the parent subproject of the selected file.
      Tip: You can examine the specific settings within each set of target environment variables to help you decide which set you want to use. To view these settings, select the set of target environment variables that you want to examine, and then click View.
    2. Click Use custom settings for this file to specify that you want to use a custom set of variables for the selected file. This option overrides the selected target environment for the file. When the associated target environment is set as the current target environment for the parent subproject, the selected file always uses the custom target environment variables regardless of which set of variables the parent subproject uses.
      Tip: To remove the override and revert to the target environment definition used by the parent subproject, click Use subproject level settings or Restore Defaults to revert the override for all sets of options.
      From the Available target environment variables set list, select the set of variables that you want to use.
      Tip: You can examine the specific settings within each set of variables to help you decide which set you want to use. To view these settings, select the variables set that you want to examine, and then click View. Use the Target Environment Variables preference page to define or import new sets of target environment variables.
  5. Click OK to save your selections and close the Properties window.
    The settings that you specified are applied to the selected file.

Customizing the target environment for Assembler files

Procedure

To customize the target environment for Assembler source files, complete the following steps:

  1. From the Select a target environment to customize list, select the target environment that you want to customize for the selected file.
  2. Expand the Build and Link Options twistie and do one of the following actions:
    1. Click Use subproject level settings to specify that you want to use build and link options settings that are defined in the parent subproject of the selected file.
      Tip: You can examine the specific settings within each set of build and link options to help you decide which set you want to use. To view these settings, select the build and link options set that you want to examine, and then click View.
    2. Click Use custom settings for this file to specify that you want to use custom build and link options settings for the selected file. This option overrides the selected target environment for the file. When the associated target environment is set as the current target environment for the parent subproject, the selected file always uses the custom build and link options regardless of which build and link option set the parent subproject uses.
      Tip: To remove the override and revert to the target environment definition used by the parent subproject, click Use subproject level settings or Restore Defaults to revert the override for all sets of options.
      From the Available build and link options list, select the set of build and link options that you want to use.
      Tip: The Available build and link options list is populated with all known sets of build and link options. You can examine the specific settings within each set of build and link options to help you decide which set you want to use. To view these settings, select the build and link options set that you want to examine, and then click View. Use the Build and Link Options preference page to define or import new sets of build and link options.
  3. Expand the Menu Options twistie and do one of the following actions:
    1. Click Use subproject level settings to specify that you want to use the menu options settings that are defined in the parent subproject of the selected file.
      Tip: You can examine the specific settings within each set of menu options to help you decide which set you want to use. To view these settings, select the menu options set that you want to examine, and then click View.
    2. Click Use custom settings for this file to specify that you want to use custom menu options for the selected file. This option overrides the selected target environment for the file. When the associated target environment is set as the current target environment for the parent subproject, the selected file always uses the custom menu options regardless of which menu option set the parent subproject uses.
      Tip: To remove the override and revert to the target environment definition used by the parent subproject, click Use subproject level settings or Restore Defaults to revert the override for all sets of options.

      When this target environment is set as the current target environment for the parent subproject of the selected file, the custom menu options you selected customize the menu of this file. As a result, this file might display a menu that is different from all other files in the subproject.

      From the Available menu options list, select the set of menu options that you want to use.
      Tip: The Available menu options list is populated with all known sets of menu options. You can examine the specific settings within each set of menu options to help you decide which set you want to use. To view these settings, select the menu options set that you want to examine, and then click View. Use the Menu Options preference page to define or import new sets of menu options.
  4. Expand the Target Environment Variables twistie and do one of the following actions:
    1. Click Use subproject level settings to specify that you want to use the target environment variables that are defined in the parent subproject of the selected file.
      Tip: You can examine the specific settings within each set of target environment variables to help you decide which set you want to use. To view these settings, select the set of target environment variables that you want to examine, and then click View.
    2. Click Use custom settings for this file to specify that you want to use a custom set of variables for the selected file. This option overrides the selected target environment for the file. When the associated target environment is set as the current target environment for the parent subproject, the selected file always uses the custom target environment variables regardless of which set of variables the parent subproject uses.
      Tip: To remove the override and revert to the target environment definition used by the parent subproject, click Use subproject level settings or Restore Defaults to revert the override for all sets of options.
      From the Available target environment variables set list, select the set of variables that you want to use.
      Tip: You can examine the specific settings within each set of variables to help you decide which set you want to use. To view these settings, select the variables set that you want to examine, and then click View. Use the Target Environment Variables preference page to define or import new sets of target environment variables.
  5. Click OK to save your selections and close the Properties window.
    The settings that you specified are applied to the selected file.