IBM Support

IC90595: THE "DSPMQRTE -C" COMMAND REQUIRES THAT THE WEBSPHERE MQ CLIENT COMPONENT BE INSTALLED.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as documentation error.

Error description

  • In WebSphere MQ 7.1 and later versions, the dspmqrte command
    used with the -c flag requires the mqdc.dll (or equivalent
    library on unix platforms) to be installed.
    
    This library file is supplied only, if the WebSphere MQ client
    is installed along side the server component.
    
    When dspmqrte command is used with -c flag in an environment
    where MQ client component is not installed, the command fails
    with the following type of errors:
    
    AMQ8689: Loading of client module 'C:\Program Files\mqm
    \bin\mqdc.dll' failed
    AMQ8651: DSPMQRTE command has finished with errors.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    WebSphere MQ version 710 and 750 users using dspmqrte command
    with -c option.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    At WebSphere MQ version 701 and lower dspmqrte command can be
    run as a client application by using the -c option on a
    WebSphere MQ server installation that does not have the client
    component is installed. However, at version 710 and above the
    dspmqrte command can be run as a client application only if
    WebSphere MQ client component is installed. The WebSphere MQ
    Info Center for the version 710 and 750 needs to updated with
    this information.
    

Problem conclusion

  • The following sections in WebSphere MQ Infocenter
    
    WebSphere MQ  Reference ->
    Administration reference ->
    WebSphere MQ control commands ->
    The control commands
    
    WebSphere MQ ->
    Monitoring and performance ->
    Message monitoring ->
    WebSphere MQ display route application ->
    Parameters for trace-route messages
    
    that documents the parameter description for the -c option
    should include the below.
    
    "This option can be used only if the client component is
    installed."
    
    in addition to the existing description that states
    
    -c
    Specifies that the WebSphere MQ display route application
    connects as a client application.
    
    If you do not specify this parameter, the WebSphere MQ display
    route application does not connect as a client application.
    
    Also, the text in the section
    WebSphere MQ ->
    Monitoring and performance ->
    Message monitoring
    
    Note: To run a Client Application against a WebSphere MQ for
    z/OS queue manager, the Client Attachment feature must be
    installed.
    
    should be modified as
    
    Note: To run a Client Application against a queue manager, the
    Client Attachment feature must be installed.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC90595

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    710

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-03-01

  • Closed date

    2013-04-18

  • Last modified date

    2013-04-18

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels

[{"Line of Business":{"code":"LOB45","label":"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:
09 March 2021