Rational DOORS 用戶端的指令行切換參數

您可以利用指令行切換參數,在 Rational® DOORS® 用戶端啟動時置換登錄設定。

如需 Rational DOORS 資料庫伺服器的指令行切換參數清單,請參閱資料庫伺服器的指令行切換參數

表 1. Rational DOORS 用戶端的指令行切換參數
切換參數(縮寫) 參數 說明
-addins (-a) addins_folders 一或多個含有您的 DXL 附加程式檔案的資料夾路徑。

請利用分號 (;) 來區隔項目,分號後面沒有空格。 路徑可能是本端路徑、慣用磁碟機對映,或 UNC(一般命名慣例)路徑。

-attributeaddins (-A) dxl_attributes_folders 一或多個含有 DXL 屬性所能使用之程式的資料夾路徑。

請利用分號 (;) 來區隔項目,分號後面沒有空格。 路徑可能是本端路徑、慣用磁碟機對映,或 UNC(一般命名慣例)路徑。

-batch (-b) dxl_program 以批次模式來執行 Rational DOORS。 Rational DOORS 會在沒有 GUI(它會暫停登入畫面和資料庫瀏覽器)的情況下啟動、執行指定的 DXL 程式,然後停止。

在批次模式中,您通常需要 -user-password-project 之類的其他切換參數,才能登入及指定現行專案。

-batch 切換參數的參數所指定的檔案,其中會包含要以批次模式執行的 DXL 程式。

例如:
C:\> doors -b dxl_programs\batch_analysis.dxl -p Car -u "Jill" 
-caching (-k)   啟用資料庫伺服器和用戶端之間的資料傳送串流。 這個選項可以增進透過 WAN 來進行的資料傳送效能。
注意:
資料在載入時會快取至用戶端機器中的 localdata 區域,這有可能會引起安全風險。 載入完成之後,就會清除資料。
-certName card_name:cert 識別安全鑑別期間用來識別用戶端的憑證標籤。

如果您是使用 pkcs#11 標準,則會使用 -pkcs11token 來識別 card_name,而 cert 是系統所使用的憑證名稱。 例如:"Crescendo C700:certOne"

-cli (-C) dxl_string 或 "#include <dxl_program> 這是在 Rational DOORS 啟動時,在顯示啟動畫面之前所執行的 DXL 程式碼。 這個參數是下列項目之一:
  • DXL 程式碼片段
  • 指定 DXL 程式路徑的雜湊 include 陳述式
-data (-d) port@server 指定要使用的 Rational DOORS 資料庫。

此參數指定伺服器正在使用的埠,以及伺服器電腦的名稱(例如 36677@myserver)。

-defopenmode (-o) 下列其中一項

READ_ONLY

READ_WRITE

READ_WRITE_SHARED

設定您在資料庫瀏覽器中,按兩下正式模組時會開啟模組的編輯模式。

參數為 READ_WRITE 時代表獨佔編輯模式;參數為 READ_WRITE_SHARED 時代表可共用的編輯模式。

註: 除非您使用單一字母縮寫(rws),否則,這個參數必須是大寫字母。
-defopenlinkmode (-O) 下列其中一項:

READ_ONLY

READ_WRITE

READ_WRITE_SHARED

設定點選鏈結之後,用來開啟正式模組的編輯模式。

參數為 READ_WRITE 時代表獨佔編輯模式;參數為 READ_WRITE_SHARED 時代表可共用的編輯模式。

註: 除非您使用單一字母縮寫(rws),否則,這個參數必須是大寫字母。
-dxl (-D) dxl_string 或 "#include <dxl_program>" 這是在 Rational DOORS 啟動之後,緊接著執行的 DXL。 這個參數是下列項目之一:
  • DXL 程式碼片段
  • 指定 DXL 程式路徑的雜湊 include 陳述式
-home (-H) doors_home 這是 Rational DOORS 起始目錄,其中包括安裝 Rational DOORS 之資料夾的完整路徑。
-certdb folder_name 識別包含金鑰資料庫檔案的資料夾,檔案中包含 Rational Directory Server 和 Rational DOORS SSL 的金鑰。

預設值為 DOORS\9.5\certdb\

如果您要將 Rational DOORS SSL 的金鑰資料庫檔案放在個別的資料夾,請使用 -keyDB 切換參數。-keyDB 切換參數的優先順序高於 -certdb

-keyDB filename 包含檔名在內的金鑰資料庫檔案的完整路徑,檔案中包含用於 Rational DOORS SSL 鑑別和驗證的金鑰。

