IT27028: MQ appliance command 'test tcp-connection' syntax is not as documented in knowledge center

APAR status

• Closed as program error.

Error description

• The 'test tcp-connection' provides the option of giving IP
  address or hostname of the target. For example:
  
  Syntax for 'test tcp-connection' using IP address:
   test tcp-connection address port [seconds]
  
  Syntax for 'test tcp-connection' using host name:
   test tcp-connection hostname port [seconds] [IP-version]
  
  In either case when timeout value is provided in seconds as the
  argument described by the documentation, this value is
  incorrectly considered as IP version value. This reports an
  error that the IP version value is invalid.
  
  For example:
  test tcp-connection 9.xx.xx.xxx 1414 10
  
  % Use IP version '10' is not valid
  

Local fix

• Swap the positions of [timeout] and [IP-version] as a
  workaround.
  In the following example workaround, -4 specifies IPv4 with a
  timeout of 5 seconds
   "test tcp-connection TESTHOST 1414 -4 5"
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All MQ appliance users will be affected.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The order of options for the 'test tcp-connection' connection
  are misinterpreted. The timeout value is interpreted as IP
  version which can throw an invalid value error.
  

Problem conclusion

• The code has been modified to interpret the options for 'test
  tcp-connection' command correctly.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 CD    9.1.3
  v9.1 LTS   9.1.0.2
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  IBM MQ APPL M20

• Fixed component ID

  5725Z0900

Applicable component levels