Configuring a remote preprocessor

Use the Editor Configurations page of the property group editor to configure a remote preprocessor to run when you edit a file.

Procedure

You can open the property group editor from the Property Group Manager or from an edit session. When you open the property group from an edit session, the property group editor opens to the appropriate page for the type of preprocessor being used.

  1. From the Property Group Manager:
    1. Double-click the name of the property group that is associated with the file you want to edit.
    2. Select the tab for the appropriate programming language for the file. Select COBOL or PL/I.
    3. In the category list, click Editor Configurations.
      The Editor Configurations page opens.
  2. From an edit session, right-click and click Source > Preprocessor Statements > Configure Preprocessor (COBOL and PL/I Editors) or Preprocessor Statements > Configure Preprocessor (z Systems® LPEX Editor).
    The Editor Configurations page opens. If no property group is associated with the file, the Associate Property Group window opens for you to select an available property group.
  3. Click Use remote preprocessors.
  4. Complete the remote preprocessor configuration properties.

    REXX or CLIST invoking preprocessor: Specify the name of the REXX script or CLIST on the remote system that starts remote preprocessors. It must be a partitioned data set member. It can be a user-defined script or the sample PL/I macro preprocessor FEKRNPLI, located by default in FEL.SFELSAMP(FEKRNPLI).

    Preprocessor output location: Specify the fully qualified name of an output file to be generated and downloaded from the remote system to the workstation after a remote preprocessor is started. It must be either a partitioned data set member or a sequential data set. If you specify a partitioned data set name without a member name, such as MY.PDS( ), the member name of the program that you are editing is used.

    High-level qualifier for preprocessor data: Specify a qualifier to be used to allocate a temporary sequential data set. The product writes data to this data set to be read by the REXX script or CLIST on the remote system. The sequential data set is deleted after the REXX script or CLIST runs successfully. If the script fails, the data set is not deleted.

    Preprocessor parameters: Specify any additional information that is needed for the REXX script or CLIST to start the remote preprocessors.

    PL/I: If you specify the FEKRNPLI PL/I macro preprocessor, then the following preprocessor parameters are needed for it to run successfully. For full instructions on using the preprocessor and a complete list of options you can specify, see the comments in the header of the FEKRNPLI member.
    • Specify an output listing sequential data set in a <SYSPRINT>dataSetName</SYSPRINT> parameter. The sequential data set that you specify in this parameter must be allocated before you run the preprocessor.
    • If your compiler options contain more than 100 characters, specify a compiler options file in an <OPTIONS>dataSetName</OPTIONS> parameter. You can specify a sequential data set or a partitioned data set member.
      Important: To use a compiler options file, you must also specify +DD:OPTIONS in the Compiler options field of the PL/I Compile Step Options section on the Procedures and Steps page in the property group.
      PL/I compiler options file