{"id":71,"date":"2019-03-05T19:01:42","date_gmt":"2019-03-05T19:01:42","guid":{"rendered":"http:\/\/trindade.myphotos.cc\/lazysysadmin\/?p=71"},"modified":"2024-07-05T11:40:40","modified_gmt":"2024-07-05T10:40:40","slug":"ibm-mq-basics","status":"publish","type":"post","link":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/2019\/03\/05\/ibm-mq-basics\/","title":{"rendered":"IBM<\/span> MQ<\/span> basics: the first queue"},"content":{"rendered":"

<\/p>\n

Now that we\u2019ve installed MQ<\/span>, it\u2019s time to try it out. If you haven\u2019t read it, you can go to Installing IBM<\/span> MQ<\/span> on Lin\u00adux<\/a> to learn how to do it.<\/p>\n

In this arti\u00adcle, I\u2019ll show you the basics of IBM<\/span> MQ<\/span> and what it can do for your appli\u00adca\u00adtions\u2019 infrastructure.<\/p>\n

<\/p>\n

As the name points out, MQ<\/span> relies on\u2026 you guessed it, mes\u00adsage queues. Mes\u00adsage queues are man\u00adaged by\u2026 You guessed it again: queue managers.<\/p>\n

So, the first thing to do before cre\u00adat\u00ading your own queues is to cre\u00adate a queue manager.<\/p>\n

When IBM<\/span> MQ<\/span> is installed it cre\u00adates an mqm<\/span> user group and an mqm<\/span> user. MQ<\/span> admin\u00adis\u00adtra\u00adtors have to be in the mqm<\/span> user group. The user mqm<\/span> is also part of this group.<\/p>\n

The most basic way to cre\u00adate a queue man\u00adag\u00ader is with the ctr\u00admqm<\/span> com\u00admand. To cre\u00adate the QM1<\/span> queue man\u00adag\u00ader, we can use the com\u00admand below:<\/p>\n

ctr\u00admqm QM1<\/span><\/p>\n

There are oth\u00ader options, as for most MQ<\/span> com\u00admands, but this is enough for now.<\/p>\n

If there are no errors in the cre\u00adation of the new queue man\u00adag\u00ader, you should see the fol\u00adlow\u00ading output:<\/p>\n

IBM<\/span> MQ<\/span> queue man\u00adag\u00ader created.
\nDirec\u00adto\u00adry \u2018\/var\/mqm\/qmgrs\/QM1<\/span>\u2019 created.
\nThe queue man\u00adag\u00ader is asso\u00adci\u00adat\u00aded with instal\u00adla\u00adtion \u2018Installation1\u2019.
\nCre\u00adat\u00ading or replac\u00ading default objects for queue man\u00adag\u00ader \u2018QM1<\/span>\u2019.
\nDefault objects sta\u00adtis\u00adtics : 84 cre\u00adat\u00aded. 0 replaced. 0 failed.
\nCom\u00adplet\u00ading setup.
\nSet\u00adup completed.<\/div>\n

After cre\u00adat\u00ading the queue man\u00adag\u00ader, it must be run\u00adning before it can be configured.<\/p>\n

str\u00admqm QM1<\/span><\/p>\n

If every thing is OK<\/span>, you should see the output:<\/p>\n

IBM<\/span> MQ<\/span> queue man\u00adag\u00ader \u2018QM1<\/span>\u2019 starting.
\nThe queue man\u00adag\u00ader is asso\u00adci\u00adat\u00aded with instal\u00adla\u00adtion \u2018Installation1\u2019.
\n5 log records accessed on queue man\u00adag\u00ader \u2018QM1<\/span>\u2019 dur\u00ading the log replay
\nphase.
\nLog replay for queue man\u00adag\u00ader \u2018QM1<\/span>\u2019 complete.
\nTrans\u00adac\u00adtion man\u00adag\u00ader state recov\u00adered for queue man\u00adag\u00ader \u2018QM1<\/span>\u2019.
\nIBM<\/span> MQ<\/span> queue man\u00adag\u00ader \u2018QM1<\/span>\u2019 start\u00aded using V9<\/span>.1.0.0.<\/p>\n

After cre\u00adat\u00ading and start\u00ading our new queue man\u00adag\u00ader, we have to cre\u00adate queues for it to be use\u00adful. Oth\u00ader basic MQ<\/span> objects have to be cre\u00adat\u00aded in order for our appli\u00adca\u00adtions to be able to con\u00adnect to MQ<\/span>: at least one lis\u00adten\u00ader, which deter\u00admines which IP<\/span> address and TCP<\/span> port MQ<\/span> lis\u00adtens on, and one serv\u00ader con\u00adnec\u00adtion chan\u00adnel (I\u2019ll dis\u00adcuss MQ<\/span> chan\u00adnels in anoth\u00ader post).<\/p>\n

For now, because our queue man\u00adag\u00ader is \u201cemp\u00adty\u201d there is only one way to add objects to it, and that is with the run\u00admqsc<\/span> command.<\/p>\n

run\u00admqsc QM1<\/span><\/p>\n

First, define a listener<\/p>\n

DEFINE<\/span> LISTENER<\/span>(LISTENER1<\/span>.TCP<\/span>) TRPTYPE<\/span>(TCP<\/span>) PORT<\/span>(1414)<\/p>\n

This tells MQ<\/span> to lis\u00adten on TCP<\/span> port 1414 (this is the default, by the way). Because we did\u00adn\u2019t spec\u00adi\u00adfy an IP<\/span> address, MQ<\/span> will lis\u00adten on all net\u00adwork interfaces.<\/p>\n

Then, define a serv\u00ader con\u00adnec\u00adtion chan\u00adnel (for appli\u00adca\u00adtions to con\u00adnect to MQ<\/span>):<\/p>\n

DEFINE<\/span> CHANNEL<\/span>(CLNT<\/span>.APP<\/span>) CHLTYPE<\/span>(SVRCONN<\/span>)<\/p>\n

The SVRCONN<\/span> chan\u00adnel type is used by appli\u00adca\u00adtions to con\u00adnect remote\u00adly to MQ<\/span>.<\/p>\n

Now, for just a quick expla\u00adna\u00adtion about MQ<\/span> objects\u2019 nam\u00ading and commands.<\/p>\n

IBM<\/span> MQ<\/span> con\u00adverts every\u00adthing to upper case, except what is enclosed in sin\u00adgle quotes. So<\/p>\n

define qlocal(queue1)<\/p>\n

is equiv\u00ada\u00adlent to<\/p>\n

DEFINE<\/span> QLOCAL<\/span>(QUEUE1<\/span>)<\/p>\n

Should you want to cre\u00adate a queue named queue1 (in low\u00ader case) you have to type<\/p>\n

DEFINE<\/span> QLOCAL<\/span>(\u2018queue1\u2019)<\/p>\n

MQSC<\/span> com\u00admands can by typed in low\u00ader or upper case and some can be abbre\u00advi\u00adat\u00aded, such as DEFINE<\/span><\/span> (DEF<\/span><\/span>), DELETE<\/span><\/span> (DEL<\/span><\/span>) and ALTER<\/span><\/span> (ALT<\/span><\/span>). Some options can also be abbre\u00advi\u00adat\u00aded, such as QL<\/span><\/span> for QLOCAL<\/span><\/span>. The above com\u00admand can, thus, be typed as<\/p>\n

DEF<\/span> QL<\/span>(\u2018queue1\u2019)<\/p>\n

Now that we\u2019ve cre\u00adat\u00aded our first queue, it\u2019s about time we test\u00aded it. If you installed IBM<\/span> MQ\u2019s sam\u00adples (you did install them, did\u00adn\u2019t you?), we can use amqsput<\/span> and amqs\u00adget<\/span> sam\u00adples to test our new queue.<\/p>\n

Open a con\u00adnec\u00adtion to the MQ<\/span> serv\u00ader (SSH<\/span> or any oth\u00ader remote access method) and issue the following:<\/p>\n

\/opt\/mqm\/samp\/bin\/amqsput queue1 QM1<\/span><\/p>\n

Write some\u00adthing; every time you press Enter a new mes\u00adsage is cre\u00adat\u00aded in the queue.<\/p>\n

Hi
\nTest\u00ading\u2026 1\u2026 2\u2026 3\u2026
\nLast message<\/p>\n

To exit, press Control\u2011D.<\/p>\n

Now, if you check the queue depth (with the DISPLAY<\/span> QLOCAL<\/span>(\u2018queue1\u2019) CURDEPTH<\/span><\/span> com\u00admand), you\u2019ll notice it is now 3:<\/p>\n

run\u00admqsc QM1<\/span>
\nDISPLAY<\/span> QLOCAL<\/span>(\u2018queue1\u2019) CURDEPTH<\/span>
\n1 : DISPLAY<\/span> QLOCAL<\/span>(\u2018queue1\u2019) CURDEPTH<\/span>
\nAMQ8409I<\/span>: Dis\u00adplay Queue details.
\nQUEUE<\/span>(queue1)                          TYPE<\/span>(QLOCAL<\/span>)
\nCURDEPTH<\/span>(3)<\/p>\n

Issue the amqs\u00adget<\/span>:<\/p>\n

\/opt\/mqm\/samp\/bin\/amqsget queue1 QM1<\/span>
\nSam\u00adple AMQSGET0<\/span> start
\nmes\u00adsage <Hi>
\nmes\u00adsage <Test\u00ading\u2026 1\u2026 2\u2026 3\u2026>
\nmes\u00adsage <Last message><\/p>\n

If you check the queue again, you\u2019ll notice its depth is now 0 (zero):<\/p>\n

run\u00admqsc QM1<\/span>
\nDISPLAY<\/span> QLOCAL<\/span>(\u2018queue1\u2019) CURDEPTH<\/span>
\n1 : DISPLAY<\/span> QLOCAL<\/span>(\u2018queue1\u2019) CURDEPTH<\/span>
\nAMQ8409I<\/span>: Dis\u00adplay Queue details.
\nQUEUE<\/span>(queue1)                          TYPE<\/span>(QLOCAL<\/span>)
\nCURDEPTH<\/span>(0)<\/p>\n

That\u2019s all for now, folks! See you in the next install\u00adment of this arti\u00adcle series.<\/p>\n","protected":false},"excerpt":{"rendered":"

Now that we\u2019ve installed MQ<\/span>, it\u2019s time to try it out. If you haven\u2019t read it, you can go to Installing IBM<\/span> MQ<\/span> on Lin\u00adux to learn how to do it. In this arti\u00adcle, I\u2019ll show you the basics of IBM<\/span> \u2026 Con\u00adtin\u00adue read\u00ading \u2192<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":99,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"wp_typography_post_enhancements_disabled":false,"footnotes":""},"categories":[2,3],"tags":[10,12,4,8,6,13],"class_list":["post-71","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-middleware","category-mq","tag-ibm-mq","tag-ibmmq","tag-mq","tag-mqseries","tag-websphere-mq","tag-webspheremq"],"featured_image_src":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-content\/uploads\/sites\/7\/2019\/03\/IBM-MQ-Sticker.png","featured_image_src_square":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-content\/uploads\/sites\/7\/2019\/03\/IBM-MQ-Sticker.png","author_info":{"display_name":"Ant\u00f3nio Trindade","author_link":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/author\/trindade\/"},"_links":{"self":[{"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/posts\/71","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/comments?post=71"}],"version-history":[{"count":18,"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/posts\/71\/revisions"}],"predecessor-version":[{"id":102,"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/posts\/71\/revisions\/102"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/media\/99"}],"wp:attachment":[{"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/media?parent=71"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/categories?post=71"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/trindade.myphotos.cc\/lazysysadmin\/wp-json\/wp\/v2\/tags?post=71"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}