Rational Developer for System z

Step 5.1: Create and configure the generation properties file for CheckItemAvailability.seqflow

In this section you will create and configure a generation properties file for the invoked flow CheckItemAvailability.seqflow.

Overview of generation properties

A generation properties file contains settings for the many different options that can be specified for generating runtime code. The flow file and its associated generation properties file are the two primary input files for the Generate Runtime Code wizard.

You must prepare a separate generation properties file for each flow file in your service flow. Table 1 shows the two flow files in this tutorial and the name of the generation properties file that you will create for each flow file:
Table 1. Flow files and generation properties files
Flow file: Associated generation properties file:
CatalogOrder.seqflow CatalogOrderGP.sfgen
CheckItemAvailability.seqflow CheckItemAvailabilityGP.sfgen

Create the generation properties file for CheckItemAvailability.seqflow

In this subtopic you will use the New Generation Properties wizard to create a generation properties file for the invoked flow CheckItemAvailability.seqflow.

To create the generation properties file:

  1. Start the New Generation Properties wizard:

    1. In the EST Project Explorer right-click CatalogSample > Flows > CheckItemAvailability.seqflow.

    2. Click New > Generation Properties File.

    The New Generation Properties wizard opens.

  2. On the first page of the wizard:

    1. Set the options as shown in Table 2.
      Table 2. Options on the first page of the wizard
      Field: Set the field to this value: Comment:
      File name CheckItemAvailabilityGP.sfgen This field specifies the name for the new generation properties file.
      Description (Blank) This field allows you to specify a description of the generation properties file.
      Destination project CatalogSample This field specifies the service flow project in which the flow file is located and in which the new generation properties file is to be created.
      Flow CheckItemAvailability.seqflow This field specifies the flow file for which the new generation properties file is created.
      Reuse properties from most recently saved generation properties file Cleared See the online help.
      Validate flows against runtimes Selected See the online help.
    2. Click Next.

  3. On the second page of the wizard:

    1. Set the options as shown in Table 3.

      Table 3. Options on the second page of the wizard
      Field: Set the field to this value: Comment:
      Radio buttons CICS Service Flow Runtime: Level 2.0 This field specifies the target runtime for which the Generate Runtime Code wizard is to generate output files.
    2. Click Finish.

The wizard creates the new generation properties file and opens it in the generation properties editor. The wizard then closes.

Edit the generation properties file for CheckItemAvailability.seqflow

In this subtopic you will use the generation properties editor to modify some of the generation properties in the new generation properties file CheckItemAvailabilityGP.sfgen.

To modify the generation properties file:

  1. If the generation properties file is not already open then use the generation properties editor to open it:

    1. Right-click CatalogSample > Generation > CICS SFR L2.0 > CheckItemAvailability > CheckItemAvailabilityGP.sfgen.

    2. Click Open With > Generation Properties Editor.

    The generation properties editor opens.

  2. Set the generation properties for the flow node:

    Note: Notice that an error symbol is displayed on the icon for the flow node in the left pane of the editor area. The flow node has an error because one of the required generation properties for the flow node has yet not been set.
    1. In the hierarchical tree in the left pane click the flow node CheckItemAvailability if it is not already selected.

      The generation properties for the flow node are displayed on the right side of the editor area.

    2. Set the common generation properties as shown in Table 4 (see Common generation properties of all three flow types).
      Table 4. Common generation properties
      Field: Set the field to this value: Comment:
      Flow type Link3270 Bridge This field specifies the type of the flow node and by implication the type of the flow that is going to be generated by the Generate Runtime Code wizard.
      Request Name SAMPCIRN
      Note: This name stands for "Sample Program Check Item Request Name".
      This field specifies the identifying name to be assigned to the service flow. The CICS® Service Flow Runtime refers to the service flow by this name. At run time the service flow is started with this name.
      Program Name SAMPCIPN
      Note: This name stands for "Sample Program Check Item Program Name".
      This field specifies the name to be assigned to the main COBOL file that is generated by the Generation Runtime Code wizard.
      Transaction ID SADI This field specifies the transaction id to be used for the new service flow in CICS.
      Run Mode SYNC This field specifies the processing mode for the transaction.
      Comment (Blank) This field allows you to enter text describing the generation properties file or make other notes.
      Persistent Cleared See the online help.
      Generate Internal Data Structures Cleared See the online help.
      Generate Web Service Files None This field specifies whether additional converters and support files are to be generated for a non-SOAP deployment (such as CTG or MQ) or for a Web Services for CICS deployment.
      Host Code Page 037 United States This field specifies the host code page for either or both of the following actions:
      • Runtime XML-to-COBOL conversion
      • Uploading files to the host

    3. Set the additional generation properties for the Link3270 Bridge flow type as shown in Table 5.
      Table 5. Additional generation properties
      Field: Set the field to this value: Comment:
      Initial PFKey CLEAR This field specifies the PFKey that the CICS Service Flow Runtime issues before it executes the startup transaction.
      Startup Transaction Data EGUI
      Note: This is the transaction that runs the catalog sample application.
      This field specifies the name of the transaction that the CICS Service Flow Runtime runs to reach the first application screen in the sequence of application screens handled by the flow.
      Service (Blank) See the online help.
      Facility Like (Blank) See the online help.
      Facility Keep Time 300 This field specifies (in milliseconds) the maximum amount of time that a bridge facility will be kept if inactive.
      Wait Interval 4200000 This field specifies (in milliseconds) the maximum wait interval for message input.
      Deallocate Facility On Exit Always This field specifies whether the bridge facility is to be deactivated when the service flow terminates.
      Vector Logging Full This field specifies whether vector logging occurs and if so which type of vector logging.

  3. View the generation properties of one of the invoke nodes:
    Note: The default values that are already set for the generation properties in the invoke nodes are valid and do not have to be modified. However if you want to view the generation properties of one of the invoke nodes, follow the steps below.
    1. In the left pane of the editor area select the invoke node Dfh0xs1.Exmenu_Exmenu.

      The generation properties for the invoke node are displayed on the right side of the editor area.

    2. View the generation properties (see Table 6).
      Table 6. Generation properties
      Field: Set the field to this value: Comment:
      Invoke Type Link3270 Bridge This field specifies the invoke type, which here the editor forces to be the same value as the flow type.
      Activity Name Dfh0xs1.Exmenu_Exmenu This field specifies the name of operation that is to be run to handle the application screen.
      Comment (Blank) This field allows you to enter text describing the invoke node or make other notes.

  4. In the left pane of the editor area verify that an error symbol does not appear on the icon for the flow node or on the icons for any of the invoke nodes.

  5. Close the generation properties editor.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)