{"id":6516,"date":"2017-03-02T11:21:16","date_gmt":"2017-03-02T03:21:16","guid":{"rendered":"http:\/\/rmohan.com\/?p=6516"},"modified":"2017-03-02T11:21:16","modified_gmt":"2017-03-02T03:21:16","slug":"dead-letter-queues","status":"publish","type":"post","link":"https:\/\/mohan.sg\/?p=6516","title":{"rendered":"Dead-letter queues"},"content":{"rendered":"

Dead-letter queues
\nA dead-letter (undelivered-message) queue is a queue that stores messages that cannot be routed to their correct destinations.
\nThis occurs when, for example, the destination queue is full. The supplied dead-letter queue is called SYSTEM.DEAD.LETTER.QUEUE.
\nFor distributed queuing, define a dead-letter queue on each queue manager involved.<\/p>\n

It is defined on the queue manager in the queue to be saved if the message can not be stored in the specified destination.
\nAs an example it is stored in the dead-letter queue if the destination is queueful.
\nIf you can not put it in the Dead-letter queue, the channel stops and the message remains in the transmission queue.<\/p>\n

Dead-letter queue definition<\/p>\n

We have already defined the Dead-letter queue called DLQ at the previous article (distributed queuing).<\/p>\n

DEF QL (DLQ) REPLACE
\nALTER QMGR DEADQ (DLQ)<\/p>\n

In the case of
\nDEF QL (DLQ) REPLACE
\nALTER QMGR DEADQ (DLQ)<\/p>\n

Check dead-letter queue operation<\/p>\n

By putting QL.A put on DISABLED on the queue manager QMW to create a state that can not be put into QL.A and sending a message from QMC, the message is stored in the Dead-letter queue on the QMW .<\/p>\n

As a preparatory step, execute the following command on QMW on the mqsc interface.<\/p>\n

CLEAR QL (QL.A)
\n15: CLEAR QL (QL.A)
\nAMQ 8022: WebSphere MQ queue cleared.
\nCLEAR QL (QL.B)
\n16: CLEAR QL (QL.B)
\nAMQ 8022: WebSphere MQ queue cleared.
\nCLEAR QL (DLQ)
\n17: CLEAR QL (DLQ)
\nAMQ 8022: WebSphere MQ queue cleared.
\nALTER QL (QL.A) PUT (DISABLED)
\n18: ALTER QL (QL.A) PUT (DISABLED)
\nAMQ 800: WebSphere MQ queue changed.
\nIn the case of
\nCLEAR QL (QL.A)
\n15: CLEAR QL (QL.A)
\nAMQ 8022: WebSphere MQ queue cleared.
\nCLEAR QL (QL.B)
\n16: CLEAR QL (QL.B)
\nAMQ 8022: WebSphere MQ queue cleared.
\nCLEAR QL (DLQ)
\n17: CLEAR QL (DLQ)
\nAMQ 8022: WebSphere MQ queue cleared.
\nALTER QL (QL.A) PUT (DISABLED)
\n18: ALTER QL (QL.A) PUT (DISABLED)
\nAMQ 800: WebSphere MQ queue changed.<\/p>\n

Subsequently, from QMC put the message in amqsput to the remote queue definition (referring to QL.A in QMW).<\/p>\n

$ Amqsput QRMT.A QMC
\nSample AMQSPUT 0 start
\nTarget queue is QRMT.A
\nI send a message from QMC.<\/p>\n

Sample AMQSPUT 0 end
\n$ Amqsbcg QL.A QMW<\/p>\n

AMQSBCG 0 – starts here
\n**********************<\/p>\n

MQOPEN – ‘QL.A’<\/p>\n

No more messages
\nMQCLOSE
\nMQDISC $<\/p>\n

$ Amqsput QRMT.A QMC
\nSample AMQSPUT 0 start
\nTarget queue is QRMT.A
\nI send a message from QMC.<\/p>\n

Sample AMQSPUT 0 end
\n$ Amqsbcg QL.A QMW<\/p>\n

AMQSBCG 0 – starts here
\n**********************<\/p>\n

MQOPEN – ‘QL.A’<\/p>\n

No more messages
\nMQCLOSE
\nMQDISC $
\n$<\/p>\n

However, since QL.A on QMW can not be PUT, the message does not reach QL.A, and the message is stored in the dead-letter queue.<\/p>\n

DIS QL (DLQ) CURDEPTH
\n19: DIS QL (DLQ) CURDEPTH
\nAMQ 8409: Display Queue details.
\nQUEUE (DLQ) TYPE (QLOCAL)
\nCURDEPTH (1)<\/p>\n

In the case of
\nDIS QL (DLQ) CURDEPTH
\n19: DIS QL (DLQ) CURDEPTH
\nAMQ 8409: Display Queue details.
\nQUEUE (DLQ) TYPE (QLOCAL)
\nCURDEPTH (1)<\/p>\n

Use amqsbcg to check the Dead-letter header.<\/p>\n

$ Amqsbcg DLQ QMW<\/p>\n

AMQSBCG 0 – starts here
\n**********************<\/p>\n

MQOPEN – ‘DLQ’<\/p>\n

MQGET of message number 1
\n**** Message descriptor ****<\/p>\n

StrucId: ‘MD’ Version: 2
\nReport: 0 Msg Type: 8
\nExpiry: -1 Feedback: 0
\nEncoding: 546 CodedCharSetId: 819
\nFormat: ‘MQDEAD’
\nPriority: 0 Persistence: 0
\nMsgId: X’414D5120514D432020202020202020209093F25002510020 ‘
\nCorrelId: X’00000000000000000000000000000000000000000000000000 ‘
\nBackoutCount: 0
\nReplyToQ: ”
\nReplyToQMgr: ‘QMC’
\n** Identity Context
\nUserIdentifier: ‘mqm’
\nAccountingToken:
\nX’0334393600000000000000000000000000000000000000000000000000000006 ‘
\nApplIdentityData: ”
\n** Origin Context
\nPutAppl Type: ‘6’
\nPutApplName: ‘amqsput’
\nPutDate: ‘20130114’ PutTime: ‘11241665’
\nApplOriginData: ”<\/p>\n

GroupId: X’00000000000000000000000000000000000000000000000000 ‘
\nMsgSeqNumber: ‘1’
\nOffset: ‘0’
\nMsgFlags: ‘0’
\nOriginalLength: ‘-1’<\/p>\n

**** Message ****<\/p>\n

Length – 198 bytes<\/p>\n

00000000: 444 C 4820 0100 0000 0308 0000 514 C 2 E 41 ‘DLH …….. QL. A’
\n00000010: 2020 2020 2020 2020 2020 2020 2020 2020 ”
\n00000020: 2020 2020 2020 2020 2020 2020 2020 2020 ”
\n00000030: 2020 2020 2020 2020 2020 2020 514 D 5720 ‘QMW’
\n00000040: 2020 2020 2020 2020 2020 2020 2020 2020 ”
\n00000050: 2020 2020 2020 2020 2020 2020 2020 2020 ”
\n00000060: 2020 2020 2020 2020 2020 2020 2202 0000 ‘”…’
\n00000070: 3303 0000 4D51 5354 5220 2020 0600 0000 ‘3 … MQSTR ….’
\n00000080: 616 D 7172 6 D 70 7061 2020 2020 2020 2020 ‘amqrmppa’
\n00000090: 2020 2020 2020 2020 2020 2020 3230 3133 ‘2013’
\n000000 A0: 3031 3134 3131 3234 3236 3737 4920 7365 ‘011411242677 I se’
\n000000B0: 6E64 2061 206D 6573 7361 6765 2066 726 F ‘nd a message fro’
\n000000C0: 6D20 514D 432E ‘m QMC.’<\/p>\n

No more messages
\nMQCLOSE
\nMQDISC $<\/p>\n

In the case of
\n$ Amqsbcg DLQ QMW<\/p>\n

AMQSBCG 0 – starts here
\n**********************<\/p>\n

MQOPEN – ‘DLQ’<\/p>\n

MQGET of message number 1
\n**** Message descriptor ****<\/p>\n

StrucId: ‘MD’ Version: 2
\nReport: 0 Msg Type: 8
\nExpiry: -1 Feedback: 0
\nEncoding: 546 CodedCharSetId: 819
\nFormat: ‘MQDEAD’
\nPriority: 0 Persistence: 0
\nMsgId: X’414D5120514D432020202020202020209093F25002510020 ‘
\nCorrelId: X’00000000000000000000000000000000000000000000000000 ‘
\nBackoutCount: 0
\nReplyToQ: ”
\nReplyTo<\/p>\n","protected":false},"excerpt":{"rendered":"

Dead-letter queues A dead-letter (undelivered-message) queue is a queue that stores messages that cannot be routed to their correct destinations. This occurs when, for example, the destination queue is full. The supplied dead-letter queue is called SYSTEM.DEAD.LETTER.QUEUE. For distributed queuing, define a dead-letter queue on each queue manager involved.<\/p>\n

It is defined on the queue […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[57],"tags":[],"_links":{"self":[{"href":"https:\/\/mohan.sg\/index.php?rest_route=\/wp\/v2\/posts\/6516"}],"collection":[{"href":"https:\/\/mohan.sg\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mohan.sg\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mohan.sg\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/mohan.sg\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=6516"}],"version-history":[{"count":1,"href":"https:\/\/mohan.sg\/index.php?rest_route=\/wp\/v2\/posts\/6516\/revisions"}],"predecessor-version":[{"id":6517,"href":"https:\/\/mohan.sg\/index.php?rest_route=\/wp\/v2\/posts\/6516\/revisions\/6517"}],"wp:attachment":[{"href":"https:\/\/mohan.sg\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=6516"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mohan.sg\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=6516"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mohan.sg\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=6516"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}