Befehlszeilenoptionen für den Rational DOORS-Client

Sie können Befehlszeilenoptionen beim Starten des Rational DOORS-Clients zum Überschreiben der Registry-Einstellungen verwenden.

Eine Liste der Befehlszeilenoptionen für Rational DOORS-Datenbankserver finden Sie unter Befehlszeilenoptionen für den Datenbankserver.

Tabelle 1. Befehlszeilenoptionen für Rational DOORS-Client
Option (Kurzform) Parameter Beschreibung
-addins (-a) Add-in-Ordner Ein Pfad oder mehrere Pfade zu den Ordnern, die Ihre DXL-Add-in-Dateien enthalten.

Trennen Sie Ihre Einträge mit Semikola (;), ohne Leerzeichen nach den Semikola. Bei den Pfaden kann es sich um lokale Pfade, herkömmliche Laufwerkzuordnungen oder UNC-Pfade (Universal Naming Convention) handeln.

-attributeaddins (-A) DXL-Attribute-Ordner Ein Pfad oder mehrere Pfade zu den Ordnern, die die für die DXL-Attribute verwendbaren Programme enthalten.

Trennen Sie Ihre Einträge mit Semikola (;), ohne Leerzeichen nach den Semikola. Bei den Pfaden kann es sich um lokale Pfade, herkömmliche Laufwerkzuordnungen oder UNC-Pfade (Universal Naming Convention) handeln.

-batch (-b) DXL-Programm Führt Rational DOORS im Stapelmodus aus. Rational DOORS startet ohne grafische Benutzerschnittstelle (die Anmeldeanzeige und der Datenbankexplorer werden unterdrückt), führt das angegebene DXL-Programm aus und wird dann gestoppt.

Im Stapelmodus benötigen Sie normalerweise andere Optionen, z. B. -user, -password und -project, um sich anzumelden und das aktuelle Projekt anzugeben.

Der Parameter der Option -batch gibt die Datei an, die das im Stapelmodus auszuführende DXL-Programm enthält.

Beispiel:
C:\> doors -b dxl_programs\batch_analysis.dxl -p Car -u "Jill" 
-caching (-k)   Aktiviert das Streaming für die Datenübertragung zwischen Datenbankserver und Client. Diese Option kann die Geschwindigkeit der Datenübertragung über ein WAN steigern.
Vorsicht:
Während die Daten geladen werden, werden sie auf dem Clientsystem im Bereich localdata gespeichert. Dies ist jedoch möglicherweise ein Sicherheitsrisiko. Die Daten werden gelöscht, wenn der Ladevorgang abgeschlossen ist.
-certName Kartenname:Zertifikat Gibt die Bezeichnung des Zertifikats an, das zur Identifizierung des Clients während der sicheren Authentifizierung verwendet wird

Wenn Sie den Standard pkcs#11 verwenden, wird Kartenname von-pkcs11token identifiziert und Zertifikat ist der Name des Zertifikats, das von Ihrem System verwendet wird. Beispiel: "Crescendo C700:certOne".

-cli (-C) DXL-Zeichenfolge oder "#include <DXL-Programm> DXL-Code, der beim Start von Rational DOORS vor der Anzeige der Begrüßungsanzeige ausgeführt wird. Der Parameter ist einer der folgenden:
  • ein DXL-Codefragment
  • eine Include-Hash-Anweisung, die den Pfad zu einem DXL-Programm angibt
-data (-d) Port@server Gibt an, welche Rational DOORS-Datenbank verwendet werden soll.

Der Parameter gibt den Port an, den der Server verwendet, und den Namen des Server-Computers (z. B. 36677@meinServer).

-defopenmode (-o) Eine der folgenden Zeichenfolgen

READ_ONLY

READ_WRITE

READ_WRITE_SHARED

Stellt den Standardbearbeitungsmodus ein, in dem formale Module geöffnet werden, wenn Sie im Datenbankexplorer auf sie doppelklicken.

Der Parameter für den exklusiven Bearbeitungsmodus ist READ_WRITE, der für den gemeinsamen Bearbeitungsmodus ist READ_WRITE_SHARED.