預設值為 DOORS\9.5\certdb\client_authentication.kdb

這個切換參數的優先順序高於 -certdb。您可以使用 -certdb 來指定 Rational Directory Server 金鑰資料庫資料夾的位置,和使用 -keyDB 另外指定 Rational DOORS SSL 金鑰資料庫檔案的位置。

-layoutaddins (-L) layout_dxl_folders 一或多個佈置 DXL 資料夾的路徑。

請利用分號 (;) 來區隔項目,分號後面沒有空格。 路徑可能是本端路徑、慣用磁碟機對映,或 UNC(一般命名慣例)路徑。

-localdata (-f) folder_name 這是本端電腦中的一個資料夾,用來暫時儲存從 Rational DOORS 資料庫伺服器複製而來的資料。
-logxconfig (-X) full_file_name log4cxx 配置檔的完整名稱,例如 C:\Logs\Client\logging-config-client.xmlLog4cxx 是 記錄應用程式訊息的架構。
當您在指令行或登錄中使用此參數時,用戶端會在指定的配置檔中記錄應用程式訊息。 6 個層次的訊息會被記錄下來。
  • TRACE
  • DEBUG
  • INFO,包含 ACK、CONFIRM 與 QUERY
  • WARNING
  • ERROR
  • FATAL
-notriggers (-T)   關閉觸發程式。 您必須是資料庫管理員,或是有權管理資料庫的自訂使用者,才能關閉觸發程式
-password (-P) password 階段作業的密碼。
-pkcs11driver driver 如果您使用 pkcs#11 標準,這個切換參數可識別讀卡機驅動程式的名稱,例如 c:\windows\system32\aetpkssw.dll

當您是使用以公開金鑰基礎架構 (PKI) 鑑別為基礎的智慧卡來登入 Rational DOORS 時,就可以使用這個切換參數。

-pkcs11token card_name 如果您使用 pkcs#11 標準,這個切換參數可識別系統使用的智慧卡類型,例如 "Crescendo C700"
-project (-p) project_name 在階段作業啟動時,您想要開啟的專案名稱。 專案的內容會顯示在資料庫瀏覽器的右窗格中。

如果您使用 -batch 切換參數,參數會指定現行專案。

-projectaddins (-J) project_addins_ folders 一或多個專案 DXL 附加程式目錄路徑。

請利用分號 (;) 來區隔清單中的項目,分號後面沒有空格。 路徑可能是本端路徑、慣用磁碟機對映,或 UNC(一般命名慣例)路徑。

-user (-u) username 階段作業使用者的使用者名稱。
-W nowait 當您執行批次程序,且出現任何錯誤或列印輸出時,它們都會傳送至指令視窗。 Rational DOORS 會繼續執行,直到指令視窗關閉為止。

當執行批次程序時,在指令行中使用 -W ,會自動關閉任何指令視窗,並停止 Rational DOORS。

這個表格列出當您將 Rational DOORS 用戶端當成 Interoperation 伺服器來執行時,所使用的指令行切換參數:
表 2. Interoperation 伺服器的指令行切換參數
切換參數(縮寫) 參數 說明
-brokerHost DWAbroker 這個切換參數用來識別 Rational DOORS Web Access 分配管理系統, 其中 DWAbroker 是執行 Rational DOORS Web Access 伺服器之電腦的主機名稱。
-brokerPort port 這個切換參數用來識別執行 Rational DOORS Web Access 分配管理系統的埠號。預設埠是 61616
-data (-d) port@server 指定要使用的 Rational DOORS 資料庫。

此參數指定伺服器正在使用的埠,以及伺服器電腦的名稱(例如 36677@myserver)。

-interop   這個切換參數會將 Rational DOORS 用戶端當成 Interoperation 伺服器來執行。
-logfile (-l) full_file_name Interoperation 伺服器的日誌檔完整名稱,例如 C:\temp\interop.log

當您在指令行中使用這個參數時, 系統會將所報告的任何 DXL 錯誤記錄在檔案中,而不是將錯誤顯示在畫面上。

當您在登錄中使用此參數時,系統會取得記錄在 Windows 事件日誌及應用程式日誌中的資訊, 其中的記錄在來源欄位中會出現 DOORS_DB_SERVER

使用此參數搭配 -logLevel

-logLevel integer 包含於日誌檔的資訊量。

使用此參數搭配 -logfile

-maxMemory integer 配置用來執行 Interoperation 伺服器的記憶體量上限。

意見