IT13587: runmqsc -v syntax checker does not report null object names as invalid

APAR status

• Closed as program error.

Error description

• The -v flag for the runmqsc tool in IBM MQ does
  not report null object names as invalid.
  
  runmqsc -v QMGRNAME
  .
  # Case 1:
  define qa('')
       1 : define qa('')
  .
  # Case 2:
  define qa( )
       2 : define qa( )
  AMQ8405: Syntax error detected at or near end of command
  segment below:-
  define qa( )
  AMQ8427: Valid syntax for the MQSC command:
    DEFINE QALIAS( q_name )
     [ CLUSNL( namelist_name ) ]             [ CLUSTER(
  cluster_name ) ]
  ...
     [ TARGET( string ) ]                    [ TARGTYPE( QUEUE |
  TOPIC ) ]
  end
       3 : end
  2 MQSC commands read.
  One command has a syntax error.
  .
  Case 1 does not show any error as such as opposed to standard
  'run command directly' mode of runmqsc
  
  runmqsc QMGRNAME
  
       1 : def qa('')
  AMQ8424: Error detected in a name keyword.
  One MQSC command read.
  No commands have a syntax error.
  
  The expectation is in runmqsc verify mode it should throw the
  same error for quoted string null objects.
  

Local fix

• Use the form that has the single quotes.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  IBM MQ users who are utilizing runmqsc -v (verify mode) to check
  the validity of MQSC commands prior to execution.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  An omission in the verify mode runmqsc logic meant that empty
  object name strings were not correctly reported as invalid.
  

Problem conclusion

• The runmqsc utility has been updated to report the following
  error in validation mode if a null (empty-string) object name is
  supplied:
  
  AMQ8424: Error detected in a name keyword.
  
  The following object types are considered by the check for an
  empty object name:
  
  AUTHINFO
  CHANNEL
  COMMINFO
  LISTENER
  NAMELIST
  PROCESS
  QALIAS
  QLOCAL
  QMODEL
  QREMOTE
  SERVICE
  SUB
  TOPIC
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.5       7.5.0.9
  v8.0       8.0.0.8
  v9.0 CD    9.0.4
  v9.0 LTS   9.0.0.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

  WMQ BASE MULTIP

• Fixed component ID

  5724H7241

Applicable component levels