Specifying an additional preprocessor

Specify a preprocessor to use with your project

To specify an additional preprocessor for use with your project:

  1. Click Project > Properties.
  2. Click Micro Focus > Project Settings > COBOL > Additional Preprocessors.
  3. Specify a preprocessor to use with your project:
    • To specify your own or third-party preprocessor to use with your project:
      1. Click New. This displays the Add Custom Preprocessor dialog box.
      2. Type the name of the preprocessor in the Name field.
      3. Specify the location of the preprocessor in the Location field. Alternatively, click Browse and navigate to the preprocessor location.
      4. Type the directives in the Directives field. Use space to separate multiple directives.
    • To specify an installed preprocessor to use with your project:
      1. Click Installed, this will display the Add Installed Preprocessor dialog box.
      2. In the Name list, select the installed preprocessor to use.
      3. Type any required directives in the Directives field.
      4. Click OK.

        If you name the preprocessor the same as an existing preprocessor, the IDE prompts you for confirmation to overwrite the existing preprocessor.

      Note: It is not possible to combine the "Micro Focus - EHTML Preprocessor" and "Micro Focus - XML Preprocessor" with other preprocessors. Selecting one of these preprocessors will prevent you from adding any other additional preprocessors. See Integrating Preprocessors into Enterprise Developer for instructions about how to integrate an additional preprocessor with the list in Enterprise Developer.
  4. Click OK to save your changes.

Each preprocessor you add is inserted at the top of the list on the Preprocessor page. The order of execution of preprocessors is from the top to the bottom of the list.

Specify a preprocessor to use with a build configuration

To enable an additional preprocessor for a build configuration:

  1. Click Project > Properties.
  2. Expand Micro Focus > Build Configurations > COBOL.
  3. Click Additional Preprocessors.
  4. Select the Build Configuration.
  5. Check Enable configuration specific settings.
  6. Specify a preprocessor to use with your selected build configuration:
    • To specify your own or third-party preprocessor to use with your build configuration:
      1. Click New, this will display the Add Custom Preprocessor dialog box.
      2. Type the name of the preprocessor in the Name field.
      3. Specify the location of the preprocessor in the Location field. Alternatively, click Browse and navigate to the preprocessor location.
      4. Type the directives in the Directives field. You can add multiple directives by creating a space separated list.
    • To specify an installed preprocessor to use with your build configuration:
      1. Click Installed, this will display the Add Installed Preprocessor dialog box.
      2. In the Name list, select the installed preprocessor to use.
      3. Type any required directives in the Directives field.
      4. Click OK.

        If you name the preprocessor the same as an existing preprocessor, the IDE will prompt you for confirmation to overwrite the existing preprocessor.

      Note: It is not possible to combine the "Micro Focus - EHTML Preprocessor" and "Micro Focus - XML Preprocessor" with other preprocessors. Selecting one of these preprocessors will prevent you from adding any other additional preprocessors. See Integrating Preprocessors into Enterprise Developer for instructions about how to integrate an additional preprocessor with the list in Enterprise Developer.
  7. Click OK to save your changes.

Each preprocessor you add is inserted at the top of the list on the Preprocessor page. The order of execution of preprocessors is from the top to the bottom of the list.

Specify a preprocessor to use with a file

To enable an additional preprocessor for an individual file in your project:

  1. In COBOL Explorer, right-click a COBOL program in your project, and click Properties.
  2. Click COBOL > Additional Preprocessors.
  3. Check Enable file specific settings.
  4. Specify a preprocessor to use with the selected file:
    • To specify your own or third-party preprocessor to use with your file:
      1. Click New, this will display the Add Custom Preprocessor dialog box.
      2. Type the name of the preprocessor in the Name field.
      3. Specify the location of the preprocessor in the Location field. Alternatively, click Browse and navigate to the preprocessor location.
      4. Type the directives in the Directives field. You can add multiple directives by creating a space separated list.
    • To specify an installed preprocessor to use with your file:
      1. Click Installed, this will display the Add Installed Preprocessor dialog box.
      2. In the Name list, select the installed preprocessor to use.
      3. Type any required directives in the Directives field.
      4. Click OK.

        If you name the preprocessor the same as an existing preprocessor, the IDE will prompt you for confirmation to overwrite the existing preprocessor.

      Note: It is not possible to combine the "Micro Focus - EHTML Preprocessor" and "Micro Focus - XML Preprocessor" with other preprocessors. Selecting one of these preprocessors will prevent you from adding any other additional preprocessors. See Integrating Preprocessors into Enterprise Developer for instructions about how to integrate an additional preprocessor with the list in Enterprise Developer.
  5. Click OK to save your changes.

Each preprocessor you add is inserted at the top of the list on the Preprocessor page. The order of execution of preprocessors is from the top to the bottom of the list.

Parent topic: Additional Preprocessors