Creating call commands and call programs

The Call command runs a command in the IBM® Power system and the Call program runs a program in the IBM Power system.

1. In the Flow services page, click + icon to create a new deploy anywhere flow service.
2. Select Deploy Anywhere Flow Service and click Create.
3. Provide a name and description for the deploy anywhere flow service. The description is optional.
4. Select a Runtime on which you run a deploy anywhere flow service from the list.
5. Type i to select the IBM Power connector on the flow service step.
6. In the Type to choose action box, click Add Custom Operation. The Connect account page is displayed.
7. Create an account that can be used to access IBM Power Systems in the Account page.
   • Enter the name and description for the action.
   • Select the runtime on which the action or account is deployed. By default, the selection on the Flow Editor page is considered. However, if you change the Runtime on Add account wizard, the connection is redeployed.
     Note: The runtime that is selected in the Default runtime field takes precedence during the connection redeployment.
   • Select the IBM Power account.
   • Click Next.
8. Select the Call Command or Call Program action in the Action page. Click Next.
9. If you have selected Call Command in the Action page, provide the details in the Command page.

   Library name

   The field is optional. Name of the library where the command exists. Type the library name or select from the library list (containing user, system, and other libraries added). The default is *LIBL.

   Command name

   Name of the command to call.

   • Click the + icon to add the parameters, which must be passed to the command.
   • Provide the details to the fields in the Add Parameter page.

     Name

     The name of the parameter to pass when the command is called.

     Value

     Value associated with the parameter. You can specify the parameter value either in the field or at runtime. If you want to provide the value at runtime, then include ? in the Value field.

   • Click Add. The Command page is displayed with the parameters listed.
   • Click Next. The Overview page is displayed.
10. If you have selected Call Program in the Action page.
    • Provide the details pt the fields in the Program page.

      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.

      Inquire message reply

      Option to indicate how the program must respond to inquiry messages. 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 the system reply list to see whether an entry for an inquiry message that is 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.

    • Click Next. The Input page is displayed. Provide the details to the fields in the appears Input page.

      Input parameter name

      The 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 whether the parameter value is an array.

      Input data type

      List of possible Java™ data types that depends 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 at runtime. If you want to provide the value at runtime, then include a ? in the Parameter value field.

    • Click Next. The Output page is displayed. Provide the details to the fields in the Output page.

      Output parameter name

      The name of the output parameter returned when the program is called.

      Native data type

      List of IBM Power native data type for the parameter.

      Is array

      Flag to indicate whether the parameter value is an array. The default value is 1.

      Data occurrence

      Number of elements in the array if Is array is selected.

      Output data type

      List of possible Java data types that depend on the Native data type and the Is array field selection.

      Output data length

      Length in bytes of the output data value.

      Note: To use a parameter as both an input and an output, include it on both the Input and Output pages by using the same parameter name.
    • Click Next. The Overview page is displayed.