TsgcWSPClient_STOMP_ActiveMQ › Events › OnActiveMQError

OnActiveMQError Event

Fires when an ERROR frame is received from the ActiveMQ broker; delivers the error message and the full ERROR Headers.

Syntax

property OnActiveMQError: TsgcWSActiveMQSTOMPErrorEvent;
// TsgcWSActiveMQSTOMPErrorEvent = procedure(Connection: TsgcWSConnection; MessageText: String; Headers: TsgcWSActiveMQSTOMPHeadersError) of object

Default Value

—

Remarks

Raised when the ActiveMQ broker sends an ERROR frame. The broker will normally close the connection after sending an ERROR, so the session should be considered terminated. Parameters:

• MessageText — short description of the error taken from the ERROR frame "message" header, plus the body of the frame when present.
• Headers — a TsgcWSActiveMQSTOMPHeadersError object exposing the typed ContentType, ContentLength, ReceiptId (value of the "receipt-id" header, set by the broker when the error relates to a client frame that included a "receipt" header; use this to correlate the failure with the offending request) and RawHeaders string with any ActiveMQ-specific fields.

Example

procedure TForm1.ActiveMQError(Connection: TsgcWSConnection;
  MessageText: String; Headers: TsgcWSActiveMQSTOMPHeadersError);
begin
  Memo1.Lines.Add('ActiveMQ error: ' + MessageText);
  if Headers.ReceiptId <> '' then
    Memo1.Lines.Add('  (related to receipt ' + Headers.ReceiptId + ')');
end;

Back to Events