8.5.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. |
jms.user |
Logon user or *prompt. |
jms.password |
Login password. |
jms.queue |
Name of the queue. |
jms.channel |
Name of the WebSphereMQ communications channel. |
jms.queue.manager |
Name of the WebSphereMQ queue manager. |
jms.priority |
Message priority. |
jms.persistent |
Message persistent. *yes or *no. |
jms.expiry |
Message expiry in milliseconds. |
jms.clientid |
Message client identifier. |
jms.method |
Get or put message. The default is to put a message. |
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