[openamq-dev] "instance" argument to amq_client_connectionn_new

[Martin Lucina]

Nick,

ndl at ravenbrook.com said:
> The fourth argument to amq_client_connectionn_new() is not documented
> in the WireAPI spec. From the include file, I see that the parameter
> is named "instance" with the comment "Client instance name".
> 
> I ploughed through the AMQP documentation and couldn't find any
> obvious reference to this parameter. What does it do?

It's not part of AMQP and gets passed in the list of properties attached
to connection.start-ok.

It's only purpose is to allow unique identification of clients based on
the instance string, both in the server logs in case of errors and in
the console.

E.g., in amq_shell, you can do things like:

  ls conn *INSTANCE*

to list all connections containing the string INSTANCE in the instance
name, or host name.

We generally set it to argv[0] in our clients, but you can set it to
anything you like.

Martin