Configuring Read DataQueue Services

About this task

A Read DataQueue service retrieves specified information from an IBM Power dataqueue. You configure 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 Read DataQueue service:

Procedure

  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 IBM 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 Read DataQueue template and click Finish.

    The adapter service editor 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 Read DataQueue tab to configure the dataqueue using the fields as follows:
    Field Description/Action
    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 from where the adapter service reads.
    Operation Type Type of read operation. Possible values are:
    • Read. Read a record from the dataqueue and remove it from the dataqueue. If no record exists in the dataqueue, then return.
    • Peek. Read a record from the dataqueue without removing it from the dataqueue. If no record exists in the dataqueue, then return.
    Read Timeout (sec) Time in seconds to wait if the dataqueue is empty. Specify -1 to wait until a record becomes available.
    Queue Type Type of dataqueue. Possible values are:
    • Sequential. Dataqueue organized in a linear or sequential (FIFO or LIFO) order.
    • Keyed. Dataqueue organized as key-value pair. The key-value pair allows direct access to messages based on the 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 Key Type 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 to perform on the Key Value if the Queue Type is Keyed. Possible values are:
    • EQ. Equal.
    • NE. Not equal.
    • LT. Less than.
    • LE. Less than or equal.
    • GT. Greater than.
    • GE. Greater than or equal.
  7. Use the Record Metadata tab to define the metadata and fields to be selected as follows:
    1. Use the Insert row icon to create new rows as needed.
    2. As you insert rows, the following fields are displayed for each Data Name:
      Field Description/Action
      Data Name Name of the record.
      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 if the data 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 the possible Java data types depending on the Native Data Type and the Is Array fields selection.
    3. If necessary, use the Up or Down icons to change the order.
    4. Use the Delete icon to delete the row.
  8. From the File menu, select Save.