DELIVERY.FAILED

Advisory

Subject Name Syntax

_RV.ERROR.RVCM.DELIVERY.FAILED.subject

Purpose

A sender presents this advisory when the time limit of a message expires before all registered listeners have confirmed delivery.

Remarks

The time limit is fixed by the CM send call.

The sender presents this advisory after Rendezvous software deletes the message from the sender’s ledger.

The subject element is the subject name of the certified message. The subject often consists of several elements, so the wildcard character ">" (rather than "*") is the correct way to match all subjects in this position.

Message Fields

Field Name

Description

subject

The subject name of the certified message. It is identical to the subject element.

This field has datatype TIBRVMSG_STRING.

seqno

The sequence number of the failed message.

This field has datatype TIBRVMSG_U64.

data

The data portion of the failed message.

This field has datatype TIBRVMSG_MSG.

listener

A DELIVERY.FAILED advisory can contain one or more fields named listener. Each listener field contains the name of a listener that did not confirm delivery.

This field has datatype TIBRVMSG_STRING.

Diagnosis

This advisory indicates an error, and reports unexpected and usually undesirable behavior.

DELIVERY.FAILED advisories can indicate any of several difficulties:

• The physical network is unreliable.
• One or more receiving programs have terminated or are unstable.
• The sending program is using a time-out value that is too low.
• The sending program explicitly marked the message as expired.