a_remote_sql-Struktur

typedef struct a_remote_sql

Mitgliedsname	Typ	Beschreibung
apply	a_bit_field	Normalerweise auf TRUE gesetzt. Wenn die Option nicht aktiviert ist, werden Nachrichten durchsucht, aber nicht angewendet. Entspricht der dbremote-Option -a.
argv	char **	Zeiger auf eine syntaktisch analysierte Befehlszeile (ein Vektor von Zeigern auf Zeichenfolgen). Ist der Wert nicht NULL, ruft DBRemoteSQL eine Nachrichtenroutine auf, um die einzelnen Befehlszeilenargumente anzuzeigen, ausgenommen Argumente mit dem Präfix -c, -cq oder -ek.
batch	a_bit_field	Wenn auf TRUE gesetzt, wird das Beenden nach dem Anwenden der Nachricht und dem Log-Scan erzwungen (dies ist das Gleiche wie wenn mindestens ein Benutzer den Sendezeitpunkt "immer" eingestellt hat). Wenn FALSE, wird der Ausführungsmodus von den Sendezeiten der entfernten Benutzer bestimmt.
confirmrtn	MSG_CALLBACK	Adresse einer Bestätigungsanforderungs-Callback-Routine oder NULL.
connectparms	char *	Parameter für die Verbindung zur Datenbank. Sie haben die Form von Verbindungszeichenfolgen wie: "UID=DBA;PWD=sql;DBF=demo.db". Der Datenbankserver würde durch den START-Parameter der Verbindungszeichenfolge gestartet. Beispiel: "START=c:\SQLAny16\bin32\dbeng16.exe". Eine vollständige Verbindungszeichenfolge mit dem START-Parameter würde wie folgt aussehen: "UID=DBA;PWD=sql;DBF=demo.db;START=c:\SQLAny16\bin32\dbeng16.exe".
debug	a_bit_field	Wenn auf TRUE gesetzt, ist die Debug-Ausgabe eingeschlossen.
debug_dump_size	a_sql_uint32	Reserviert für den internen Gebrauch und muss auf 0 gesetzt werden.
debug_page_offsets	a_bit_field	Reserviert für den internen Gebrauch und muss auf FALSE gesetzt werden.
default_window_title	char *	Ein Zeiger auf die Zeichenfolge des Standardfenstertitels
deleted	a_bit_field	Normalerweise auf TRUE gesetzt. Wenn dies nicht gesetzt wird, werden Nachrichten nicht gelöscht, nachdem sie angewendet wurden. Entspricht der dbremote-Option -p.
encryption_key	char *	Zeiger auf einen Chiffrierschlüssel. Entspricht der dbremote-Option -ek.
errorrtn	MSG_CALLBACK	Adresse einer Fehlermeldungs-Callback-Routine oder NULL.
frequency	a_sql_uint32	Reserviert für den internen Gebrauch und muss auf 0 gesetzt werden.
full_q_scan	a_bit_field	Reserviert für den internen Gebrauch und muss auf FALSE gesetzt werden.
include_scan_range	char *	Reserviert für den internen Gebrauch und muss auf NULL gesetzt werden.
latest_backup	a_bit_field	Wenn auf TRUE gesetzt, werden nur gesicherte Logs verarbeitet. Senden Sie keine Vorgänge aus einem Live-Log. Entspricht der dbremote-Option -u.
link_debug	a_bit_field	Wenn auf TRUE gesetzt, wird die Fehlersuche für Verknüpfungen aktiviert.
locale	char *	Reserviert für den internen Gebrauch und muss auf NULL gesetzt werden.
log_file_name	const char *	Zeiger auf den Namen des DBRemoteSQL-Ausgabelogs, in das die Nachrichten-Callbacks ihre Ausgabe schreiben. Wenn send TRUE ist, wird das Fehlerlog an die konsolidierte Datenbank gesendet (ausgenommen, dieser Zeiger ist NULL).
log_size	a_sql_uint32	DBRemoteSQL benennt das Online-Transaktionslog um und startet es neu, wenn die Größe des Online-Transaktionslogs größer als dieser Wert ist. Entspricht der dbremote-Option -x.
logrtn	MSG_CALLBACK	Zeiger auf eine Funktion, die die betreffende Nachricht in eine Logdatei schreibt. Diese Nachrichten müssen vom Benutzer nicht gesehen werden.
max_length	a_sql_uint32	Auf die maximale Länge (in Byte) setzen, die eine Nachricht haben kann. Dies betrifft Senden und Empfangen. Der empfohlene Wert ist 50000. Entspricht der dbremote-Option -l.
memory	a_sql_uint32	Auf die maximale Größe (in Byte) der Speicherpuffer setzen, die beim Erstellen von zu sendenden Nachrichten verwendet werden soll. Der empfohlene Wert ist mindestens 2 * 1024 * 1024. Entspricht der dbremote-Option -m.
mirror_logs	char *	Zeiger auf den Namen des Verzeichnisses, das die Offline-Spiegeltransaktionslogs enthält. Entspricht der dbremote-Option -ml.
more	a_bit_field	Dies sollte auf TRUE gesetzt werden.
msgqueuertn	MSG_QUEUE_CALLBACK	Funktion, die von DBRemoteSQL aufgerufen wird, wenn in den Ruhezustand gewechselt werden soll. Durch diesen Parameter wird die Dauer der Ruhezeit in Millisekunden festgelegt. Diese Funktion sollte nachstehende Ergebnisse zurückgeben, wie es in dllapi.h definiert ist. MSGQ_SLEEP_THROUGH zeigt an, dass die Routine über die angeforderte Anzahl von Millisekunden im Ruhezustand war. In der Regel ist dies der Wert, den Sie zurückgeben sollten. MSGQ_SHUTDOWN_REQUESTED zeigt an, dass Sie die Synchronisation so schnell wie möglich beenden möchten.
msgrtn	MSG_CALLBACK	Adresse einer Informationsnachricht-Callback-Routine oder NULL.
no_user_interaction	a_bit_field	Wenn auf TRUE gesetzt, ist keine Benutzerinteraktion erforderlich.
operations	a_sql_uint32	Dieser Wert wird verwendet, wenn Nachrichten übernommen werden. Festschreibungen werden ignoriert, bis DBRemoteSQL mindestens diese Anzahl von nicht festgeschriebenen Vorgängen (Einfügungen, Löschungen, Aktualisierungen) hat. Entspricht der dbremote-Option -g.
patience_retry	a_sql_uint32	Diese Option auf die Anzahl der Abfragen eingehender Nachrichten setzen, die DBRemoteSQL warten soll, bevor angenommen wird, dass eine erwartete Nachricht verloren gegangen ist. Wenn beispielsweise patience_retry 3 ist, versucht DBRemoteSQL bis zu drei Mal, die fehlende Nachricht zu erhalten. Anschließend wird eine Neusendeanforderung gesendet. Der empfohlene Wert ist 1. Entspricht der dbremote-Option -rp.
progress_index_rtn	SET_PROGRESS_CALLBACK	Zeiger auf eine Funktion, die den Status der Fortschrittsleiste aktualisiert. Diese Funktion hat zwei ganzzahlige Argumente ohne Vorzeichen, nämlich index und max. Beim ersten Aufruf haben die Werte den Mindest- bzw. Höchstwert (z.B. 0, 100). Bei nachfolgenden Aufrufen ist das erste Argument der aktuelle Indexwert (z.B. zwischen 0 und 100) und das zweite Argument ist immer 0.
progress_msg_rtn	MSG_CALLBACK	Zeiger auf eine Funktion, die eine Fortschrittsmeldung anzeigt
queueparms	char *	Reserviert für den internen Gebrauch und muss auf NULL gesetzt werden.
receive	a_bit_field	Wenn auf TRUE gesetzt, werden Nachrichten empfangen. Wenn receive und send jeweils FALSE sind, werden beide als TRUE behandelt. Es wird empfohlen, die Einstellung receive und send von auf FALSE zu setzen. Entspricht der dbremote-Option -r.
receive_delay	a_sql_uint32	Diese Option auf die Zeitdauer (in Sekunden) setzen, die zwischen Abfragen neuer eingehender Nachrichten gewartet werden soll. Der empfohlene Wert ist 60. Entspricht der dbremote-Option -rd.
remote_output_file_name	char *	Zeiger auf den Namen der entfernten DBRemoteSQL-Ausgabedatei. Entspricht der dbremote-Option -ro oder -rt.
rename_log	a_bit_field	Wenn auf TRUE gesetzt, werden Logs umbenannt und neu gestartet (nur DBRemoteSQL).
resend_urgency	a_sql_uint32	Die Zeitdauer (in Sekunden) setzen, die DBRemoteSQL wartet, nachdem erkannt wurde, dass ein Benutzer einen Rescan durchführen muss, bevor das Log vollständig durchsucht werden kann. Auf Null setzen, damit DBRemoteSQL einen guten Wert basierend auf den Benutzer-Sendezeiten und anderer gesammelter Informationen wählen kann. Entspricht der dbremote-Option -ru.
scan_log	a_bit_field	Reserviert für den internen Gebrauch und muss auf FALSE gesetzt werden.
send	a_bit_field	Wenn auf TRUE gesetzt, werden Nachrichten gesendet. Wenn receive und send jeweils FALSE sind, werden beide als TRUE behandelt. Es wird empfohlen, die Einstellung receive und send von auf FALSE zu setzen. Entspricht der dbremote-Option -s.
send_delay	a_sql_uint32	Die Zeitdauer (in Sekunden) zwischen Analysen der Logdatei bezüglich neuer zu sendender Vorgänge. Auf Null setzen, wenn DBRemoteSQL einen guten Wert basierend auf Benutzer-Sendezeiten wählen soll. Entspricht der dbremote-Option -sd.
set_window_title_rtn	SET_WINDOW_TITLE_CALLBACK	Zeiger auf eine Funktion, die den Titel des Fensters zurücksetzt (nur Windows). Der Titel könnte "Datenbankname (Empfangen, Durchsuchen oder Senden) - Standardfenstertitel" sein.
threads	a_sql_uint32	Die Anzahl von Worker-Threads, die für das Zuweisen von Nachrichten verwendet werden sollen. Dieser Wert darf 50 nicht überschreiten. Entspricht der dbremote-Option -w.
transaction_logs	char *	Sollte das Verzeichnis der Offline-Transaktionslogs identifizieren (nur DBRemoteSQL). Entspricht dem Argument transaction_logs_directory von dbremote.
Trigger	a_bit_field	Dies sollte normalerweise gelöscht werden (FALSE). Wenn auf TRUE gesetzt, werden Triggeraktionen repliziert. Hier ist mit Vorsicht vorzugehen.
truncate_remote_output_file	a_bit_field	Wenn auf TRUE gesetzt, wird die entfernte Ausgabedatei gekürzt und nichts an sie angehängt. Entspricht der dbremote-Option -rt.
Nicht verwendet	a_bit_field	Reserviert für den internen Gebrauch und muss auf FALSE gesetzt werden.
use_hex_offsets	a_bit_field	Wenn auf TRUE gesetzt, werden Log-Offsets in hexadezimaler Schreibweise angezeigt. Andernfalls wird die dezimale Schreibweise verwendet.
use_relative_offsets	a_bit_field	Wenn auf TRUE gesetzt, werden Log-Offsets als relativ zum Start der aktuellen Logdatei angezeigt. Wenn auf FALSE gesetzt werden Log-Offsets vom Anfang an angezeigt.
verbose	a_bit_field	Wenn aktiviert, werden zusätzliche Informationen erzeugt. Entspricht der dbremote-Option -v.
version	unsigned short	DBTools-Versionsnummer (DB_TOOLS_VERSION_NUMBER).
warningrtn	MSG_CALLBACK	Zeiger auf eine Funktion, die die angegebene Warnmeldung anzeigt. Wenn NULL, wird stattdessen die Funktion errorrtn aufgerufen.

