IBM Support

IT32415: Specifying the invalid

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

  • On the IBM MQ Appliance, if the invalid -zipfile argument is
    supplied to the runmqras command, the correct error is reported,
    however the mqcli exits back to the toplevel appliance cli:
    
    mqa(mqcli)# runmqras -section defs,trace -zipfile zipFileName
    AMQ5056E: Argument -zipfile supplied to command runmqras is not
    permitted on  this platform.
    Error launching /opt/mqm/bin/mqdpcli (incomplete firmware
    package?)
    mqa#
    
    
    A failure data capture (FDC) record with identifiers similar to
    the following is generated:
    
    | Installation Name :- MQAppliance      (1)
    | Probe Id          :- DP010020
    | Application Name  :- MQM
    | Component         :- dpcCmd_runmqras
    | Program Name      :- mqdpcli
    | Major Errorcode   :- OK
    | Minor Errorcode   :- OK
    | Probe Type        :- INCORROUT
    | Probe Severity    :- 4
    | Probe Description :- AMQ6125E: An internal IBM MQ
    Appliance error has occurred.
    | Comment2          :- Bad address
    
    MQM Function Stack
    CLI
    dpcCmd_runmqras
    xcsFFST
    
    
    After encountering this issue, users may re-enter the mqcli as
    normal, without any functional impact.
    

Local fix

  • Do not specify the invalid arguments to runmqras on the MQ
    Appliance
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of the IBM MQ Appliance, who supply one of the the
    argument to the runmqras command that are not valid on the IBM
    MQ Appliance. The runmqras arguments that are not valid on the
    IBM MQ Appliance are:
    
      -inputfile
      -outputdir
      -workdirectory
      -zipfile
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    A logic error in the mqcli utility on the IBM MQ Appliance cause
    the current cli process to incorrectly terminate after
    identifying an invalid argument to runmqras, returning the user
    to the top-level cli.
    

Problem conclusion

  • The mqcli utility has been updated to continue execution after
    returning the AMQ5056E error message in this situation.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.1 LTS   9.1.0.9
    v9.2 LTS   9.2.0.3
    v9.x CD    9.2.2
    
    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

    IT32415

  • Reported component name

    MQ APPLIANCE M2

  • Reported component ID

    5737H4700

  • Reported release

    910

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-04-02

  • Closed date

    2021-06-29

  • Last modified date

    2021-07-07

  • 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

    MQ APPLIANCE M2

  • Fixed component ID

    5737H4700

Applicable component levels

[{"Type":"MASTER","Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS5K6E","label":"IBM MQ Appliance"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
08 July 2021