PM15255: POUND SIGN IN USERID'S CAUSES MQ CONNECTION FAILURE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Attempting to use MQ functions in File Manager resulted in a
  connection error.  This was due to userid's containing a special
  character '#' which is not recognized by MQ.
  
  The userid is used to uniquely identify a dynamic queue.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: File Manager Websphere MQ Users              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using a userid containing one or   *
  *                      more of the characters @,# or $ (x'7C', *
  *                      x'7B', x'5B') and attempting to use     *
  *                      or list MQ queues, message FMNBC302     *
  *                      The connect to queue manager <qmname>   *
  *                      failed. The completion code was 2       *
  *                      and the reason code was 2011 -          *
  *                      MQRC_DYNAMIC_Q_NAME_ERROR               *
  *                      is generated.                           *
  ****************************************************************
  * RECOMMENDATION: Apply the provided PTF.                      *
  ****************************************************************
  File Manager uses a command and dynamic reply queue to perform
  operations with Websphere MQ, including listing of queues.
  The TSO userid is included in the high level qualifiers of the
  dynamic reply queue name in order to allow for userid based
  security rules to be applied, should a site wish to do so.
  
  However, the rules for naming WebSphere MQ objects do not
  include the characters #,$ or @ (x'7B',x'5B, x'7C') so an
  invalid object name will be generated, should the userid
  contain those characters.
  

Problem conclusion

• File Manager has been updated in order to translate the userid
  characters '@','#' and '$' to the allowable MQ character '_'
  before setting the high level qualifier for a dynamic reply
  queue name.
  
  This also has a security definition consideration for rules
  governing the access to queue names, in that the characters
  will be substituted as described above.
  
  That is, presuming the default setting of "MQREPHLQ=FMNTMQL."
  is in the active FMN0POPT with, for example a userid:
  USR@#$1 will now generate the string
  FMNTMQL.USR___1.* for the dynamic reply queue name.
  (The * is replaced by a dynamically generated name returned by
   Websphere MQ)
  For the documentation changes associated with this APAR,
  (specifically related to the MQREPHLQ parameter)
   please refer to:
   ftp://ftp.software.ibm.com/software/websphere/awdtools/
       filemanager/fmv10apar.pdf
  
   The changes are to the following publications:
  
   PUB ID        PUB NAME
   ------------  ----------------------------------------
  
   SC19-2856-00  File Manager for z/OS V10R1 Customization
                 Guide
  
  
   The latest published manuals can be found at:
   http://www.ibm.com/software/awdtools/filemanager/library/
          index.html.
  

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:

  UK59895 UK59896 UK59897 UK59898 UK59899

Modules/Macros

• FMNCAFN  FMNCBLX  FMNCM2GO FMNDYNTP FMNEDIT3
  FMNED0DY FMNFNLR1 FMNIEBCP FMNLOG   FMNLOG2  FMNMQCMT FMNPSCLE
  FMNRDFFD FMNRDFSG FMNRDFTB FMNRDR2  FMNRMDAT FMNRXFUN FMNSEGCB
  FMNTPDFD FMNTPEVL FMN0LVL  FMN0LVLJ FMN0LVLK FMN2AUDI FMN2A2IO
  FMN2BCNL FMN2BCTQ FMN2BDBQ FMN2BUTQ FMN2CATQ FMN2CGM2 FMN2CHKI
  FMN2CTMP FMN2CTM1 FMN2CTQ2 FMN2DBC  FMN2DBI  FMN2DBP  FMN2DBX
  FMN2DBY  FMN2DCRE FMN2D2C  FMN2D2E  FMN2D2EI FMN2D2SP FMN2EDSP
  FMN2ERR  FMN2IDTB FMN2INTP FMN2IPSU FMN2ISPF FMN2ISQ  FMN2ISQG
  FMN2LOCL FMN2LVL  FMN2LVLK FMN2MAIN FMN2MENU FMN2MKOR FMN2MXXX
  FMN2RMDT FMN2RMR  FMN2RMR2 FMN2SAPR FMN2SBPR FMN2SCON FMN2SEDX
  FMN2SELS FMN2SENX FMN2SQSU FMN2SQTB FMN2SSQL FMN2TTBL
  

Fix information

• Fixed component name

  FILE MANAGER ZO

• Fixed component ID

  5655V5200

Applicable component levels

• RA1A PSY UK59896

     UP10/08/26 P F008

• RA1B PSY UK59897

     UP10/08/26 P F008

• RA10 PSY UK59895

     UP10/08/26 P F008

• RA11 PSY UK59898

     UP10/08/26 P F008

• RA12 PSY UK59899

     UP10/08/26 P F008

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.