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.

Procedure

  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!