Creating JMS Event

The JMS Event enables you to specify when and how frequently the process flow should be executed if any message is updated in a queue or topic of a JMS Server.

This feature is available in:

Prerequisites

• JMS Provider activity must be created before creating JMS Event activity.

Steps to create a JMS Event

1. On the Adeptia Suite homepage, click the Develop tab.

2. Go to Events > JMS.

   The Manage JMS Event screen is displayed.

   

    

3. Click Create New. The Create JMS Event screen is displayed.
4. Enter the name for the new JMS Event in the textbox Name. Then, enter the description for the JMS Event in the textbox Description.

5. Select the JMS Provider activity from the drop-down list JMS Provider.

6. Select the Connection Type as either Topic or Queue from the drop-down list Connection Type.
7. Select the Durable Subscriber checkbox if the JMS Subscriber is durable. If a client needs to receive all the messages published on a topic, including the ones published while the subscriber is inactive, it uses a Durable Subscriber. This is applicable only when the connection type is Topic.
8. Enter the subscriber ID in the textbox Subscriber ID.
9. Enter the name of queue or topic as configured in the JMS Server in the Queue Or Topic Name field.
10. Select the type of message, which you want to fetch, from the Message Type drop-down list. You can select:
    1. Text
    2. Byte
    3. Both

11. If you want to select a specific message from the JMS Server, enter the message selector in the Message Selector field.

    The message selector is used to specify the filter criterion to receive a message that the user is interested in. The messages can be filtered based on only header references and properties references of the message. The message selector uses SQL92 query syntax to define the filter criteria. SQL92 is widely used to query the entire standard databases i.e. Oracle, SQL Server. The only difference between the database query and the message selector query is that the message selector uses, only a part of the query which is after the where clause. 
    
    The following message selector selects messages with a message type of car and color of blue and weight greater than 2500 pounds: 
    
    JMSType = 'car' AND color = 'blue' AND weight > 2500 
    
    The following message selector selects message with the property Sport has value either as Basketball or Football. 
    Sport in ('Basketball','Football')

12. Enter the username and password required to connect to JMS Server in the UserName and Password text boxes respectively.
    Then, re-enter the password in the Confirm Password text box.

    

     

    For information on Advanced Properties, refer to Changing Advanced Properties.
     
    For information on how to enable email error notification, refer to Creating Email Error Notification.

13. Select the JMS session behavior from the Session drop-down list. This drop-down list has the following options: 
    • • Transactional: If you select the session behavior to be transactional, then your message will not be lost even if it was not successfully sent via the server or received at the client end. However, then you will be required to put your process flow in the JTA Begin and End block in Process Flow Designer. For this, it is mandatory to set the value of JMS Source property jtaEnlist (added in the Properties Panel of the Process Flow Designer) to true. By default, its value is false.
     
    • • Non-Transactional: The default session behavior is non-transactional. In a non-transactional JMS session, your message will not be saved and therefore will not be available if in any case it has not been able to successfully sent via the server or received at the client end.
        If you select the respective JMS session to be transactional, you need to set the value of the following additional fields. Perform the following steps for the same. These fields are not available for a non-transactional JMS session.
14. Enter the date from which JMS event will start triggering; in the Event Start Date field. The date must be in mm/dd/yyyy format. Click Calendar icon and select the required date from the calendar.
15. Enter the start time from the Time drop-down list.
16. Enter the date on which JMS event will stop triggering, in the Event Expiry Date field. The date must be in mm/dd/yyyy format. Click the calendar icon and select the required date from the calendar.
17. Enter the expiry time from the Time drop-down list.

18. Enter the time interval, the JMS event checks the database Server in the Polling Frequency field. Enter the digit in the Frequency field and select the unit of time i.e. seconds, minutes or hours etc. from the Duration drop-down list.

    We recommended minimum Polling Frequency to be more than 60 seconds.

     

     
    
    
    

    You can view details of a process flow associated with a JMS event, by clicking the process flow displayed under Associated Process Flows on the Manage JMS Event screen.

19. Click Save.