Das Dienstprogramm dbremote legt die folgenden Standardwerte vor der Verarbeitung von Befehlszeilenoptionen fest:

version = DB_TOOLS_VERSION_NUMBER
argv = (an Anwendung übergebener Argumentvektor)
deleted = TRUE
apply = TRUE
more = TRUE
link_debug = FALSE
max_length = 50000
memory = 2 * 1024 * 1024
frequency = 1
threads = 0
receive_delay = 60
send_delay = 0
log_size = 0
patience_retry = 1
resend_urgency = 0
log_file_name = (in Befehlszeile gesetzt)
truncate_remote_output_file = FALSE
remote_output_file_name = NULL
no_user_interaction = TRUE (wenn Benutzerschnittstelle nicht verfügbar ist)
errorrtn = (Adresse einer geeigneten Routine)
msgrtn = (Adresse einer geeigneten Routine)
confirmrtn = (Adresse einer geeigneten Routine)
msgqueuertn = (Adresse einer geeigneten Routine)
logrtn = (Adresse einer geeigneten Routine)
warningrtn = (Adresse einer geeigneten Routine)
set_window_title_rtn = (Adresse einer geeigneten Routine)
progress_msg_rtn = (Adresse einer geeigneten Routine)
progress_index_rtn = (Adresse einer geeigneten Routine)

DBRemoteSQL-Methode [Datenbanktools]

a_remote_sql-Struktur

Syntax

Mitglieder

Bemerkungen

Siehe auch