IT32415: Specifying the invalid -zipfile argument to runmqras on the MQ Appliance causes the current mqcli instance to exit

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