IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IT13587

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7241

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-02-03

  • Closed date

    2017-06-06

  • Last modified date

    2017-06-06

  • 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

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
06 June 2017