IBM Support

IT18438: AMQP service system.amqp.service stops with message AMQ5029 immediately after it is started using runmqsc

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

  • The IBM MQ AMQP service SYSTEM.AMQP.SERVICE, which starts a
    Java Virtual Machine to accept Advanced Message Queue Protocol
    connections from AMQP clients, stops immediately after it
    is started with this message:
    
      AMQ5029: The Server 'SYSTEM.AMQP.SERVICE' has ended.
    
    When this problem occurs, the STDERR output from the service,
    found in the file amqp.stderr, shows an error running the export
    command:
    
      controlAMQP_mqm.sh: 29: export: - en: bad variable name
    

Local fix

  • Update any environment variables that are defined over multiple
    lines, such as PS1, so that they are defined on one line only.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the AMQP service on Unix systems who
    have environment variables that are defined over multiple lines.
    
    
    Platforms affected:
    Linux on zSeries, Linux on x86-64, Linux on x86, Linux on S390,
    Linux on Power, AIX, HP-UX Itanium, Solaris SPARC, Solaris
    x86-64
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    On some Unix systems where environment variables were defined
    over multiple lines, IBM MQ scripts that controlled the starting
    of the SYSTEM.AMQP.SERVICE may have failed and prevented the
    service from starting correctly.  This was because the script
    was interpreting each line, output from the Unix 'set' command,
    in turn as being an environment variable to export.
    
    If a line, which was part of a multi-line environment variable
    definition, such as may have been used in the PS1 variable
    definition, contained a character sequence that did not adhere
    to the naming restrictions of Unix environment variables, this
    can cause the 'export' command, and subsequently the script
    itself to fail.  This would then prevent the AMQP service from
    starting.
    

Problem conclusion

  • The IBM MQ script that is used to control the starting of the
    SYSTEM.AMQP.SERVICE such that only environment variable names,
    determined on each line of output from the 'set' command, are
    passed into the 'export' command if they begin with either a
    lowercase letter ( a-z ), an uppercase letter ( A-Z ) or an
    underscore ( _ ) character and then only contain these
    characters in addition to the digits ( 0-9 ) in the remainder of
    the name.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.0 CD    9.0.2
    v9.0 LTS   9.0.0.1
    
    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

    IT18438

  • Reported component name

    IBM MQ BASE M/P

  • Reported component ID

    5724H7261

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-12-15

  • Closed date

    2016-12-20

  • Last modified date

    2017-06-01

  • 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

    IBM MQ BASE M/P

  • Fixed component ID

    5724H7261

Applicable component levels

  • R900 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
01 June 2017