Rational Developer for System z

2. Create PL/I Programs

The second page of the Import PL/I Files wizard, titled Create PL/I programs, allows you to create one or more operations that use messages that you imported on the first page of the wizard.
Recall that an operation is an artifact that contains the information required to invoke a flow or to invoke a nonterminal application. Typically an operation includes one or more references to messages that are used to pass data to or from the flow or nonterminal application when it is invoked: (See Basic information about operations.)

If you do not want to create an operation at this time:
  1. Do not select the check box Create PL/I program definitions.
  2. Click Next to go to the next page of the wizard or click Finish to generate the message files and close the wizard.
Note: You can also use the operations editor to create or modify an operation (see Operations editor).

If you do want to create an operation at this time:

  1. Select the check box Create PL/I program definitions.

  2. Specify the operations file in which you want to store the new operations:
    1. To create a new operations file, select the New File radio button and type the name of the file in the input field to the right. (You can either specify the extension .wsdl now or leave it off and let the wizard add it later.) The new file is created in the Operations folder of the subproject that you selected on the first page of the wizard.
    2. Alternatively, to add the new operations to an existing operations file, select Existing File and select a file from the list box.

  3. To create an operation:
    1. Click Add Program to create a new, empty operation.
      Note: The wizard adds an empty operation with the default name program to the list box.
    2. In the Program input field (called the Interface Operation field if you specified the interface subproject on the first page of the wizard) type the name that you want to use for the operation (such as NontermApp_02) and press the Enter key.

      The wizard renames the new program 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: This list box is not available when you select the interface subproject in the Project Name list box of the Import PL/I Files page of the wizard.
      Note: When the Communication Type is LINK with Channel you can add multiple messages to the Input Data and to the Output Data.
    4. To select an input message for the new operation:
      Note: If the list box Communication Type is set to LINK with Channel, then you can select multiple input messages (see step 3(c)).
      1. Click the Select button to the right of the label Input Data.

        The Select Message window opens.

      2. In the Select Message window, select the message that you want to use as the input message.
        Note: Notice that the only messages available for selection at this time are messages created from the PL/I source files that you specified on the first page of the wizard. After you close the wizard, you can still add other messages by opening the operations file created by the wizard with the operations editor and adding the messages (see Operations editor).
      3. Click OK.

        The Import PL/I Files wizard displays the name of the message in the field to the right of the label Input Data.

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

    6. To select a fault message for the operation, click the Select button to the right of the label Fault Data and follow the same steps that you followed for the input message in step 3(d).

      Note: The Fault Data option is available only if you selected the interface subproject on the first page of the wizard.

    7. To view or modify the generation properties for the operations, click the Specify Generation Properties button to open the Specify Generation Properties window.

      Note: The Generation Properties button is not available if you selected the interface subproject on the first page of the wizard.
      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.

      You can modify these default generation properties later in the generation properties editor (see Step A2. Edit the generation properties file for the main flow).

  4. To create additional operations for the same operation file, follow the same steps that you followed in step 3.

  5. Click Next to go to the next page of the wizard or click Finish to close the wizard.

If you click Finish:
  1. For each operation that you specified on the Create PL/I programs page:

    1. Messages and message files:
      1. The wizard creates a new message for each of the data structures that you specified for:
        • Input Data
        • Output Data
        • Fault Data (if present).
      2. The wizard stores each new message in a new message file.
      3. The wizard stores each new message file in the Messages folder of the subproject that you specified on the first page of the wizard.

    2. Operations and operations files:
      1. The wizard creates a new operation from the information that you specified in the Specify Properties group:
        • The wizard sets the name of the new operation to the value that you specified in the Program (or Interface Operation) field.
        • The wizard sets the input message, output message, and faults message of the new operation to reference the new messages that the wizard just created.
      2. The wizard stores the new operation:
        • In the new operations file (if you specified a new operations file).
        • In the existing operations file (if you selected an existing operations file).
  2. The wizard closes.
  3. You can now use the new operation:


Terms of use | Feedback

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