EMG 5.4.7 - User's Guide
10. Delivery receipts (DLR)
Delivery receipts, or DLRs as we call them, are special status messages generated by the SMSC when the final status of a message has been reached. For example if a message is sent to a phone successfully the SMSC can generate a DLR when the phone has acknowledged receiving the message.
Usually when a message passes through EMG and it is successfully delivered to the SMSC the status of the message is RELAYED. This means that the message was successfully transferred to and accepted by the SMSC but we still do not know if the message reached its final destination, the phone.
However if a DLR was requested then the SMSC would send a DLR back to EMG when the final status is reached, in this case DELIVERED. EMG then updates the message status from RELAYED to DELIVERED, a final status.
A DLR basically consists of a message id and a status. In EMG the MGP option MGP_OPTION_MSGTYPE is set MSGTYPE_DLR (5) to indicate that a message is in fact a DLR.
DLRs are propagated through EMG as any other message except that the special ROUTEDLR keyword is used for routing. If ROUTEDLR is not specified an DLR is routed to the connector from which the original message was received.
For messages terminated within EMG for any reason, DLRs will be generated and sent out. For example, when a message is delivered using a HTTP, SMTP, MGP or EBE connector, EMG sets the final status to DELIVERED and a DLR is generated, if requested.
10.2 Requesting a DLR
A DLR can be requested in several ways.
10.2.1 Using emgsend
The MGP option DLR can be specified on the command line.
emgsend -o DLR=1 46123456 "test message"
10.2.2 Using connector keyword
If DEFAULT_DLR keyword is used the default behavior for messages using the connector is set. However, a message-specific option always supersedes the "DEFAULT" connector options.
CONNECTOR smpp-out <
The keyword FORCE_DLR on the other hand overrides any DLR message option already set. When FORCE_DLR=1 is used on a connector where messages are received the DLRs received or generated will be forwarded back to the client, while if FORCE_DLR=1 is used on a connector where messages are sent the received DLRs will only be used to update the message status and then silently dropped.
Please note that DLRs silently dropped will not appear in the corresponding connector log but will only show up in the pdu log for the connector.
10.3 Routing DLRs
For incoming DLRs routing decisions are made a little differently than for normal messages.
It is evaluated in the following order with the highest priority first:
DLRs can optionally be redirected from one connector to another via connector keyword REDIRECT.
10.4 DLRs and buffered status
Some SMSCs send a DLR when the message has been accepted or if the message is buffered in the SMSC due to handset being switched off for example.
Such a DLR will not be propagated through EMG but will only update the "bufferedstatus" field in the routelog table within EMG. When using EMG with a database this field can be queried in order to determine if and why a message has been buffered.
The message status will remain as "RELAYED" even after a DLR with a buffered status has been received.