Freigeben über


PublisherMonitor.EnumDistributionAgentSessions(String, Int32, Boolean) Methode

Definition

Gibt Informationen zu Verteilungs-Agentsitzungen zurück.

public:
 System::Data::DataSet ^ EnumDistributionAgentSessions(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);
public System.Data.DataSet EnumDistributionAgentSessions (string agentName, int sessionDuration, bool returnOnlyErrorSessions);
member this.EnumDistributionAgentSessions : string * int * bool -> System.Data.DataSet
Public Function EnumDistributionAgentSessions (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSet

Parameter

agentName
String

Ein String-Wert, der den Namen des Verteilungs-Agentauftrags angibt. Sie können diesen Wert mithilfe der SynchronizationAgentName-Eigenschaft des TransSubscription-Objekts abrufen.

sessionDuration
Int32

Ein Int32-Wert, der die Anzahl der Stunden vor der aktuellen Zeit angibt, auf die die Ergebnisse beschränkt werden. Wenn der Wert z. B. "24" ist, werden Informationen zu Verteilungs-Agentsitzungen der letzten 24 Stunden zurückgegeben. Bein einem Wert von "-1" werden Informationen zu den letzten 100 Sitzungen und bei einem Wert von "0" Informationen zu allen Sitzungen zurückgegeben.

returnOnlyErrorSessions
Boolean

Ein Boolean-Wert, der angibt, ob Informationen nur zu Sitzungen, bei denen ein Fehler aufgetreten ist, oder zu allen Sitzungen zurückgegeben werden. Wenn true, werden nur Informationen zu Sitzungen zurückgegeben, bei denen ein Fehler aufgetreten ist. Wenn false, werden Informationen zu allen Sitzungen zurückgegeben.

Gibt zurück

Ein DataSet-Objekt, das die folgenden Spalten enthält.

Column Datentyp BESCHREIBUNG
runstatusInt32 Der Ausführungsstatus:

1 = Start

2 = Erfolg

3 = In Bearbeitung

4 = Im Leerlauf

5 = Wiederholen

6 = Fehler

start_timeString Datum und Uhrzeit der letzten Agentausführung.
timeString Datum und Uhrzeit der Sitzungsprotokollierung.
commentsString Meldungstext, der vom Agent protokolliert wurde.
durationInt32 Verstrichene Zeit der Sitzung, in Sekunden.
delivery_rateSingle Durchschnittliche Anzahl der pro Sekunde übermittelten Befehle.
delivery_latencyInt32 Latenzzeit (in Millisekunden) zwischen dem Eintritt der Transaktion in die Verteilungsdatenbank und deren Anwendung auf den Abonnenten.
(Kein Spaltenname) Nicht verfügbar Nur zur internen Verwendung.
delivered_transactionsInt32 Gesamtzahl der in der Sitzung übermittelten Transaktionen.
delivered_commandsInt32 Gesamtzahl der in der Sitzung übermittelten Befehle.
average_commandsInt32 Durchschnittliche Anzahl der in der Sitzung pro Transaktion übermittelten Befehle.
action_countInt32 Anzahl von Agentprotokollmeldungen, die in der Sitzung aufgezeichnet wurden.
error_idInt32 Die ID des Fehlers in der Systemtabelle [MSrepl_errors (Transact-SQL)](http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) Verwenden Sie die EnumErrorRecords(Int32)-Methode, um ausführliche Informationen zu einem Fehler zurückzugeben.

Hinweise

Sie sollten alle Eigenschaftsänderungen am PublisherMonitor Objekt committen, bevor Sie diese Methode aufrufen, da Eigenschaften dieses Objekts möglicherweise geladen werden müssen, wenn sie noch nicht geladen wurden.

Die EnumDistributionAgentSessions -Methode kann nur von Membern oder db_ownerreplmonitor festen Datenbankrollen in der Verteilungsdatenbank aufgerufen werden.

Gilt für:

Weitere Informationen