IPS_GetInstanceMessageQueueSize

 int IPS_GetInstanceMessageQueueSize ()

Rückgabewert

Anzahl der noch nicht vollständig verarbeiteten Nachrichten an Instanzen

Beschreibung

Diese Funktion ist nur für den internen Gebrauch vorgesehen und kann sich jederzeit ohne Ankündigung ändern oder entfallen.

Die Funktion liefert die Anzahl der Nachrichten, die an Instanzen zugestellt werden sollen und von deren MessageSink noch nicht vollständig verarbeitet wurden. Eine Nachricht an mehrere Instanzen zählt je Instanz. Im Normalbetrieb ist der Wert 0 oder sehr klein. Ein dauerhaft steigender Wert deutet darauf hin, dass Instanzen Nachrichten langsamer verarbeiten, als sie eintreffen. Welche Instanzen betroffen sind, lässt sich mit IPS_GetInstanceMessageStatistics ermitteln.

Die Funktion steht unabhängig vom Spezialschalter "MessageQueueWatch" zur Verfügung.

Beispiel

echo IPS_GetInstanceMessageQueueSize(); // liefert z.B. 0