Adapter for IBM Power 10.11 | Adapter Services | Configuring Call Program Services
 
Configuring Call Program Services
A Call Program service runs an IBM Power program in the IBM Power system. You can pass input parameters to the program and specify output parameters to capture data returned by the program after it runs. Call Program services are typically used for invoking server programs written in languages such as RPG or COBOL. You configure webMethods Adapter for IBM Power services using Designer. For more information about adapter services, see Adapter Services.
Be sure to review the section Before Configuring or Managing Adapter Services before you configure adapter services.
*Perform the following steps to configure a Call Program service:
1. In Designer, right-click the package in which the service must be created and select New > Adapter Service.
2. Select the parent namespace, type a name for the adapter service, and click Next.
3. Select webMethods Adapter for IBM Power as the adapter type and click Next.
4. Select the appropriate Adapter Connection Name and click Next.
5. From the list of available templates, select the Call Program template and click Finish.
The adapter service editor for the adapter service appears. You can select the Adapter Settings tab at any time to confirm adapter service properties such as the Adapter Name, Adapter Connection Name, and Adapter Service Template, as necessary.
6. Select the Program tab to configure the program using the fields as follows:
Field
Description/Action
Library Name
Name of the library where the program exists. Type the library name or select from the library list (containing user, system, and other libraries added).
Program Name
Name of the program to call.
Inquiry Message Reply
Option to indicate how the program must respond to inquiry messages. Possible values are:
*INQUIRY_MESSAGE_REPLY_DEFAULT. Sends the default reply message to respond to any inquiry received while the program is running. The default reply is either defined in the message description or is the default system reply.
*INQUIRY_MESSAGE_REPLY_SYSTEM_REPLY_LIST. Checks system reply list to see if there is an entry for an inquiry message issued while the program is running. If a match occurs, the system sends the reply value for that entry. If no entry exists for that message, the system sends an inquiry message.
7. Select the Parameters tab to configure the parameters as follows:
a. Use the Insert row icon to create new rows as needed.
b. As you insert rows, the following fields are displayed for each input parameter:
Field
Description/Action
Input Parameter Name
Name of the input parameter to pass when the program is called.
Native Data Type
List of IBM Power native data types for the parameter.
Byte Length
Length in bytes of the input parameter value.
Is Array
Flag to indicate if the parameter value is an array.
Input Data Type
List of possible Java data types depending on the Native Data Type and the Is Array field selection.
Parameter Value
Value associated with the parameter. You can specify the parameter value either in the field or during runtime. If you want to provide the value at runtime, then include a ? in the Parameter Value field.
You can pass input parameters to the program.
c. As you insert rows, the following fields are displayed for each output parameter:
Field
Description/Action
Output Parameter Name
Name of the output parameter returned when the program is called.
Native Data Type
List of IBM Power native data types for the parameter.
Is Array
Flag to indicate if the parameter value is an array.
Data Occurrence
Number of elements in the array if Is Array is selected. Default value is 1.
Output Data Type
List of possible Java data types depending on the Native Data Type and the Is Array field selection.
Output Data Length
Length in bytes of the output data value.
You can capture data returned by the program in the output parameters after it runs.
Note:
If you want to specify a parameter as both input and output, add the parameter in the input section as well as in the output section with the same parameter name.
d. If necessary, use the Up or Down icons to change the order of the parameters to ensure that they are parsed in the correct order.
e. Use the Delete icon to delete a parameter.
8. From the File menu, select Save.