Chapter 3. Getting started

This chapter guides you through the steps to set up your environment and run a simple messaging program.

3.1. Prerequisites

  • You must complete the installation procedure for your environment.
  • You must have an AMQP 1.0 message broker listening for connections on interface localhost and port 5672. It must have anonymous access enabled. For more information, see Starting the broker.
  • You must have a queue named examples. For more information, see Creating a queue.

3.2. Running Hello World on Red Hat Enterprise Linux

The Hello World example creates a connection to the broker, sends a message containing a greeting to the examples queue, and receives it back. On success, it prints the received message to the console.


  1. Copy the examples to a location of your choosing.

    $ cp -r /usr/share/proton/examples/cpp cpp-examples
  2. Create a build directory and change to that directory:

    $ mkdir cpp-examples/bld
    $ cd cpp-examples/bld
  3. Use cmake to configure the build and use make to compile the examples.

    $ cmake ..
    $ make
  4. Run the helloworld program.

    $ ./helloworld
    Hello World!