Anmerkung: Dieser Parameter muss in Großbuchstaben geschrieben werden, sofern Sie nicht die Einzelbuchstabenkurzformen (r, w und s) verwenden.
-defopenlinkmode (-O) Eine der folgenden Zeichenfolgen:

READ_ONLY

READ_WRITE

READ_WRITE_SHARED

Legt den Bearbeitungsmodus fest, in dem formale Module geöffnet werden, wenn Sie einem Link folgen

Der Parameter für den exklusiven Bearbeitungsmodus ist READ_WRITE, der für den gemeinsamen Bearbeitungsmodus ist READ_WRITE_SHARED.

Anmerkung: Dieser Parameter muss in Großbuchstaben geschrieben werden, sofern Sie nicht die Einzelbuchstabenkurzformen (r, w und s) verwenden.
-dxl (-D) DXL-Zeichenfolge oder "#include <DXL-Programm>" DXL-Code, der sofort nach dem Start von Rational DOORS ausgeführt wird. Der Parameter ist einer der folgenden:
  • ein DXL-Codefragment
  • eine Include-Hash-Anweisung, die den Pfad zu einem DXL-Programm angibt
-home (-H) DOORS-Ausgangsverzeichnis Das Rational DOORS-Ausgangsverzeichnis, einschließlich des vollständigen Pfads zu dem Ordner, in den Rational DOORS installiert ist.
-certdb Ordnername Gibt den Ordner an, der die Schlüsseldatenbankdatei enthält, die wiederum die Rational Directory Server-Schlüssel und Rational DOORS-SSL-Schlüssel enthält.

Der Standardwert lautet DOORS\9.version\certdb\.

Wenn Sie die Schlüsseldatenbankdatei für Rational DOORS SSL in einen separaten Ordner platzieren möchten, verwenden Sie die Option -keyDB. Die Option -keyDB hat Vorrang vor -certdb.

-keyDB Dateiname Der vollständige Pfad zur Schlüsseldatenbankdatei, die die Schlüssel für die Verwendung für die Rational DOORS-SSL-Authentifizierung und -Validierung enthält, einschließlich des Dateinamens.

Der Standardwert lautet DOORS\9.version\certdb\client_authentication.kdb.

Diese Option hat Vorrang vor -certdb. Sie können eine Speicherposition für den Schlüsseldatenbankordner von Rational Directory Server mit -certdb und eine weitere Speicherposition für die Rational DOORS-SSL-Schlüsseldatenbankdatei mit -keyDB festlegen.

-layoutaddins (-L) Layout-DXL-Ordner Ein Pfad oder mehrere Pfade zu Layout-DXL-Ordnern.

Trennen Sie Ihre Einträge mit Semikola (;), ohne Leerzeichen nach den Semikola. Bei den Pfaden kann es sich um lokale Pfade, herkömmliche Laufwerkzuordnungen oder UNC-Pfade (Universal Naming Convention) handeln.

-localdata (-f) Ordnername Ein Ordner auf dem lokalen Computer, der als temporärer Speicher für Daten verwendet wird, die vom Rational DOORS-Datenbankserver kopiert werden.
-logxconfig (-X) vollständiger_dateiname Der vollständige Name der Konfigurationsdatei log4cxx, z. B. C:\Logs\Client\logging-config-client.xml. Log4cxx ist ein Framework für die Protokollierung von Anwendungsnachrichten.
Wenn Sie diesen Parameter in der Befehlszeile oder in der Registry verwenden, zeichnet der Client die Anwendungsnachrichten in der angegebenen Konfigurationsdatei auf. Die Nachrichten werden auf sechs Ebenen protokolliert.
  • TRACE
  • DEBUG
  • INFO, einschließlich ACK, CONFIRM und QUERY
  • WARNING
  • ERROR
  • FATAL
