Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Wenn beide mit demselben Namen vorhanden sind, wird die Umgebungsvariable verwendet. Siehe Konfigurationsdateien verwenden.

Wenn Sie Kennwörter oder andere Informationen in einer Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien verwenden. Siehe Dienstprogramm zum Verschleiern von Dateien (dbfhide).

Die Umgebungsvariable kann eine beliebige Menge von Befehlszeilenoptionen enthalten. Die erste der folgenden zwei Anweisungen setzt zum Beispiel eine Umgebungsvariable, die eine Reihe von Befehlszeilenoptionen für einen SQL Remote-Prozess enthält, der mit einer Cachegröße von 4 MB startet, nur Nachrichten empfängt und mit einer Datenbank namens field auf einem Datenbankserver namens myserver verbunden wird . Die SET-Anweisung muss in einer einzigen Zeile eingegeben werden:

SET envvar=-m 4096 -r
 -c "Server=myserver;DBN=field;UID=sa;PWD=sysadmin"
dbremote @envvar

Die Konfigurationsdatei enthält Zeilenumbrüche und kann eine beliebige Menge von Optionen enthalten. Die folgende Befehlsdatei enthält zum Beispiel eine Reihe von Befehlszeilenoptionen für einen SQL Remote-Nachrichtenagenten, der mit einer Cachegröße von 4 MB startet, nur Nachrichten versendet und eine Verbindung mit einer Datenbank namens field auf einem Datenbankserver mit Namen myserver herstellt:

-m 4096
-s
-c "Server=myserver;DBN=field;UID=sa;PWD=sysadmin"

Wenn diese Konfigurationsdatei als c:\config.txt gespeichert wird, kann sie folgendermaßen in einem Befehl verwendet werden:

dbremote @c:\config.txt

Legt Verbindungsparameter fest. Wenn diese Option nicht angegeben ist, wird die Umgebungsvariable SQLCONNECT verwendet.

Die folgende Anweisung führt beispielsweise dbremote mit einer Datenbankdatei namens c:\mydata.db aus und verbindet sich als Benutzer DBA mit dem Kennwort sql:

dbremote -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"

Der SQL Remote-Nachrichtenagent muss von einem Benutzer mit REMOTE DBA- oder DBA-Datenbankberechtigung ausgeführt werden. Siehe REMOTE DBA-Berechtigung erteilen.

Der SQL Remote-Nachrichtenagent unterstützt alle Bereiche der SQL Anywhere-Verbindungsparameter. Siehe Verbindungsparameter.

Maximallänge der einzelnen zu versendenden Nachricht in Byte. Längere Transaktionen werden in mehr als eine Nachricht aufgeteilt. Der Standardwert ist 50000 Byte und die Minimallänge ist 10000.

Bei Plattformen mit eingeschränkter Speicherzuordnung muss dieser Wert kleiner als die maximale Speicherzuordnung des Betriebssystems sein.

Bestimmt die Höchstmenge an Speicher, die vom SQL Remote-Nachrichtenagenten zum Aufbau der Nachrichten und für die Cachebenutzung von eintreffenden Nachrichten verwendet werden soll. Die zulässige Größe kann als n (in Byte), nK oder nM angegeben werden. Der Standardwert ist 2048 kB (2 MB).

Wenn alle entfernten Datenbanken eindeutige Teilmengen der Vorgänge erhalten, die repliziert werden, wird eine separate Nachricht für jede entfernte Datenbank gleichzeitig aufgebaut. Für eine Gruppe von entfernten Benutzern, die dieselben Vorgänge erhalten, wird nur eine Nachricht aufgebaut. Wenn der verwendete Speicher den Wert -m überschreitet, werden Nachrichten versendet, bevor sie ihren Höchstwert (wie von der Option -l festgelegt) erreichen.

