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:
- An input message is used to pass data to the invoked nonterminal
application.
- An output message is used to receive data from the invoked
nonterminal application on a normal return.
- One or more faults messages are used to receive data from
the invoked nonterminal application on an abnormal return.
(See
Basic information about operations.)
If you do not want to create an operation at this time:
- Do not select the check box Create PL/I program definitions.
- 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:
Select the check box Create PL/I program definitions.
Specify the operations file in which you want to store the
new operations:
- 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.
- Alternatively, to add the new operations to an existing operations
file, select Existing File and select a file
from the list box.
To create an operation:
- 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.
- 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.
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.
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)).
- Click the Select button to the right of
the label Input Data.
The Select
Message window opens.
- 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).
- 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.
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)).
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.
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).
To create additional operations for the same operation file,
follow the same steps that you followed in step 3.
Click Next to go to the next page of
the wizard or click Finish to close the wizard.
If you click
Finish:
For each operation that you specified on the Create
PL/I programs page:
- Messages and message files:
- The wizard creates a new message for each of the data structures
that you specified for:
- Input Data
- Output Data
- Fault Data (if present).
- The wizard stores each new message in a new message file.
- The wizard stores each new message file in the Messages folder
of the subproject that you specified on the first page of the wizard.
- Operations and operations files:
- 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.
- 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).
- The wizard closes.
- You can now use the new operation: