IT21563: amqspub and amqssub sample client programs do not use MQSAMP_USER_ID to send userID and password

APAR status

• Closed as program error.

Error description

• When running amqspub/amqssub sample programs with the
  environment variable MQSAMP_USER_ID set, the sample programs do
  not prompt for the password.
  
  This also applies to the amqspubc and amqssubc client variants
  of the sample applications.
  
  amqspubc/amqssubc client application gets an error:    MQCONN
  ended with reason code 2538 i.e. MQRC_HOST_NOT_AVAILABLE
  2538 = MQRC_HOST_NOT_AVAILABLE
  
  And the Queue Manager  error log shows:
  AMQ5540: Application 'amqssubc.exe' did not supply a user ID
     and password
  AMQ9557: Queue Manager User ID initialisation failed for
  'XXXXX'.
   (where the UserId noted is the user that ran the application
    and NOT the one set in MQSAMP_USER_ID)
  
  Note: For the MQ sample programs, MQSAMP_USER_ID can be set to
  the user ID to be used for connection authentication. When this
  is set, the program will prompt for a password to accompany
  that user ID.
  see amqsputc/getc example at:
  https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm
  .mq.dev.doc/q024270_.htm
  

Local fix

• Add code to set MQCSP similar to the amqsput0.c sample,
  recompile and test.
  
  Another option would be to use the mqccred client-side
  security exit, which can be used to set the MQCSP
  userid/password.. see the following example:
  
  https://developer.ibm.com/answers/questions/259531/can-you-provi
  de-a-step-by-step-example-of-how-to-t.html
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users running the sample MQ applications amqspub and amqssub who
  wish to use MQSAMP_USER_ID to configure the userid, and prompt
  for a password, to connect to the Queue Manager.
  
  This also affects users running the amqspubc and amqssubc client
  variants, and users reviewing the supplied source code files,
  amqspuba.c and amqssuba.c
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  Logic to retrieve the environment variable MQSAMP_USER_ID
  contents and prompt for a password was not present in the
  amqspuba.c and amqssuba.c sample application code.
  

Problem conclusion

• The amqspuba.c and amqssuba.c sample applications have been
  modified to retrieve the environment variable MQSAMP_USER_ID
  contents and prompt for a password.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.0 CD    9.0.4
  v9.0 LTS   9.0.0.3
  
  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 BASE M/P

• Fixed component ID

  5724H7261

Applicable component levels

• R903 PSY

     UP