Wenn Nachrichten eintreffen, werden sie vom SQL Remote-Nachrichtenagenten im Speicher abgelegt, bis sie übernommen werden. Diese Cachebenutzung von Nachrichten verhindert ein nochmaliges Lesen von Nachrichten, die die falsche Reihenfolge haben, was möglicherweise die Performance auf großen Installationen vermindert. Wenn die mit der Option -m festgelegte Speicherzuweisung überschritten wird, werden Nachrichten ausgelagert, und zwar jene zuerst, die am längsten nicht verwendet wurden.

Gibt den Speicherort von Offline-Transaktionslog-Spiegeldateien an. Mit dieser Option kann dbremote alte Transaktionslog-Spiegeldateien löschen, wenn einer der beiden folgenden Umstände eintritt:

In einer normalen Installation befinden sich der aktive Transaktionslogspiegel und die umbenannten Transaktionslogspiegel in demselben Verzeichnis und dbremote läuft auf demselben Computer wie die entfernte Datenbank, sodass diese Option nicht erforderlich ist und alte Transaktionslog-Spiegeldateien automatisch gelöscht werden. Transaktionslogs in diesem Verzeichnis sind nur betroffen, wenn die Datenbankoption delete_old_logs auf einen anderen Wert als Off eingestellt ist.

Legt die maximale Dateigröße zur Protokollierung von Ausgabenachrichten fest. Die zulässige Größe kann als n (Byte), nK (kB) oder nM (MB) angegeben werden). Standardmäßig gibt es kein Limit, und die Untergrenze ist 10000 Byte.

Bevor SQL Remote Ausgabenachrichten in eine Ausgabelogdatei protokolliert, wird die aktuelle Dateigröße überprüft. Wenn die Dateigröße den festgelegten Wert aufgrund der Lognachricht überschreitet, benennt SQL Remote die Ausgabedatei in jjmmttxx.dbs um, wobei xx eine Buchstabenserie von AA bis ZZ ist und jjmmtt Jahr, Monat und Tag darstellen.

Wenn der SQL Remote-Nachrichtenagent für lange Zeit im kontinuierlichen Modus läuft, können Sie mit dieser Option alte Ausgabelogdateien manuell löschen und dadurch Speicherplatz freisetzen.

Empfängt Nachrichten. Wenn weder -r noch -s angegeben ist, führt der SQL Remote-Nachrichtenagent beide Phasen aus. Sonst werden nur die angegebenen Phasen ausgeführt.

Der SQL Remote-Nachrichtenagent läuft im kontinuierlichen Modus, wenn er mit der Option -r ausgeführt wird. Damit der SQL Remote-Nachrichtenagent nach dem Nachrichtenempfang herunterfährt, verwenden Sie zusätzlich zu -r auch die Option -b.

Legt die Abrufhäufigkeit für eingehende Nachrichten fest. Standardmäßig sucht der SQL Remote-Nachrichtenagent jede Minute nach ankommenden Nachrichten. Diese Option (rd steht für receive delay) ermöglicht die Konfiguration der Abrufhäufigkeit, die nützlich ist, wenn der Abruf die Systemressourcen stark in Anspruch nimmt.

Sie können das Suffix s nach der Zahl benutzen, um Sekunden zu definieren. Dies kann nützlich sein, wenn häufige Abrufe gewünscht werden. Beispiel: Der folgende Befehl führt einen Abruf alle dreißig Sekunden durch:

dbremote -rd 30s

Die Befehlszeilenoption -rd wird häufig zusammen mit der Option -rp verwendet, die die Anzahl der Abrufe festlegt, die der SQL Remote-Nachrichtenagent abwartet, bevor das Neusenden einer fehlenden Nachricht angefordert wird.

Siehe Performance beim Nachrichtenempfang verbessern.

Protokolliert die entfernte Ausgabe in einer Datei. Diese Option wird in der konsolidierten Datenbank verwendet. Wenn entfernte Datenbanken so konfiguriert sind, dass sie Ausgabeloginformationen an die konsolidierte Datenbank senden, schreibt diese Option die Informationen in eine Datei. Die Option wird bereitgestellt, damit Administratoren Fehler an entfernten Standorten beheben können.

