IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IT21148

  • Reported component name

    WMQ MFT

  • Reported component ID

    5724H7242

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-06-22

  • Closed date

    2017-07-25

  • Last modified date

    2017-07-25

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSCUHLE","label":"WMQ Managed File Transfer"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
25 July 2017