App Connect

Expand all | Collapse all

How to set MQ client connections timeout value in ACE 11.0.0.9

  • 1.  How to set MQ client connections timeout value in ACE 11.0.0.9

    Posted 26 days ago
    We noticed that the default value for timeout in MQ client connectios is 60 seconds.

    In the following url https://www.ibm.com/support/knowledgecenter/SSTTDS_11.0.0/com.ibm.etools.mft.doc/ac35400_.html), you can read:

    You can change the length of time after which a connection for an idle message flow is released, by setting the sharedConnectorIdleTimeout property of the mqsichangeproperties command, as shown in the following example:mqsichangeproperties integrationNodeName -e integrationServerName -o Connectors -n sharedConnectorIdleTimeout -v new_timeout_valueCopy codewhere new_timeout_value is the number of seconds after which the connection is released. You can specify a value for the sharedConnectorIdleTimeout property as a positive integer (greater than 0), or you can specify that the connection never times out by setting the value to -1.

    But when we issued  that command we got the following error:

    BIP8004E: Invalid argument '--object Connectors' specified.
    Argument specified should be well formed.
    Correct and reissue the command.

    Besides, the sharedConnectorIdleTimeout property does not exist in any yaml file.

    So, how to set MQ client connections timeout value in ACE 11.0.0.9?

    Thanks in advance to anyone who can help me!





    ------------------------------
    Francisco A Buccafusca
    Argentina
    ------------------------------


  • 2.  RE: How to set MQ client connections timeout value in ACE 11.0.0.9

    Posted 25 days ago
    Hello Francisco
    sometimes error messages are misleading.
    Could you post your full mqsichangeproperties command into here - not just the error message.
    Do you get the same error message when you work with -o instead of --object

    ------------------------------
    Matthias Jungbauer
    ------------------------------



  • 3.  RE: How to set MQ client connections timeout value in ACE 11.0.0.9

    Posted 25 days ago
    Hello Matthias,

    Thanks for your reply. This is the full output of the mqsichangeproperties command

    mqsichangeproperties DESANODE -e desa_intsrv_09 -o Connectors -n sharedConnectorIdleTimeout -v 180
    BIP8123W: The mqsichangeproperties command changes the values of integration node properties.
    Syntax 1 - Integration node properties:
    mqsichangeproperties [--integration-node] <integrationNodeName> [ --component <componentName> | --configurable-service <policyType> ] [--object <objectName>] --property <propertyName> ( --value <propertyValue> | --delete | --input-file <Path/Filename> ) [--offline] [--trace <traceFileName>]
    Syntax 2 - Integration server properties::
    mqsichangeproperties [--integration-node] <integrationNodeName> --integration-server <integrationServerName> --object <objectName> --property <propertyName> ( --value <propertyValue> | --delete | -p Path/Filename ) [--offline] [--trace <traceFileName>]

    Command options:
    [--integration-node] <integrationNodeName>: The name of the integration node to modify.
    '--integration-server (-e) <integrationServerName>' Change properties for the integration server.
    '--component (-b) [BrokerRegistry | NodeHttpListener | SecurityCache | RestAdminListener | Events | Service]' Change properties for the named component. Omit this paramater to change top-level properties for the integration node.
    '--configurable-service (-c) <policyType>' Change properties for a policy defined at the integration node level. This cannot be used to change a policy deployed to an integration sever..
    '--object (-o) <objectName>' The name of the object for which you want to change the properties.
    '--property (-n) <propertyName>' The name of the property to be changed.
    '--value (-v) <propertyValue>' The value that is assigned to the property specified by the --property parameter. Specify more than one property name and corresponding value by using commas as separators; for example, --property Name1, Name2 --value Value1, Value2.
    '--delete (-d)' If the property that you specify on the --property parameter exists, it is deleted. This parameter is valid only if you specify a policy of type UserDefined.
    '--input-file (-p) <path/filename>' The name of a file to read the integration node property settings from.
    '--offline (-f)' Allows updates when the integration node or integration server is stopped. The changes made will be used the next time the integration node/server starts.
    '--trace <traceFileName>' : send verbose internal trace to the specified file.

    BIP8004E: Invalid argument '--object Connectors' specified.
    Argument specified should be well formed.
    Correct and reissue the command.

    Thanks in advance.

    ------------------------------
    Francisco A Buccafusca
    Argentina
    ------------------------------



  • 4.  RE: How to set MQ client connections timeout value in ACE 11.0.0.9

    Posted 24 days ago
    Please note that the command you showed might only be valid in ACE 11.0.0.10 ...
    Did you try and upgrade? Were you successful then?

    ------------------------------
    Francois Brandelik
    ------------------------------



  • 5.  RE: How to set MQ client connections timeout value in ACE 11.0.0.9

    Posted 21 days ago
    Hello Francois,

    In this moment is not possible to upgrade because we are in the middle of the migration from IIB to ACE 11.0.0.9

    What's really strange is that we read about that command before FP10 was released, but as documentation is not in a hard-copy format we'll have to wait and try it when we can upgrade to the last FP.

    Thanks Francois!

    ------------------------------
    Francisco A Buccafusca
    Argentina
    ------------------------------



  • 6.  RE: How to set MQ client connections timeout value in ACE 11.0.0.9

    Posted 19 days ago
    Hello Francisco
    Maybe there are some other parameters around to achieve your goal.
    What is it that you would like to achieve?
    What shall happen if you experience a time out?


    ------------------------------
    Matthias Jungbauer
    ------------------------------



  • 7.  RE: How to set MQ client connections timeout value in ACE 11.0.0.9

    Posted 19 days ago
    Hello Mathias,

    Our MQ Queue Manager runs on z/OS and connecting an MQ client to an z/OS queue manager is a relatively expensive procedure, and IBM recommends that MQ client applications remain connected for as long as is practical.

    When a message flow node initiates access to the first IBM MQ resource it uses, it opens a connection to the queue manager and opens the queue. This connection is opened the first time that a message is processed by that message flow node

    A thread performing IBM MQ work becomes idle when it has not received any messages on its input queue for 1 minute. The allowed idle time starts from when the input queue being read becomes empty. Besides one connection is required for every message flow thread.

    As explained in url https://www.ibm.com/support/knowledgecenter/SSTTDS_11.0.0/com.ibm.etools.mft.doc/bc28611_.html
    All IBM MQ connections remain open until one of the following events occurs:
    • An error occurs while the queue manager is being accessed, and a new connection is required as a result.
    • The message flow is stopped.
    • The message flow is idle for a time that exceeds the timeout threshold set for the connection. By default, this threshold is set to 1 minute; however, you can change the threshold by setting the sharedConnectorIdleTimeout property of the mqsichangeproperties command. For more information, see IBM MQ connections.

    So, that why we want to change the length of time after which a connection for an idle message flow is released. And our goal is to keep the MQ client connections alive (no timeout) until we face one of the following situations: 
    • The message flow is stopped.
    • The integration server is stopped
    • The integration node is stopped

      Thanks for your interest in this issue.




      ------------------------------
      Francisco A Buccafusca
      Argentina
      ------------------------------