ZA Polling & Acking Messages
Requesting a Queued Message
Requesting a Queued Message
Poll messages awaiting in the queue can be retrieved using the EPP Poll command. To send the poll command, the <poll op=”req”/> element has to be included. The attribute op refers to the operation that the poll command must perform. A value of req for the op attribute means that the operation to be performed by the poll command is a request for queued messages.
Interpretation of received poll message
- A result code of 1301 means that there was at least 1 message in the message queue. The result will also contain the message. See below for an example of a 1301 response.
- If the poll command was sent correctly, the server will respond with either a result code of 1300 or 1301.
- A result code of 1300 means that there are no messages in the message queue.
-
The <epp:mgsQ> element contains information about the command that yielded the poll message. the count attribute shows the message count queued. The id attribute will contain a value that shows the unique tracking id of the message. This id will be used to ack the message.
-
The <epp:resData> element contains information about what the command result was.
-
The <epp:trID> element contains the unique tracking ID of the poll command.
Polling for messages allows messages to move up in the message queue, meaning that other messages awaiting in the queue can only be retrieved once the messages in front of them are requested and acknowledged.
Acknowledging Poll Messages
Acknowledging Poll Messages
If a message as been polled for and there is no longer a need for the message, it must be acknowledged. Acknowledging a message will result in the message being removed from the queue, allowing other messages to be retrieved.
Note: Messages are queued in a “First-In-First-Out” order. It is therefore advised that messages are polled for on a constant basis so as to avoid a very large message queue.
To acknowledge a message, a poll command must be sent. In the command the following elements are required:
-
– <poll op=”ack” msgID=”12345″> : The op attribute with a value of ack indicates to the server that a poll command must be performed where the operation is to ack a message. The message to be acked must be specified. To specify the message, include the message id; obtained through the above example; in the msgID attribute.
-
– <clTRID> : A unique ID of a minimum of 8 characters must be used. The ID can later be used to acquire a poll message about the acking of a message.
Contact Poll Messages
This section looks at the possible message responses that can be received when polling for a message where the information contained refers to registrants.
Contact Update Pending
Address Information Cannot Be Empty
Domain Poll Messages
Nameserver Associated Messages
All ZA policies perform nameserver checks on the initial registration of a domain as well well as on any update of nameservers. In doing this, there are several messages that will be queued for a registrar regarding nameservers. The following messages may appear in a registrar’s message queue:
- “2306: Authoritative Nameserver failure for domain ‘exampledomain.test.dnservices.co.za’: Timeout from ‘A.B.C.D'” means that the nameserver with IP address A.B.C.D is unreachable by the registry for verification of authority against the domain name. Please ensure that the nameserver is authoritative and that the incoming IP addresses of the registry are allowed to query the nameserver. The registry will reperform automatic checks on the nameservers every hour for 1 consecutive week for new registrations.
- “Warning: Nameserver failure for suspended domain ‘exampledomain.test.dnservices.co.za'” means that the registry has attempted to verify the nameservers specified at the time of registration of the domain, for 7 consecutive days. After 7 days, the registry will stop checking the nameservers and keep the domain suspended. Please issue a domain update to include authoritative nameservers.
- “Nameserver check successful for ‘exampledomain.test.dnservices.co.za'” means that the nameservers specified on the registration of a new domain name have been identified as authoritative. Having received this message, the domain name will be unsuspended and published in the next zone update.
General Domain Update Successful
A message similar to the one below will be queued when a pending update on a domain was successful.
Domain Auto-Renew
If a domain has expired and the autorenew flag is set to “True”, the domain will be automatically renewed for an additional year if funds are available.
The simplest way to identify that a domain has been renewed through the auto-renew is by the “
Domain Delete Successful
Domain Delete Within Grace Period
If a domain is deleted within the grace period, the message below will be queued at the end of the Grace Period when the domain is released back into the pool of available names.
Domain Delete Due to Expiry
- If a domain has expired and the Autorenew flag is set to false, the domain will enter Auto-Delete and the Pending Suspension Phase.
- If after 5 days the domain has not been renewed, the domain will enter the Pending Deletion Phase and the action as listed below will be “PendingDeletion”
The following poll message will be queued if a domain enters the Deletion Process due to expiry.
Request Canceled By Another Process
The message below is received when an update was attempted, but the update was cancelled before it could be applied. Updates can be cancelled due to transfers, renewals, or the issuing of a Cancel Pending Action request. For the example below the pending update action will be ‘PendingSuspension’. The message is sent to the registrar who successfully cancelled the pending update.
Transfer Request
The message below is received when a transfer request is issued for a domain. The Registrar of Record will receive the message.
Domain Transfer Successful
Message to New Registrar of Record
The message below is received when a transfer of a domain has been successful. The message is received by the new Registrar of Record of the domain.
Message to Old Registrar of Record
The message below will be queued to the old Registrar of Record when a transfer has been completed.
Transfer Rejected
If a transfer for a domain was not successful, the requesting registrar will receive the following poll message.
Message to Registrar of Record
If a transfer for a domain was not successful, the Registrar of Record will receive the following poll message.
Domain Update While in Transfer Phase
In this scenario, a transfer request for the domain was issued. While the domain was still in the Transfer process, an update was performed on the domain.
The Transfer period was allowed to exire. Upon expiration of the Transfer period, the update on the domain was still outstanding.
The domain was transfered and the update that was outstanding was cancelled.
The update will also get cancelled if the transfer request is processed via the registrant e-mail voting.
The losing registrar that performed the update during the transfer process will receive the poll message.
Domain Transfer While in Update Phase
In this scenario an update was performed on a domain. During the update, a transfer request was sent for the domain.
The update for the domain was executed prior to the transfer being approved.
When this happens, the transfer is cancelled to allow for the review of the change prior to another transfer decision being made.
The poll message below will be queued.
Domain Transfer While in Deletion Phase
In this scenario a domain is in the Deletion phase. While in the Deletion phase, a transfer request is sent for the domain.
The transfer is processed prior to the domain being deleted via registrant voting.
If the domain goes past the suspension phase and enters the final deletion phase, the request “PendingDeletion” will be canceled.
The result is that the domain is not deleted, but transfered to the requesting registrar.
Domain Delete With New Dependancy
While in the Deletion Phase, a new domain is created, relying on the subordinate hosts of the deleting domain.
This means that the currently deleting domain cannot be deleted as the newly created domain uses the deleting domain’s subordinate hosts.
The domain will exit its deletion phase, and a poll message will be returned.
Cancel Domain Deletion With No Funds
The message below will only be queued if:
- A domain has the Autorenew Flag set to “True”
- The registrar has insufficient funds in their account
- The domain expires and is triggered for suspension
- The registrar attempts to cancel either the “PendingSuspension” or “PendingDeletion” actions
If the registrar has no funds available and attempts to cancel the deletion of a domain that has entered the Deletion Phase through Autorenew, the message below will be queued upon attempt to cancel the deletion.