sp_help_downloadlist (Transact-SQL)

Syntax

sp_help_downloadlist { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } 
     [ , [ @operation = ] 'operation' ] 
     [ , [ @object_type = ] 'object_type' ] 
     [ , [ @object_name = ] 'object_name' ] 
     [ , [ @target_server = ] 'target_server' ] 
     [ , [ @has_error = ] has_error ] 
     [ , [ @status = ] status ] 
     [ , [ @date_posted = ] date_posted ]

Argumente

• [ @job_id= ] job_id
  Die ID des Auftrags, für den Informationen zurückgegeben werden sollen. job_id ist vom Datentyp uniqueidentifier; der Standardwert ist NULL.

• [ @job_name= ] 'job_name'
  Der Name des Auftrags. job_name ist vom Datentyp sysname; der Standardwert ist NULL.

  Hinweis
  Es muss entweder job_id oder job_name angegeben werden, aber beide Angaben sind nicht möglich.

• [ @operation= ] 'operation'
  Der gültige Vorgang für den angegebenen Auftrag. operation ist ein Wert vom Datentyp varchar(64). Der Standardwert ist NULL. Die folgenden Werte sind möglich.

  Wert	Beschreibung
  DEFECT	Servervorgang, mit dem der Zielserver aus dem Master-SQLServerAgent-Dienst ausgetragen wird.
  DELETE	Auftragsvorgang, mit dem ein gesamter Auftrag entfernt wird
  INSERT	Auftragsvorgang, der einen gesamten Auftrag einfügt oder einen vorhandenen Auftrag aktualisiert. Dieser Vorgang schließt ggf. alle Auftragsschritte und Zeitpläne ein.
  RE-ENLIST	Servervorgang, der bewirkt, dass der Zielserver die Eintragsinformationen, einschließlich des Abrufintervalls und der Zeitzone, erneut an die Multiserverdomäne sendet. Die MSXOperator-Details werden vom Zielserver ebenfalls erneut heruntergeladen.
  SET-POLL	Servervorgang, der festlegt, in welchem Intervall (in Sekunden) die Zielserver die Multiserverdomäne abfragen. Wenn angegeben, wird value als der erforderliche Intervallwert interpretiert. Mögliche Werte reichen von 10 bis 28.800.
  START	Auftragsvorgang, der den Start der Auftragsausführung anfordert
  STOP	Auftragsvorgang, der das Beenden der Auftragsausführung anfordert
  SYNC-TIME	Servervorgang, der bewirkt, dass der Zielserver die Systemuhr mit der Multiserverdomäne synchronisiert. Dies ist ein kostenaufwendiger Vorgang und sollte deshalb nur selten und in begrenztem Umfang durchgeführt werden.
  UPDATE	Auftragsvorgang, der nur die sysjobs-Informationen für einen Auftrag aktualisiert. Die Auftragsschritte und Zeitpläne werden nicht aktualisiert. Der Aufruf erfolgt automatisch durch sp_update_job.

• [ @object_type= ] 'object_type'
  Der Objekttyp für den angegebenen Auftrag. object_type ist ein Wert vom Datentyp varchar(64). Der Standardwert ist NULL. Mögliche Werte für object_type sind JOB und SERVER. Weitere Informationen zu gültigen object_type-Werten finden Sie unter sp_add_category (Transact-SQL).

• [ @object_name= ] 'object_name'
  Der Name des Objekts. object_name ist vom Datentyp sysname; der Standardwert ist NULL. Wenn object_type den Wert JOB aufweist, entspricht object_name dem Auftragsnamen. Wenn object_type den Wert SERVER aufweist, entspricht object_name dem Servernamen.

• [ @target_server= ] 'target_server'
  Der Name des Zielservers. target_server ist vom Datentyp nvarchar(128); der Standardwert ist NULL.

• [ @has_error= ] has_error
  Gibt an, ob der Auftrag Fehler bestätigen soll. has_error ist ein Wert vom Datentyp tinyint. Der Standardwert ist NULL, wodurch angezeigt wird, dass keine Fehler bestätigt werden sollen. Der Wert 1 zeigt an, dass alle Fehler bestätigt werden sollen.

• [ @status= ] status
  Der Status des Auftrags. status ist ein Wert vom Datentyp tinyint. Der Standardwert ist NULL.

• [ @date_posted= ] date_posted
  Das Datum und die Uhrzeit eines Zeitpunkts. Alle Einträge, die an oder nach diesem Zeitpunkt vorgenommen wurden, sollen in das Resultset eingeschlossen werden. date_posted ist ein Wert vom Datentyp datetime. Der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname	Datentyp	Beschreibung
instance_id	int	Eindeutige, ganzzahlige ID der Anweisung
source_server	nvarchar(30)	Computername des Servers, vom dem die Anweisung stammt. In MicrosoftSQL Server, Version 7.0, ist dies immer der Computername des (MSX)-Masterservers.
operation_code	nvarchar(4000)	Vorgangscode für die Anweisung
object_name	sysname	Objekt, das von der Anweisung betroffen ist
object_id	uniqueidentifier	ID des Objekts, das von der Anweisung betroffen ist (job_id für ein Auftragsobjekt oder 0x00 für ein Serverobjekt) oder ein spezifischer Datenwert für operation_code.
target_server	nvarchar(30)	Zielserver, der diese Anweisung herunterladen soll
error_message	nvarchar(1024)	Gegebenenfalls Fehlermeldung vom Zielserver, falls beim Verarbeiten dieser Anweisung ein Problem aufgetreten ist. Hinweis Fehlermeldungen blockieren alle weiteren Downloadvorgänge durch den Zielserver.
date_posted	datetime	Datum, an dem die Anweisung für die Tabelle bereitgestellt wurde
date_downloaded	datetime	Datum, an dem die Anweisung durch den Zielserver heruntergeladen wurde
status	tinyint	Status des Auftrags: 0 = Noch nicht heruntergeladen 1 = Erfolgreich heruntergeladen

Berechtigungen

Standardmäßig verfügen Mitglieder der festen Serverrolle sysadmin über Berechtigungen zum Ausführen dieser Prozedur.

Beispiele

Im folgenden Beispiel werden Zeilen in der sysdownloadlist-Tabelle für den Auftrag NightlyBackups aufgelistet.

USE msdb ;
GO

EXEC dbo.sp_help_downloadlist
    @job_name = N'NightlyBackups',
    @operation = N'UPDATE', 
    @object_type = N'JOB', 
    @object_name = N'NightlyBackups',
    @target_server = N'SEATTLE2', 
    @has_error = 1, 
    @status = NULL, 
    @date_posted = NULL ;
GO

Siehe auch

Verweis