IBM Support

IC58877: COBOL MQSUB function call fails with error 2520 followed by 2019.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The error MQRC_RES_OBJECT_STRING_ERROR is returned when
    attempting to run COBOL Publisher/Subscriber applications.
    

Local fix

  • set MQSD-RESOBJECTSTRING-VSBUFSIZE field to a suitable value, ie
    the size (number of bytes) of the buffer available - often the
    same as MQSD-RESOBJECTSTRING-VSLENGTH.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    WebSphere MQ users  running COBOL applications using new V7
    APIs.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    The MQSD-RESOBJECTSTRING-VSBUFSIZE field is initialized in its
    definition with value MQVS-USE-VSLENGTH (-1). If the
    application does not explicitly modify this value, MQ reports
    a MQRC_RES_OBJECT_STRING_ERROR; as the acceptable value should
    be greater than or equal to zero. The constant MQVS-USE-
    VSLENGTH should not have been provided in the copy books.
    

Problem conclusion

  • Modifications are made to the corresponding copy books to
    remove constant MQVS-USE-VSLENGTH and to initialize the MQSD-
    RESOBJECTSTRING-VSBUFSIZE and similar values to zero.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.0.2
    --------           --------------------
    Windows            U200302
    AIX                U822354
    HP-UX (PA-RISC)    U822349
    HP-UX (Itanium)    U822351
    Solaris (SPARC)    U822353
    Solaris (x86-64)   U822394
    iSeries            tbc
    Linux (x86)        U822348
    Linux (x86-64)     U822393
    Linux (zSeries)    U822352
    Linux (Power)      U822350
    
    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

    IC58877

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2008-11-11

  • Closed date

    2009-01-12

  • Last modified date

    2009-01-14

  • 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 WINDOWS V7

  • Fixed component ID

    5724H7220

Applicable component levels

  • R700 PSY

       UP

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 January 2009