8.4.11 JMS Directives

Data will be sent as a JMS message.

Depending on the message broker vendor, this option requires the IBM MQ-Series Java Client files, SonicMQ, ActiveMQ or Tibco Enterprise Messaging Service files to be available.

If jms.user=*prompt then an authentication dialog is displayed with blank fields.

If jms.user=remoteuser then an authentication dialog is displayed with remoteuser in the user field.

If jms.user=remoteuser and jms.password=passphrase then no authentication dialog is displayed.

Keyword

Comments

jms.name

Description name displayed in the User Agent's Send message box.

jms.vendor

Message Vendor. activemq | sonicmq | tibcomq | webspheremq.

jms.host

Message server name.

jsm.port

Server port. The default port is dependent on vendor.
61616 for ActiveMQ
2506 for SonicMQ
7222 for TibcoMQ (Tibco Enterprise Messaging Service)
1414 for WebSphereMQ.

jms.user

Logon user or *prompt.

jms.password

Login password.

jms.queue

Name of the queue.

jms.channel

Name of the WebSphereMQ communications channel.
Only required for WebSphereMQ.

jms.queue.manager

Name of the WebSphereMQ queue manager.
Only required for WebSphereMQ.

jms.priority

Message priority.
Default. 4.

jms.persistent

Message persistent. *yes or *no.
Default. *yes.

jms.expiry

Message expiry in milliseconds.
Default. *unlimited for never expires.

jms.clientid

Message client identifier.

jms.method

Get or put message. The default is to put a message.
GET
PUT

jms.waittime

This is used with the get method to specify how long to wait for a message. The default is 2000 milliseconds.

 

 

MQ-Series IBM i configuration

The following i5/OS commands will create the necessary MQ-Series objects to receive the posted content:

 

GO CMDMQM

STRSBS QMQM/QMQM

CRTMQM MQMNAME(USERAGENT.QUEUE.MANAGER)

STRMQM MQMNAME(USERAGENT.QUEUE.MANAGER)

CRTMQMQ QNAME(USERAGENT.QUEUE) QTYPE(*LCL) MQMNAME(USERAGENT.QUEUE.MANAGER)

CRTMQMCHL CHLNAME(USERAGENT.CHANNEL) CHLTYPE(*SVRCN) MQMNAME(USERAGENT.QUEUE.MANAGER)

STRMQMCHL CHLNAME(USERAGENT.CHANNEL) MQMNAME(USERAGENT.QUEUE.MANAGER)

STRMQMLSR MQMNAME(USERAGENT.QUEUE.MANAGER)

 

The following directives will put the file content into the MQ-Series message queue:

 

#

# JMS Directives

#

jms.name=Message queue

jms.host=server01

jms.port=1414

# jms.user=user

# jms.password=password

jms.queue=USERAGENT.QUEUE

jms.channel=USERAGENT.CHANNEL

jms.queue.manager=USERAGENT.QUEUE.MANAGER