MQ

MQ

Join this online group to communicate across IBM product users and experts by sharing advice and best practices with peers and staying up to date regarding product enhancements.

 View Only
  • 1.  mqclient.ini on IBM i

    Posted Wed September 06, 2023 11:36 AM

    Hello,

    I'm looking to add the lines 

    CHANNELS:
     DefRecon=YES

    to the mqclient.ini file of an MQ client.

    But this MQ client is the iSeries one.
    I can't find any reference in the documentation to possible locations for this file.

    Any ideas? 
    Thank you for your help.



    ------------------------------
    Luc-Michel Demey
    DEMEY CONSULTING
    lmd@demey-consulting.fr
    #IBMChampion
    ------------------------------


  • 2.  RE: mqclient.ini on IBM i

    Posted Thu September 07, 2023 01:11 AM

    I think you are asking where the "default" mqclient.ini file might be on the IBM i platform? I don't think there is one. See Location of the client configuration file

    However, you can just make one and put it wherever you need it to be and then point to it with an environment variable (ADDENVVAR).

    Cheers,
    Morag



    ------------------------------
    Morag Hughson
    MQ Technical Education Specialist
    MQGem Software Limited
    Website: https://www.mqgem.com
    ------------------------------



  • 3.  RE: mqclient.ini on IBM i

    Posted Thu September 07, 2023 12:34 PM

    Hello Morag,
    I had indeed seen that there is no default mqclient.ini file for the IBM i.
    Using ADDENVVAR is an interesting idea, but what variable should I use?
    If I look at AMQ_MQS_INI_LOCATION, the documentation says :

    [AIX][Linux]AMQ_MQS_INI_LOCATION
        On AIX and Linux systems, you can alter the location that is used for the mqs.ini file by setting the location of the mqs.ini file in this variable. This variable must be set at the system level. 
        
    Thank you in advance for your reply.



    ------------------------------
    Luc-Michel Demey
    DEMEY CONSULTING
    lmd@demey-consulting.fr
    #IBMChampion
    ------------------------------



  • 4.  RE: mqclient.ini on IBM i

    Posted Thu September 07, 2023 06:31 PM

    Have a good old read of the link in my previous answer. The environment variable is called MQCLNTCF



    ------------------------------
    Morag Hughson
    MQ Technical Education Specialist
    MQGem Software Limited
    Website: https://www.mqgem.com
    ------------------------------



  • 5.  RE: mqclient.ini on IBM i

    Posted Fri September 08, 2023 03:22 AM
    Edited by Mayur RAJA Fri September 08, 2023 03:38 AM

    FYI, we document examples of environment variables here: https://www.ibm.com/docs/en/ibm-mq/9.3?topic=reference-environment-variables where the syntax of ADDENVAR and the MQCLNTCF variable can be seen. However, I think it would be good for us to add the ADDENVAR details to the section on 'location of the client configuration file' that Morag highlights. Currently, bullet 1 in point 3.  of this section states: 

    The IBM MQ data directory does not exist on certain platforms, for example, IBM i and z/OS®, or in cases where the client has been supplied with another product.

    But it does not state that there is no default mqclient.ini file on IBM i and that you need to create one and point MQCLNTCF to it. 

    I do not work on IBM MQ for IBM i so I cannot confirm that this works as expected. Once you have tried setting the MQCLNTCF environment variable, I'd appreciate it if you can confirm if it works as expected please ? Then I'll request MQ authors to update the MQ docs. It will help other customers in the future. Ideally, I should try to find someone in the Lab who has access to an IBM i system, but so long as you do not mind, it would also be good for me to know that this works in a customer environment. Thank you.

    ------------------------------
    Mayur RAJA
    ------------------------------



  • 6.  RE: mqclient.ini on IBM i

    Posted Fri September 08, 2023 12:23 PM

    Sorry @Morag, I hadn't taken a good look at your link page, but it does say MQCLNTCF.

    Thanks @Mayur for the clarification.
    It's always reassuring to know that someone is interested in the accuracy of the documentation and acts to complete it if necessary.

    I won't be able to test with an MQ iSeries client until the end of next week, but I'll keep you posted on the results.

    Thanks to all.



    ------------------------------
    Luc-Michel Demey
    Technical Architect
    Demey-Consulting.fr
    Le Perreux sur Marne
    ------------------------------



  • 7.  RE: mqclient.ini on IBM i

    Posted Sat September 09, 2023 10:04 AM

    @Luc-Michel Demey . No rush, please test at your convenience and let me know when you are ready. Thank you.



    ------------------------------
    Mayur RAJA
    ------------------------------



  • 8.  RE: mqclient.ini on IBM i

    Posted Mon September 18, 2023 12:47 PM

    Hello,

    The tests have just been successfully completed:

    creation of a file named mqclient.ini in the iSeries IFS in /QIBM/UserData/mqm/. Contents of this file: 
    ---
    CHANNELS:
      DefRecon=YES
    ---
    - ON iSeries, export at job-level of variable MQCLNTCF :
    ADDENVVAR ENVVAR(MQCLNTCF) VALUE('/QIBM/UserData/mqm/mqclient.ini') REPLACE(*YES)
    - Start iSeries MQ Client application
    - Switch the Queue Manager from A to B
    - MQ Client iSeries application reconnects to B.

    Thank you all for your advice.



    ------------------------------
    Luc-Michel Demey
    DEMEY CONSULTING
    lmd@demey-consulting.fr
    #IBMChampion
    ------------------------------



  • 9.  RE: mqclient.ini on IBM i

    Posted Mon September 18, 2023 01:01 PM

    Hello @Luc-Michel Demey ,

    Excellent news ! I'll raise a request against our MQ authors to clarify this at the doc link that Morag highlighted above. 

    Thank you for confirming. 



    ------------------------------
    Mayur RAJA
    ------------------------------