IBM Support

IV37418: WEBSPHERE MQ 7.1 DSPMQRTE COMMAND RETURNS 2046 'MQRC_OPTIONS_ERROR'

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When the dspmqrte command in client mode as follows:
    $ dspmqrte -q queue.name -m qmgr_name -c
    
    The command will fail with the following error:
    
    AMQ8653: DSPMQRTE command started with options '-q queue.name
    -m qmgr_name -c'.
    
    AMQ8688: DSPMQRTE command has detected an unexpected error,
    reason 2046 'MQRC_OPTIONS_ERROR'.
    
    AMQ8664: DSPMQRTE command could not connect to queue manager
    'qmgr_name'.
    
    AMQ8658: DSPMQRTE command failed to put a message to the
    specified target.
    
    AMQ8651: DSPMQRTE command has finished with errors.
    
    The following FDC may be generated as well :-
    
    Probe Id :- OP135000
    Application Name :- MQM
    Component :- otrConnect
    Program Name :- dspmqrte
    Major Errorcode :- oecE_UNEXPECTED_ERROR
    Minor Errorcode :- OK
    Probe Description :- AMQ8688: DSPMQRTE command has detected an
    unexpected error, reason 2046 'MQRC_OPTIONS_ERROR'.
    Arith1 :- 2046 (0x7fe)
    Comment1 :- MQRC_OPTIONS_ERROR
    
    MQM Function Stack
    otrTraceRoute
    otrConnect
    xcsFFST
    MQM Trace History
    --} reqConnectChl rc=MQRC_OPTIONS_ERROR
    .
    -} reqDoConnect rc=MQRC_OPTIONS_ERROR
    .
    } MQCONNX rc=MQRC_OPTIONS_ERROR
    { xcsFFST
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    All users using dspmqrte command from MQv7.1 or later
    connecting to MQv7.0.1 or earlier version.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    While connecting to a v7.0.1 or older queue manager using
    dspmqrte command, a new connection options introduced in v7.1
    was being used in the MQCONNX call. This resulted in a failure
    within the MQCONNX call.
    

Problem conclusion

  • WebSphere MQ code was modified to unset the new connection
    option introduced in MQ v7.1 while connecting to a MQ v7.0.1 or
    older queue manager.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.1
    Platform           Fix Pack 7.1.0.4
    --------           --------------------
    Windows            7.1.0.4
    AIX                7.1.0.4
    HP-UX (Itanium)    7.1.0.4
    Solaris (SPARC)    7.1.0.4
    Solaris (x86-64)   7.1.0.4
    iSeries            7.1.0.4
    Linux (x86)        7.1.0.4
    Linux (x86-64)     7.1.0.4
    Linux (zSeries)    7.1.0.4
    Linux (Power)      7.1.0.4
    
    Platform           v7.5
    --------           --------------------
    Multiplatforms     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

    IV37418

  • Reported component name

    WMQ LIN X86 V7

  • Reported component ID

    5724H7224

  • Reported release

    710

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-03-01

  • Closed date

    2013-05-30

  • Last modified date

    2013-05-30

  • 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 LIN X86 V7

  • Fixed component ID

    5724H7224

Applicable component levels

  • R710 PSY

       UP

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1"}]

Document Information

Modified date:
08 March 2021