IT21148: XML namespace declaration missing from example XML snippets in MQMFTCREDENTIALS.XSD file

APAR status

• Closed as program error.

Error description

• The MQMFTCredentials.xsd file defines the XML schema to which
  the MQMFTCredentials.xml file must conform.  It also contains
  some example XML snippets that would be included in a typical
  MQMFTCredentials.xml file.  The example XML did not include an
  XML namespace declaration on element entry tags.
  
  If an MQMFTCredentials.xml file was written based on the
  examples and also did not include an XML namespace declaration
  on the element entry tags, the following error message would be
  thrown when a Managed File Transfer (MFT) process attempted to
  read the file:
  
      BFGPR0067E: An error occurred when processing the contents
  of a credentials file. File path
  C:\Users\IBM\MQMFTCredentials.xml. Reported error:
  cvc-complex-type.2.4.a: Invalid content was found starting with
  element 'logger'. One of
  '{"http://wmqfte.ibm.com/MQMFTCredentials":logger,
  "http://wmqfte.ibm.com/MQMFTCredentials":file,
  "http://wmqfte.ibm.com/MQMFTCredentials":qmgr}' is expected.
  

Local fix

• Use proper tag in MQMFTCredentials.xml
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects the users of:
  
      - WebSphere MQ v7.5 Managed File Transfer
  	- IBM MQ V8 Managed File Transfer
  	- IBM MQ V9 Managed File Transfer
  
  who use the XML examples from the MQMFTCredentials.xsd schema
  file installed with the product or from the following IBM
  Knowledge Center page:
  https://www.ibm.com/support/knowledgecenter/SSFKSJ_7.5.0/com.ibm
  .wmqfte.doc/mqm_credentials_format.htm
  
  to create their own MQMFTCredentials.xml file without XML
  namespace declarations on XML entry elements.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  Within MQMFTCredentials.xsd file, the example XML snippets were
  incorrect as they did not contain the required XML namespace
  declaration within the element entry tags. For example:
  
      <logger name="LOG1" user="user1" password="passw0rd"/>
  &#09;
  The XML namespace declaration is required on the XML element
  entries because each element or attribute must be in a
  namespace. Otherwise the element or attribute can not be parsed
  by the XML parser.
  

Problem conclusion

• The MQMFTCredentials.xsd file has been updated and now contains
  the correct example XML entries, for instance:
  
  &#09;<logger name="LOG1"   user="user1" password="passw0rd"/>
  
  now looks like:
  
  &#09;<tns:logger name="LOG1"   user="user1"
  password="passw0rd"/>
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.5       7.5.0.9
  v8.0       8.0.0.8
  v9.0 CD    9.0.4
  v9.0 LTS   9.0.0.3
  
  The latest available FTE maintenance can be obtained from
  'Fix List for WebSphere MQ File Transfer Edition 7.0'
  http://www-01.ibm.com/support/docview.wss?uid=swg27015313
  
  The latest available MQ 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

  WMQ MFT

• Fixed component ID

  5724H7242

Applicable component levels

• R750 PSY

     UP