Receiving a Message from a WebSphere MQ Queue

Sybase WorkSpace enables you to receive a message from a specified end point in an WebSphere MQ queue. This message can be defined in a stored procedure or trigger.

Prerequisites 

To receive a message from a WebSphere MQ queue, you must have IBM WebSphere MQ running and an open Adaptive Server Enterprise connection profile with Real-Time Messaging configured. A message receiver/queue must be available in the WebSphere MQ server to serve as the endpoint, or destination, for the received message.

  1. From Enterprise Explorer, find the ASE connection profile.
  2. Select the procedural object for which you want to add messaging syntax.
    Procedural Object How to select
    Stored procedure Expand the Stored Procedures folder, right-click the procedure, and select Edit.
    Trigger Expand the Tables folder, expand the table, and then the Triggers folder. Right-click the trigger and select Edit.
  3. In the Source page, place the cursor in the desired location within the SQL code, right-click and select Sybase_ASE_15.x > Real-time Messaging Wizard .

    You can also open the wizard from the icon on the toolbar.

  4. Select Queue-related Functions (MQSeries) > Receive a Message, and click Next.
  5. Specify an ASE JMS provider name, and provide endpoint information.
    Field Description
    Host Name Endpoint host name
    Port Endpoint port number
    Queue Manager Endpoint queue manager
    Remote Queue Manager Remote queue manager
    Client Channel Endpoint client channel
    Queue Endpoint queue
  6. Click Next to specify message options.
  7. Enter the message options.
    Tab Description
    Options Choose a message type and enter a value in the Values field.
    Return Datatype Choose a return datatype.
  8. Click Finish.
    Note: Because ASE messaging constructs are functions, select appears before the messaging construct. You can also assign the messaging function to a local variable that has already been declared.
Related concepts
Real-Time Messaging Services
Mapping Functions
Related tasks
Sending a Message to a JMS Queue
Receiving a Message from a JMS Queue
Sending a Message to a WebSphere MQ Queue
Publishing a Message to a Topic
Subscribing to a Topic
Consuming a Message from a Topic
Unsubscribing from a Topic
Registering a Subscription
Parsing an XML Document
Retrieving XML Message Properties
Related reference
Select for XML Statements

Send your feedback on this help topic to Sybase Technical Publications: pubs@sybase.com

Your comments will be sent to the technical publications staff at Sybase, Inc. For product-related issues or technical support, contact Sybase Technical Support at 1-800-8SYBASE.