-notriggers (-T)   Inaktiviert Auslöser. Sie müssen entweder Datenbankmanager oder benutzerdefinierter Benutzer mit der Berechtigung zum Verwalten der Datenbank sein, um Auslöser zu inaktivieren.
-password (-P) Kennwort Das Kennwort für die Sitzung.
-pkcs11driver Treiber Wenn Sie den Standard pkcs#11 verwenden, identifiziert diese Option den Namen des Treibers für den Kartenleser, z. B. c:\windows\system32\aetpkssw.dll.

Verwenden Sie diese Option, wenn Sie Chipkarten verwenden, die auf der PKI-Authentifizierung (PKI - Public Key Infrastructure) basieren, um sich bei Rational DOORS anzumelden.

-pkcs11token Kartenname Wenn Sie den Standard pkcs#11 verwenden, identifiziert diese Option den Typ der verwendeten Chipkarte, z. B. "Crescendo C700".
-project (-p) Projektname Der Name des Projekts, das zu Beginn der Sitzung geöffnet werden soll. Der Inhalt des Projekts wird im rechten Fensterbereich des Datenbankexplorers angezeigt.

Bei Verwendung der Option -batch gibt der Parameter das aktuelle Projekt an.

-projectaddins (-J) Projekt-Add-in-Ordner Ein Pfad oder mehrere Pfade zu Verzeichnissen mit DXL-Add-ins für Projekte.

Trennen Sie Einträge mit Semikola (;), ohne Leerzeichen nach den Semikola. Bei den Pfaden kann es sich um lokale Pfade, herkömmliche Laufwerkzuordnungen oder UNC-Pfade (Universal Naming Convention) handeln.

-user (-u) Benutzername Der Benutzername des Benutzers für die Sitzung
-W nowait Wenn Sie einen Stapelprozess ausführen und Fehler oder Druckausgaben auftreten, werden diese an ein Befehlsfenster gesendet. Rational DOORS wird weiterhin ausgeführt, bis das Befehlsfenster geschlossen wird.

Wenn Sie beim Ausführen eines Stapelprozesses in der Befehlszeile den Parameter -W verwenden, werden alle Befehlsfenster automatisch geschlossen und Rational DOORS gestoppt.

In dieser Tabelle werden die Befehlszeilenoptionen aufgelistet, die Sie beim Ausführen des Rational DOORS-Clients als Interoperationsserver verwenden:
Tabelle 2. Befehlszeilenoptionen für den Interoperationsserver
Option (Kurzform) Parameter Beschreibung
-brokerHost DWAbroker Diese Option gibt den Rational DOORS Web Access-Broker an, wobei DWAbroker der Hostname des Computers ist, auf dem der Rational DOORS Web Access-Server ausgeführt wird.
-brokerPort Port Diese Option gibt die Portnummer an, an der der Rational DOORS Web Access-Broker ausgeführt wird. Der Standardport ist 61616.
-data (-d) Port@server Gibt an, welche Rational DOORS-Datenbank verwendet werden soll.

Der Parameter gibt den Port an, den der Server verwendet, und den Namen des Server-Computers (z. B. 36677@meinServer).

-interop   Diese Option führt den Rational DOORS-Client als Interoperationsserver aus.
-logfile (-l) vollständiger_dateiname Der vollständige Name der Protokolldatei für den Interoperationsserver, beispielsweise C:\temp\interop.log.

Wenn Sie diesen Parameter in der Befehlszeile verwenden, protokolliert das System alle dokumentierten DXL-Fehler in einer Datei und zeigt sie nicht auf dem Bildschirm an.

Wenn Sie diesen Parameter in der Registry verwenden, werden die im Windows-Ereignisprotokoll aufgezeichneten Informationen vom System übernommen und sowohl in der Protokolldatei als auch im Anwendungsprotokoll aufgezeichnet. Dort ist für diese Einträge DOORS_DB_SERVER im Feld Source angegeben.

Verwenden Sie den Parameter zusammen mit der Angabe -logLevel.

-logLevel ganzzahl Der Umfang an Informationen, die in die Protokolldatei aufgenommen werden sollen.

Verwenden Sie den Parameter zusammen mit der Angabe -logfile.

-maxMemory ganzzahl Die maximale Speichermenge, die der Ausführung des Interoperationsservers zugeordnet ist.

Feedback