IBM Support

IC96765: WMQ V7.5: MFT TRANSFER OF FILES GREATER THAN 2GB CAUSE A XML SCHEMA VALIDATION ERROR WHEN AUDIT MESSAGE IS GENERATED.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When a WebSphere MQ Managed File Transfer transfer completes, an
    audit message is generated containing information about the
    transfer. One such item is the complex type 'fileType', which
    contains an attribute called 'size'. This records the size of
    the file transfer in bytes. Because the 'size' attribute is of
    type int, it has a limit on the value it can store. The
    maximum being 2147483647. Anything over that causes the
    validation error.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the WebSphere MQ V7.5 Managed File
    Transfer component who:
    
    - Transfer files larger than 2,147,483,647 bytes in size.
    - Monitor the SYSTEM.FTE topic for transfer progress messages,
    and validate the contents of the messages using the WebSphere MQ
    Managed File Transfer message schemas.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM SUMMARY:
    When a transfer request is in progress, the Source Agent
    regularly publishes progress messages to the SYSTEM.FTE topic.
    The progress messages contain information about the transfer
    request, and the files that are being transferred, and are
    written in an XML format. An example of a message for an "in
    progress" transfer can be found in the:
    
      Single transfer log message examples
    
    topic of the WebSPhere MQ V7.5 Information Center. The URI for
    this topic is shown below:
    
    
    http://pic.dhe.ibm.com/infocenter/wmqv7/v7r5/topic/com.ibm.wmqft
    e.doc/single_message_format.htm
    
    For every file being transferred, the progress message
    contains information about the size of the file. This is
    stored in the:
    
      size
    
    attribute of the:
    
      file
    
    element, as shown in the example below:
    
    
        /etc/passwd
        2287181c07199f879de28296371cb24c
    
    
    
    The XML schemas used by WebSphere MQ Managed File Transfer to
    generate progress messages defined the:
    
      size
    
    attribute for the:
    
      file
    
    element as being of type:
    
      xsd:int
    
    This meant that the largest allowable value that could be stored
    in this attribute was 2147483647.
    
    If an Agent was used to transfer a file that was larger than
    2,147,483,647 bytes, the size attribute for the file element
    in the progress message for the transfer request would contain
    the actual size of the file. If the progress message was then
    validated against the WebSphere MQ Managed File Transfer
    schemas, the validation failed, as the value stored in the
    size attribute was greater than the maximum allowable value
    for an xsd:int (2,147,483,647).
    

Problem conclusion

  • The WebSphere MQ Managed File Transfer schema:
    
      fteutils.xsd
    
    has been updated so that the:
    
      size
    
    attribute for the:
    
      file
    
    element is now defined to be of type:
    
      xsd:long
    
    rather than:
    
      xsd:int
    
    This means that progress messages generated for files larger
    than 2,147,483,647 bytes in size will be correctly validated
    against the WebSphere MQ Managed File Transfer schemas.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.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 number

    IC96765

  • Reported component name

    WMQ FTE

  • Reported component ID

    5724H7242

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-10-09

  • Closed date

    2013-12-13

  • Last modified date

    2013-12-13

  • 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 FTE

  • 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:
13 December 2013