Siehe Fehler von der entfernten Datenbank sammeln.

Gibt die Anzahl der Empfangsabrufe an, bevor eine Nachricht als verloren angesehen wird. Wenn der SQL Remote-Nachrichtenagent kontinuierlich läuft, prüft der Nachrichtenagent die Nachrichten in bestimmten Abständen. Wenn nach einer bestimmten Anzahl von Abfragen (in der Regel nach einer) eine Nachricht fehlt, nimmt der SQL Remote-Nachrichtenagent an, dass er sie verloren hat und verlangt, dass die Nachricht nochmals gesendet wird. In langsamen Nachrichtensystemen kann dieses Verhalten zu vielen unnötigen Neusendeanforderungen führen. Sie können mit dieser Option festlegen, wie oft abgerufen wird, bevor eine Neusendeanforderung erfolgt, um die Anzahl der Neusendeanforderungen zu minimieren.

Weitere Hinweise zur Konfiguration dieser Option finden Sie unter Performance beim Nachrichtenempfang verbessern.

Die Befehlszeilenoption -rp wird oft in Verbindung mit der Option -rd verwendet, mit der die Abrufhäufigkeit für eintreffende Nachrichten eingestellt wird.

Gibt die Warteperiode zum neuerlichen Durchsuchen des Logs bei Empfang einer Neusendeanforderung an.

Steuert den resend urgency-Parameter. Diese Angabe legt die Periode zwischen der Erkennung einer Neusendeanforderung und der Verarbeitung dieser Neusendeanforderung durch den SQL Remote-Nachrichtenagenten fest. Benutzen Sie diesen Parameter, um den SQL Remote-Nachrichtenagenten zu unterstützen, Neusendeanforderungen von vielen Benutzern abzuwickeln, bevor das Log nochmals durchsucht wird. Die Zeiteinheit kann s (Sekunden); m (Minuten); h (Stunden) oder d (Tage) sein.

Steuert die Verzögerung zwischen Abrufen des Datenbank-Transaktionslogs. Die Befehlszeilenoption -sd wird nur bei Ausführung im kontinuierlichen Modus verwendet.

Steuert den Parameter send delay, der angibt, wie lange zwischen Abrufen abgewartet wird, um die aus dem Transaktionslog entnommene Datenmenge zu vergrößern.

Repliziert alle Trigger. Wenn Sie die Option verwenden, müssen Sie sicherstellen, dass die Triggeraktionen in den entfernten Datenbanken nicht zweimal ausgeführt werden, nämlich einmal vom Trigger, der am entfernten Computer ausgelöst wird, und das andere Mal von der expliziten Anwendung der replizierten Aktionen aus der konsolidierten Datenbank.

Um sicherzustellen, dass Triggeraktionen nicht zweimal ausgeführt werden, können Sie die Trigger mit der Anweisung IF CURRENT REMOTE USER IS NULL ... END IF umschließen. Weitere Hinweise hierzu finden Sie unter Den CURRENT REMOTE USER-Spezialwert verwenden.

Verarbeitet nur Transaktionen, die in Offline-Transaktionslogs vorhanden sind. Die Option verhindert, dass der SQL Remote-Nachrichtenagent Transaktionen nach der letzten Sicherung verarbeitet. Wenn Sie diese Option verwenden, werden ausgehende Transaktionen und die Bestätigung von eintreffenden Transaktionen erst versendet, wenn sie in Offline-Transaktionslogs vorhanden sind.

Das bedeutet, dass nur Transaktionen von umbenannten Logs bearbeitet werden.

Führt den SQL Remote-Nachrichtenagenten als Daemon auf Unix-Plattformen aus. Wenn Sie den SQL Remote-Nachrichtenagenten als Daemon ausführen, müssen Sie auch die Befehlszeilenoption -o oder -ot benutzen, um die Ausgabeinformationen zu protokollieren.

