Adapter for IBM Power 10.11 | Adapter Services | Configuring Read DataQueue Services
 
Configuring Read DataQueue Services
A Read DataQueue service retrieves specified information from an IBM Power dataqueue. 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 Read DataQueue 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 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:
a. Use the Insert row icon to create new rows as needed.
b. 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.
c. If necessary, use the Up or Down icons to change the order.
d. Use the Delete icon to delete the row.
8. From the File menu, select Save.