Inspirel banner

Programming Distributed Systems with YAMI4

7.3.1 Put

The ``put'' command allows to append arbitrary message to the given queue. In order to execute this command the client has to send a message with the following structure:

Object name: name of the queue, which is supposed to store the new content.

Message name: "put".

Message content: arbitrary.

If the operation is requested for the queue that does not exist, it will be created automatically if allowed by the configuration - otherwise the request will be rejected.

If the operation is successful, the server replies with an empty parameters object.

The operation can fail if the data value that is sent could overflow the given queue based on the configurable limits, in which case the message is rejected. See further subsection on configuration parameters for details.