IT39803: XMS sample programs SimpleConsumer and SimpleProducer do not honor the SSL key repository parameter

APAR status

• Closed as program error.

Error description

• When running xms sample programs SimpleConsumer and
  SimpleProducer to test TLS communication, it returns error "2538
  MQRC_HOST_NOT_AVAILABLE"
  
  For example:
  SimpleConsumer.exe  -m <QMQR> -d <QUEUE> -h <HOSTNAME> -p <PORT>
  -l <CHANNEL> -k *USER -s TLS_RSA_WITH_AES_128_CBC_SHA256
  
  The parameter "-k  *USER is ignored and causes the connection
  error.
  

Local fix

• Workaround:
  
  Replace following line in the sample source programs
  SimpleConsumer and SimpleProducer:
  
  cf.SetStringProperty(XMSC.WMQ_SSL_KEY_REPOSITORY,
  "sslKeyRepository");
  
  by
  
  cf.SetStringProperty(XMSC.WMQ_SSL_KEY_REPOSITORY,
  sslKeyRepository);
  
  and compile it.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users who are using SimpleConsumer and SimpleProducer sample
  program provided in XMS managed .Net
  
  
  Platforms affected:
  Windows, Linux on x86-64
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  A coding error caused the key repository value to be interpreted
  as the string value "sslKeyRepository", instead of the value of
  the variable with the same name.
  

Problem conclusion

• The variable name "sslKeyRepository" which was in double quotes
  has been removed from double quotes, to correctly reference the
  variable's value.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.3 LTS   9.3.0.5
  v9.x CD    9.3.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

  MQ BASE V9.2

• Fixed component ID

  5724H7281

Applicable component levels