IBM Support

IT24757: Reloading messages from a file to a queue may fail when messageswere saved with dmpmqmsg command using '-dt' parameter

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • Using the dmpmqmsg command may not reload all of the messages
    into the named queue and the following error message is
    generated:
    
       Expected message attribute at line xxxx of file 'FILE_NAME'
    
    The error occurs when the messages were saved using '-dt'
    parameter (text line output).
    
    Here is an example of command:
    
    /opt/mqm/bin/dmpmqmsg -m HLOGQM -iEFI.OPP_ARCHIVE
    -fDumpTest_20180328 -dt
    [1] 947
    -bash-4.2$ 5724-H72 (C) Copyright IBM Corp. 1994, 2017.
    WebSphere MQ Queue Load/Unload Utility
    Read    - Files:   0  Messages:2404  Bytes:5045824
    Written - Files:   1  Messages:2404  Bytes:5045824
    
    [1]+  Done       /opt/mqm/bin/dmpmqmsg -m HLOGQM
    -iEFI.OPP_ARCHIVE
                           -fDumpTest_20180328  -dt
    
    /opt/mqm/bin/dmpmqmsg -m HLOGQM -oTEMP -fDumpTest_20180328
    5724-H72 (C) Copyright IBM Corp. 1994, 2017.
    WebSphere MQ Queue Load/Unload Utility
    Expected message attribute at line 111 of file
    'DumpTest_20180328'
    Read    - Files:   1  Messages:2  Bytes:2815
    Written - Files:   0  Messages:2  Bytes:2815
    

Local fix

  • use '-dA' parameter (Write ASCII lines of data) instead of '-dt'
    if you need messages are readable in the file.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users who wish to use the dmpmqmsg utility to load messages from
    a file which was created by dmpmqmsg using the '-dt' parameter
    to request text mode output.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When loading messages from a file generated with the '-dt'
    parameter, the dmpmqmsg utility was incorrectly validating the
    number of bytes being read from the file.
    

Problem conclusion

  • The dmpmqmsg code has been modified to correctly validate the
    number of bytes when reading from files generated using the
    '-dt' parameter.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.11
    v9.0 LTS   9.0.0.5
    v9.1 CD    9.1.1
    v9.1 LTS   9.1.0.1
    
    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

    IT24757

  • Reported component name

    IBM MQ BASE MP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-04-17

  • Closed date

    2018-07-16

  • Last modified date

    2018-07-16

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

  • Fixed component ID

    5724H7251

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0.0.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
16 July 2018