Creating read and write dataQueues

The Read Data Queue retrieves records from the specified data queue and the Write Data Queue writes records into the specified dataqueue.

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 field is optional. Example, GetCustomerInfo.
4. Sselect a runtime on which you run a deploy anywhere flow service from the list.
5. Type IBM Power on the flow service step to select the IBM® Power connector.
6. Click Add Custom Operation in the Type to choose action box.
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 the 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 Read DataQueue or Write DataQueue action in the Action page.
9. Click Next.
10. Provide data queue details in the Data queue page.

    Library name

    Name of the library where the dataqueue exists. Type the library name or select from the library list (containing user, system, and other libraries added).

    Queue name

    Name of the dataqueue.

    Operation type

    Type of read operation. Available in Read DataQueue alone. The possible values are Read and Peek. Read reads a record from the dataqueue and removes it. If no records exist, it returns nothing. Peek reads a record from the dataqueue without removing it. If no records exist, it returns nothing.

    Read timeout (sec)

    Time in seconds to wait when the dataqueue is empty. Specify -1 to wait until a record becomes available. Available in Read DataQueue alone.

    Queue type

    Type of dataqueue. The possible values are Sequential and Keyed. Sequential means that the dataqueue is organized in a linear or sequential order. Keyed means that the dataqueue is organized as key-value pairs, allowing direct access to messages based on a specific identifier (key).

    Key type

    List of the IBM Power native data types in which the key is stored in the dataqueue if the Queue type is Keyed.

    Key input type

    List of the possible Java™ data types corresponding to the Keyed selected, if the Queue type is Keyed.

    Key length

    Length of the key in bytes if the Queue type is Keyed

    Key value

    Value of the key if the Queue type is Keyed.

    Key compare type

    Type of comparisons used to run on the Key value if the Queue type is Keyed. Available in Read DataQueue alone. The possible values are EQ (Equal), NE (Not equal), LT (Less than), LE (Less than or equal), GT (Greater than), and GE (Greater than or equal).

11. Click Next. The Record page is displayed.
12. Click Add Record and provide the details to the fields in the Record page.

    Data name

    Name of the record to be stored in or retrieved from the dataqueue.

    Native data type

    List of IBM Power native data types for the record.

    Byte length

    Length in bytes of the data value.

    Is array

    Flag to indicate whether the data value is an array.

    Input data type

    List of possible Java data types that depend on the Native data type and the Is array fields selection. Available in Write DataQueue alone.

    Data occurrence

    Number of elements in the array if Is array is selected. Available in Read DataQueue alone.

    Output data type

    List of possible Java data types that depends on the Native data type and the Is array fields selection. Available in Read DataQueue alone.

    Data value

    Value of the record to store in the dataqueue. You can specify the data value either in the field or at runtime. If the intention is to provide the value at runtime, then add ? to the Data value field. Available in Write DataQueue alone.