The DataQueueReader component can receive messages from AS400 Queues Synchronously and Asynchronously. In Synchronous mode, if Enable Scheduler is set to yes, it will poll queue for message at regular intervals. Else, message received on input port acts as a trigger to poll queue.
Configuration and Testing
The Configuration property sheet (CPS) of DataQueueReader is shown in Figure 1.
Figure 1: Sample DataQueueReader Configuration
The table below provides description for the properties in the CPS.
Property | Description |
|---|---|
Host Name | Hostname or IP of AS/400 Server. |
User Name | Username. |
Password | Password. |
Queue Name | Name of AS/400 Queue. The complete path of the Queue has to be provided. |
Queue Size(bytes) | Size of above mentioned AS/400 Queue. If you want to read data from a queue whose exact size is not known, you can set to -1 so that the component uses the maximum entry length. If it is set to -1, make sure that the queue is already created. |
Auto Create Queue | Create queue automatically if it does not exist. It will also try to create the library (FIORANO1.LIB in Figure 1) if it doesn't exist, but make sure the user has sufficient privileges. |
Receive Mode | Choose Asynchronous/ Synchronous mode of receiving messages. For Asynchronous mode and Synchronous with Scheduler enabled, the component will not have an input port. |
Wait Time(seconds) | Read timeout in seconds. Waits for the timeout specified to read messages from queue. Provide -1 for infinite timeout. |
Enable Scheduler? | If 'yes', then component runs in scheduling mode. This option is available only in Synchronous mode. If 'No' then message sent to input message acts as trigger to poll queue for message. |
Scheduler Interval(seconds) | Interval in which component polls queue for message. This option is available only in Synchronous mode and when the scheduler is enabled. |
Close Connection | If set to yes, then after receiving each message, connection will be closed. |
The configuration can be validated using the Validate button. A sample result of the Validate operation is shown below.
Figure 2: Validating the configuration
Input Port: In case of Synchronous mode with no scheduling, input port is generated. Any message sent to input port acts as a trigger for component to poll AS/400 queue for message.
Output Port: Receives Message read by the component.
Functional Demonstration
Configure DataQueueReader as shown in Figure 1.
Below figure shows a sample Event process, in which DataQueueReader listens to messages sent by DataQueueWriter.
Figure 3: Event process showing the DataQueueReader Component.
Sample Scenario
Sample Input
The Figure 4 shows the sample input from the Feeder.
Figure 4: Sending a sample text message from feeder to DataQueueWriter.
Sample Output
The Figure 5 shows the status messages sent by the DataQueueWriter component.
Figure 5: Status messages sent by the DataQueueWriter component
The Figure 6 shows the message received by DataQueueReader component.
Figure 6: Messages received by DataQueueReader.