Rational Developer for System z

4A. Specify existing program definitions

If you selected the Aggregating COMMAREA, Channel, and/or Queueing applications radio button on the third page of the New Service Flow Project wizard, then the fourth page of the wizard is the Specify existing program definitions page, which allows you to create a flow containing a sequence of Invoke nonterminal nodes, each node invoking a particular nonterminal application.
Note: This page of the New Service Flow Project wizard is similar in function to parts of the Import COBOL Files wizard and the Import PL/I Files wizard. If you want to add an invocation of a nonterminal application to a flow after you have created the service flow project, use the Import COBOL File wizard or the Import PL/I Files wizard.

To create a flow containing a sequence of Invoke nonterminal nodes (see Invoke nodes in the flow editor), each node invoking a particular nonterminal application:

  1. For each Invoke nonterminal node that you want to add to the flow:
    1. Click Add to create a new, empty operation.
      Note: The wizard adds an empty operation with the default name Program to the Program Definitions list box.
    2. In the Program input field, type the name that you would like to use for the operation (such as NontermApp_02) and press the Enter key.

      The wizard renames the new operation in the list box to match the name that you specified.

    3. In the Communication Type field, select an invoke type for the new operation:
      • LINK with COMMAREA
      • LINK with Channel
      • WebSphere MQ
      Note: When the Communication Type is LINK with Channel you can add multiple messages to the Input Data and to the Output Data. The multiple messages become containers in the channel that the LINK with Channel invocation passes to the invoked nonterminal application.
    4. To select an input message to be used when invoking the nonterminal application:
      Note: If the list box Communication Type is set to LINK with Channel, then you can select multiple input messages (see step 1(c)).
      1. Click the Select button to the right of the Input Data field.

        The Select a language element window opens.

      2. In the Select a language element window, select a message that you want to use as an input message.
        Note: Notice that the only messages available for selection at this time are messages created from the COBOL and PL/I source files that you added to the COBOL and PL/I files to import list box.
      3. Click OK.

        The wizard displays in the Input Data field the name of the name of the input message.

    5. To select an output message to be used when invoking the nonterminal application, click the Select button to the right of the Output Data field and follow the same steps that you followed for the input message in step 1(d).
      Note: If the list box Communication Type is set to LINK with Channel, then you can select multiple output messages (see step 1(c)).

    6. To view or modify the generation properties for the Invoke nonterminal node that is to be created, click the Specify Generation Properties button to open the Specify Generation Properties window.

      For information about the fields in the Specify Generation Properties window see the topics listed below:
      The values that you specify here in the Specify Generation Properties window become the default values for the generation properties associated with this program definition.
      • More specifically, the values that you specify become the default values for the generation properties of any invoke node [an invoke node resides in a generation properties file] that corresponds to an Invoke node [an Invoke node resides in a flow file] that uses this program definition to invoke the nonterminal application specified in the program definition -- see Flow nodes and invoke nodes in the generation properties editor.
      • When you open the generation properties file, the generation properties for such invoke nodes are prepopulated with the values that you specify here.
      • This feature is a convenience that allows you to specify the generation properties for this program definition now while the characteristics of the program (the nonterminal application specified in this program definition) are fresh your mind.

    7. To change the order in which the Invoke nonterminal node that is to be created from the operation is displayed in the flow:
      1. Select the name of the operation in the Program Definitions list box.
      2. Use the Move Up or Move Down buttons to change the location of the operation in the list.
    8. Set or clear the check box Connect program nodes in specified order.
      • Set the check box if you want the wizard to connect the Invoke nonterminal nodes in the flow. This feature is a convenience that saves you the work of connecting the nodes manually in the flow editor.
      • Clear the check box if you do not want the wizard to connect the Invoke nodes.

  2. Click Next to go to the next page of the wizard (see 5. COBOL import settings and 6. PL/I import settings) or click Finish to terminate the wizard and create the new service flow project.

  3. When the wizard creates the flow for the new service flow project, then for each operation that you created on the Specify existing program definitions page of the wizard:
    1. In the Messages folder of the new service flow project's nonterminal applications subproject the wizard creates an input message and an output message based on the data structures that you specified for the operation, stores the input message into a new message file, and stores the output message into a new message file.
    2. In the Operations folder of the new service flow project's nonterminal applications subproject, the wizard creates an operations file and stores the new operation in it. The new operation has references to the message files containing its input message and output message.
    3. In the new flow the wizard adds an Invoke nonterminal node and binds it to the new operation:
      Invoke nonterminal node
      The gear wheel displayed in the lower right corner of the Invoke icon indicates that the Invoke node invokes a nonterminal application.

  4. When the wizard terminates, the Enterprise Service Tools opens the new flow with the flow editor.


Terms of use | Feedback

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