Rational Developer for System z

Step A1. Create a generation properties file for the main flow

Use the New Generation Properties wizard to create a generation properties file for the main flow of your program.
Note: After the New Generation Properties wizard closes, Enterprise Service Tools automatically opens the new generation properties file in the generation properties editor so that you can edit the generation properties.

To create a generation properties file for a flow:

  1. Start the New Generation Properties wizard:
    1. In the EST Project Explorer, right-click the flow for which you want to generate a new generation properties file (for example, MySFP_0001.seqflow).

    2. Select New > Generation Properties File.

    The New Generation Properties wizard opens.

    Note: Alternatively, to start the wizard, you can follow these steps:
    1. From the workbench's main menu, select New > Generation Properties File.

    2. The New Generation Properties wizard opens.

    If you have not selected a flow, then you can specify the flow on the first page of the wizard.

  2. On the first page of the New Generation Properties wizard, titled New File:
    File name

    Type the name that you want to use for the new generation properties file. The default name is new_generation_props.sfgen.

    Description

    Type a description of the generation properties file if you wish.

    Destination project

    Select the service flow project in which you want to create the new generation properties file. The default value is the current service flow project (the service flow project containing the folder, subfolder, or artifact that you right-clicked in step 1).

    Flow

    Expand the list and select the flow for which you want to create a generation properties file.

    Important:
    • Be sure to select from the list the actual flow for which you want to create a generation properties file.
    • The list is sorted alphabetically, and therefore the item at the top of the list is always the first item in the sort (such as AAAFlow_01.seqflow).
    • Functionally the first item in the list is also the default item, because by default the first item in the list is selected.
      Caution: If you right-click a flow in Step 1, that flow is not selected by default in the list of flows. If you click Next without selecting the actual flow that you want to use, then the flow that you want to use is taken to be the currently selected flow, that is the first item in the sort (AAAFlow_01.seqflow). The result is that your new generation properties file is filled with contents from the wrong flow and is placed in the wrong subfolder.
    Reuse properties from most recently saved generation properties files:
    Select this check box if you want the wizard to set the generation properties of the flow node and the invoke nodes in the new generation properties file to the most recently saved values for those nodes (see Reuse properties from the most recently saved generation properties file).
    Important: This option makes it easy for you to set the generation properties for the nodes of an invoked flow, residing in the new generation properties file for the main flow (for example, GPMain.sfgen), to the same values that you have already set for the generation properties of those same nodes residing in the generation properties file for the invoked flow (GPInvoked01.sfgen).
    Validate flows against runtimes
    If this check box is selected, then when you click Next the wizard validates whether the selected flow can be used to generate runtime code for each of the supported runtime environments.
    • This level of validation checks only whether the types of the nodes in the selected flow are valid for each of the supported runtime environments. A more thorough validation is done when the code is generated for the runtime environment.
    • The results of this validation display on the next page of the wizard. If the selected flow can be used to generate code for a runtime environment based on this level of validation, then the selection for that runtime environment is available.

    Click Next to go to the next page.

  3. CICS Service Flow Runtime Levels 1.0 and 2.0

    On the Runtime selection page, select the runtime environment for which you want the wizard to create a generation properties file:
    • CICS Service Flow Runtime: Level 1.0
    • CICS Service Flow Runtime: Level 2.0
    • Host Access Transformation Services
    Note: If you selected the check box Validate flows against runtimes on the previous page of the wizard, and if the flow that you selected contains a type of node that is invalid for a runtime environment, then the selection for that runtime environment is disabled.
    Table 1 shows which versions of CICS® Transaction Server for z/OS® and the CICS Service Flow Feature (Service Flow Runtime) correspond to CICS Service Flow Runtime: Level 1.0 and CICS Service Flow Runtime: Level 2.0 (also see Supported runtime environments for each project type):
    Table 1. CICS Service Flow Runtime levels
    Runtime level: CICS Service Flow Feature (Service Flow Runtime): CICS Transaction Server for z/OS:
    CICS Service Flow Runtime: Level 1.0
    • CICS Service Flow Runtime for CICS Transaction Server for z/OS V3.1
    • CICS Transaction Server for z/OS V3.1 without APAR PK83534
    CICS Service Flow Runtime: Level 2.0
    • CICS Service Flow Runtime for CICS Transaction Server for z/OS V3.2
    • CICS Transaction Server for z/OS V4.1
    • CICS Transaction Server for z/OS V3.2
    • CICS Transaction Server for z/OS V3.1 with APAR PK83534

    Click Finish.

The following actions are performed:
  1. The wizard creates an initial generation properties file for the runtime environment that you selected and places the file in a subfolder of the Generation folder of the service flow project (see Subfolders in which generation properties files and runtime output files are stored). The wizard then closes.

  2. As a convenience, Enterprise Service Tools automatically opens the new generation properties file in the generation properties editor.


Feedback