Wenn Sie den SQL Remote-Nachrichtenagenten als Daemon ausführen und FTP- oder SMTP-Nachrichtenverbindungen verwenden, müssen Sie die Nachrichtenverbindungsparameter in der Datenbank speichern, weil der SQL Remote-Nachrichtenagent den Benutzer nicht zur Eingabe dieser Optionen auffordert, wenn er als Daemon läuft.

Hinweise zu Nachrichtenverbindungsparametern finden Sie unter Steuerungsparameter für den entfernten Nachrichtentyp festlegen.

Starten Sie den SQL Remote-Nachrichtenagenten als Daemon, werden seine Berechtigungen durch die unmask-Einstellung des aktuellen Benutzers gesteuert. Es wird empfohlen, den umask-Wert vor dem Start des SQL Remote-Nachrichtenagenten festzulegen, um sicherzustellen, dass er die entsprechenden Berechtigungen hat.

Öffnet das SQL Remote-Meldungsfenster unter Solaris und Linux.

Wenn -ux angegeben ist, muss dbremote in der Lage sein, eine verwendbare Anzeige zu finden. Wenn keine gefunden wird, weil z.B. die DISPLAY-Umgebungsvariable nicht eingestellt ist oder der X Window-Server nicht läuft, schlägt der Start von dbremote fehl. Unter Windows erscheint das SQL Remote-Meldungsfenster automatisch.

Legt die Anzahl der Datenbank-Worker-Threads zur Übernahme eintreffender Nachrichten fest. Diese Option wird unter Windows Mobile nicht unterstützt.

Der Standardwert ist Null, was heißt, dass alle Nachrichten durch den (einzigen) Haupt-Thread übernommen werden. Ein Wert von 1 (eins) legt fest, dass ein Thread die Nachrichten vom Nachrichtensystem empfängt, und ein zweiter die Nachrichten in die Datenbank übernimmt. Die maximale Anzahl von Datenbank-Worker-Threads ist 50.

Die Option -w ermöglicht eine Erhöhung des Durchsatzes von eintreffenden Nachrichten mit Hardware-Upgrades. Wenn Sie die konsolidierte Datenbank auf ein Gerät legen, das viele gleichzeitige Vorgänge durchführen kann (eine RAID-Anordnung mit einem logischen Laufwerk im Striped-Modus), kann das den Durchsatz von eintreffenden Nachrichten erhöhen. Mehrere Prozessoren auf dem Computer, auf dem der SQL Remote-Nachrichtenagent läuft, können ebenfalls den Durchsatz von eintreffenden Nachrichten erhöhen.

Die Option -w erhöht die Performance auf einer Hardware, die nicht mehrere Vorgänge gleichzeitig ausführen kann, nicht merklich.

Eintreffende Meldungen von einer einzigen entfernten Datenbank werden nie mit mehreren Threads angewendet. Meldungen von einer einzigen entfernten Datenbank werden stets seriell in der richtigen Reihenfolge angewendet.

Benennt das Transaktionslog um und startet es neu, nachdem es nach neuen ausgehenden Meldungen durchsucht wurde. Unter gewissen Umständen kann die Replikation von Daten in eine konsolidierte Datenbank die Sicherung entfernter Datenbanken oder das Umbenennen des Transaktionslogs bei heruntergefahrenem Datenbankserver ersetzen.

Wenn der optionale Qualifizierer Größe angegeben wird, erfolgt die Umbenennung des Transaktionslogs nur bei Überschreitung der genannten Größe. Die zulässige Größe kann als n (in Byte), nK oder nM angegeben werden. Der Standardwert ist 0.

Gibt das Verzeichnis an, in dem alte Transaktionslogs gespeichert werden.

Der optionale Verzeichnis-Parameter bestimmt ein Verzeichnis, in dem alte Transaktionslogs aufbewahrt werden, damit der SQL Remote-Nachrichtenagent Zugriff auf Ereignisse hat, die vor dem Start des aktuellen Logs stattgefunden haben.