Setting preferences for COBOL requester templates

Use the COBOL Requester Templates page of the Preferences window to modify the COBOL requester templates.

This topic contains the following subtopics:

Opening the COBOL Requester Templates page

To open the COBOL Requester Templates page of the Preferences window:

  1. In the left pane of Preferences window select Enterprise Service Tools > Service Flow Projects > COBOL Requester Templates. The COBOL Requester Templates page opens in the right pane.

General information

The COBOL requester templates are COBOL source code modules from which you can select a template for Generate Client Requester wizard to use in generating a COBOL source code module for a CICS® requester client (see Creating a test program using the Generate Client Requester wizard):

  • CSFRCONT: The wizard uses this template to generate a COBOL source code module for invoking the CICS Service Flow Runtime using a LINK with Channel.

  • CSFRCOMM: The wizard uses this template to generate a COBOL source code module for invoking the CICS Service Flow Runtime using a LINK with COMMAREA.

The advantage of a template is that if you add custom source code to it -- such as code to handle return codes or error codes -- then this custom source code is included in the generated COBOL source code module every time you run the Generate Client Requester wizard.

The COBOL requester templates are global only. A change that you make in a COBOL requester template affects all the service flow projects in your work area.

Controls for working with COBOL requester templates

The controls for working with the COBOL requester templates are as follows:
Edit
This button opens the selected COBOL requester template in an editor so that you can make changes. When you are finished making changes, click OK on the editor window to keep the changes or click Cancel on the editor window to discard the changes.
Note: These changes are lost if you click Cancel on the main window, or saved if you click Apply on the main window.
Import
This button allows you to import a COBOL requester template from the local file system.
Note: The name of the file that you are importing must match the name of an existing COBOL requester template.
Import from Host
This button allows you to import one or more COBOL requester templates from members in partitioned data sets on a remote z/OS® system.
Important: This option is available only if you have created an MVS™ connection to the remote z/OS system (see Step B3(a). Create a connection to the remote z/OS system).
To import a COBOL requester template:
  1. Click Import from Host. The window Import remote JCL Templates opens. This pane displays the MVS connections that you have created in the Remote Systems view.
  2. In the window Import remote JCL Templates:
    1. In the table:
      1. Expand the icon for one of the MVS connections (for example, system.company.com).
      2. Expand My Data Sets.
      3. Select the data set members that you want to import.
        Important: A selected data set member must have the same name as an existing COBOL requester template for the import to be successful.
    2. Click OK to import the COBOL requester template or Cancel to cancel the operation.
  3. If you clicked OK then the Import COBOL Results window opens.
    Important: In the Import COBOL Results window click Details and read the status messages to find out whether the import was successful.
Export
This button allows you to export the selected COBOL requester template to a directory in the local file system as a text file.
Export all
This button allows you to export all the COBOL requester templates to a directory in the local file system as text files.