8.5.12 MQ-Series Directives

Data will be sent as an MQ-Series message.

This option requires the IBM MQ-Series Java Client files to be available.

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

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

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

Keyword

Comments

mq.name

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

mq.host

MQ-Series server name.

mq.port

Server port.
Default. 1414.

mq.user

Logon user or *prompt.

mq.password

Login password.

mq.channel

Name of the MQ-Series communications channel.

mq.queue.manager

Name of the MQ-Series queue manager or *default for default queue manager.

mq.queue

Name of the MQ-Series queue.

mq.encoding

Encoding of the text message, *cssid to use the mq.ccsid value or *none for no encoding.

mq.ccsid

Character set encoding id of the message.
Encoding properties that use the value *ccsid, use the Java encoding equivalent of this value.

mq.format

Message format. *none for no format, *default for MQSTR if content type is of type text else no format, or user-defined format. 8 characters.

mq.priority

Message priority. Default. 0.

mq.persistent

Message persistent. *yes, *no, or *default.

mq.userid

Message user id. 12 characters.

mq.expiry

Message expiry in tenths of seconds.
Default. *unlimited for never expires.

mq.applicationid

Message application id. 32 characters.

mq.type

Message type. *datagram or number specifying the message type.
Default. *datagram
User defined range is 65536 to 999999999.

mq.messageid

Message Id. *default or 24 characters.
Default. *none. The message id is automatically created.
The value is padded with spaces to create a value 24 characters in length

mq.correlationid

Correlation Id. *default or 24 characters.
Default. *none.
The value is padded with spaces to create a value 24 characters in length.

mq.id.encoding

Message and Correlation Id encoding.
Default.*ccsid.
The encoding used to convert the Unicode value into bytes. Only the first 24 bytes are used.

mq.reply.queue

Reply Queue.

mq.reply.queue.manager

Reply Queue Manager.

mq.method

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

mq.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:

#

# MQSeries Directives

#

mq.name=Message queue

mq.host=server1

mq.port=1414

# mq.user=user

# mq.password=password

mq.queue=USERAGENT.QUEUE

mq.channel=USERAGENT.CHANNEL

mq.queue.manager=USERAGENT.QUEUE.MANAGER

mq.ccsid=37

mq.encoding=Cp037

 

The mq.ccsid sets the CCSID of the MQ message header, if no mq.ccsid then "0" is used, which means to use the queue manager default value.

If the file content is of type text, then the Unicode content is encoded to bytes using the mq.encoding value.

If no mq.encoding then the standard UserAgent local / remote encoding rules apply.