Poll

The poll command is used to discover and retrieve server-generated service messages for the client. The server maintains a message queue for each client.

Message polling consists of two parts – the query (message polling) and the deletion (message acknowledge) of the message on the server.

After a successful request with op=”req” from the registrar, the DNS Belgium server will send a reply containing a message counter, a server-unique message identifier and the first message from the queue. In case the message queue is empty, the server will reply that there are no messages pending.

Each message sent from the DNS Belgium server must be acknowledged by the registrar by sending an “ack” request containing the unique id of the message that is being acknowledged. After receiving the acknowledgement from the registrar, the DNS Belgium server will send a reply confirming the registrar’s acknowledgement and indicating the new number of messages in the queue

Only the oldest message stored on the system is displayed. This means that the acknowledgement is required in order to view the next message.

Note

There is no follow-up for unacknowledged poll messages. The poll command is the only way to receive server-generated messages. DNS Belgium recommends to check poll messages daily.

Prerequisites

• Client must be authorized.

• A message can only be deleted if the correct message id is provided.

Transformations

This command does not apply any transformations to registry objects. It may dequeue messages.

Response details

Information returned in the response may be with or without object specific information. The object specific information is contained in a resData element.