IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > IBM i > Overview of WebSphere Adapter for IBM i > Technical overview > Outbound processing > Supported operations for data queues

GetQueue operation

The GetQueue operation retrieves a message from either first-in first-out (FIFO) or last-in first-out (LIFO) data queue or a keyed data queue.

To process the GetQueue operation for a FIFO or LIFO data queue, the adapter performs the following actions:

  1. Receives a request in the form of a business object that needs to retrieve a message.
  2. Fetches the message from the data queue by using the object path property in the interaction specification properties within the request. The object path is the absolute path of the data queue on the IBM i system.

    If the data queue is classified as a FIFO data queue, the adapter fetches the first message in the queue. If the data queue is classified as a LIFO queue, the adapter fetches the last message in the queue.

  3. Populates the request received in the form of a business object with the content of the message taken from the queue and returns it to the requesting component.

To process the GetQueue operation for keyed data queues, the adapter performs the following actions:

  1. Receives a request in the form of a business object from a component that needs to retrieve a message from a keyed data queue. The message key attribute in the request contains the key value required to access the message on the IBM i system.
  2. Fetches a message from the keyed data queue using the key value from the request and the object path property in the interaction specification properties. The object path is the absolute path of the data queue on the IBM i system.

    Because keyed data queues do not support a LIFO storage, the adapter always fetches the first message from the keyed data queue.

  3. Populates the business object with the content of the message corresponding to the key value taken from the keyed queue and returns it to the requesting component.

Supported operations for data queues