使用「安裝程式」將連接器檔案安裝至您的系統後,您必須設定標準的及應用程式特有的連接器配置內容。
連接器有兩種配置內容類型: 標準配置內容和連接器特有配置內容。 在執行連接器之前,您必須使用「系統管理程式 (SM)」來設定這些內容的值。
標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的相關文件。
下表提供附錄中有關此連接器配置內容的特有資訊。
內容 | 說明 |
---|---|
CharacterEncoding |
此連接器不使用此內容。
|
Locale |
由於此連接器尚未國際化,所以您無法變更此內容的值。
請參照連接器的版本注意事項,判斷目前所支援的語言環境。
|
因為此連接器僅支援 InterChange Server (ICS) 作為整合分配管理系統, 所以與其相關的配置內容僅有 ICS 的配置內容。
您至少必須設定下列標準連接器配置內容:
連接器特有的配置內容提供連接器代理程式於執行時期所需的資訊。 連接器特有內容亦提供一種方法,可直接變更連接器代理程式中的靜態資訊或邏輯, 不需重新編碼和重新建置代理程式。
表 37 列出連接器特有的配置內容。 請參閱後續幾節的內容說明。 請注意,有些內容包含了其他內容。 + 字元指出輸入項目在內容階層中的位置。
名稱 | 可能值 | 預設值 | 必要的 |
---|---|---|---|
ConnectorType | 任何有效的連接器類型 | WebService | 是 |
DataHandlerMetaObjectName | 資料處理常式 Meta 物件名稱 | MO_DataHandler_ Default | 是 |
JavaProtocolHandlerPackages | 有效的 Java 通訊協定處理常式套件 | com.ibm.net.ssl. internal.www.protocol | 否 |
ProtocolHandlerFramework | 此為階層式內容,沒有值 | 無 | 否 |
+ProtocolHandlers | 此為階層式內容,沒有值 |
| 否 |
++SOAPHTTPHTTPSHandler | 此為階層式內容。如需其子內容的相關資訊, 請參閱SOAPHTTPHTTPSHandler。 |
| 是 |
++SOAPJMSHandler | 此為階層式內容。如需其子內容的相關資訊, 請參閱SOAPJMSHandler。 |
|
|
ProtocolListenerFramework | 此為階層式內容,沒有值。 |
| 否 |
+WorkerThreadCount | 大於 1 的整數,指示可用的接聽器執行緒數量。 | 10 | 否 |
+RequestPoolSize | 大於 WorkerThreadCount 的整數,指示資源儲存池的大小。 | 20 | 否 |
+ProtocolListeners | 此為階層式內容,沒有值 |
|
|
++Listener1 | 具有唯一名稱的通訊協定接聽器 |
| 是 |
+++Protocol | soap/http, soap/https, soap/jms |
| 是 |
+++SOAPDHMimeType | SOAP 資料處理常式的任何有效 MIME 類型 | xml/soap |
|
+++ListenerSpecific | 接聽器專屬或必要的內容請參閱ListenerSpecific。 |
|
|
ProxyServer | 此為階層式內容,沒有值 |
| 否 |
+HttpProxyHost | HTTP Proxy 伺服器的主機名稱 |
| 否 |
+HttpProxyPort | HTTP Proxy 伺服器的埠號 | 80 | 否 |
+HttpNonProxyHosts | 需要直接連線的 HTTP 主機 |
| 否 |
+HttpsProxyHost | HTTPS Proxy 伺服器的主機名稱 |
| 否 |
+HttpsProxyPort | HTTPS Proxy 伺服器的埠號 | 443 | 否 |
+HttpsNonProxyHosts | 需要直接連線的 HTTPS 主機 |
| 否 |
+SocksProxyHost | Socks Proxy 伺服器名稱 |
| 否 |
+SocksProxyPort | Socks Proxy 伺服器埠 |
| 否 |
+HttpProxyUsername | Http Proxy 伺服器使用者名稱 |
| 否 |
+HttpProxyPassword | Http Proxy 伺服器密碼 |
| 否 |
+HttpsProxyUsername | Https Proxy 伺服器使用者名稱 |
| 否 |
+HttpsProxyPassword | Https Proxy 伺服器密碼 |
| 否 |
SSL | 此為階層式內容,沒有值 |
| 否 |
+SSLVersion | SSL, SSLv2, SSLv3, TLS, TLSv1 | SSL | 否 |
+SSLDebug | true, false | false | 否 |
+KeyStoreType | 任何有效的金鑰儲存庫類型 | JKS | 否 |
+KeyStore | KeyStore 檔案的路徑。 |
| 否 |
+KeyStorePassword | KeyStore 中的私密金鑰密碼 |
| 否 |
+KeyStoreAlias | KeyStore 中的金鑰組別名 |
| 否 |
+TrustStore | TrustStore 檔案的路徑 |
| 否 |
+TrustStorePassword | TrustStore 的密碼 |
| 否 |
+UseClientAuth | true false | false | 否 |
WSCollaborations | 此為「WSDL 配置精靈」建立的階層式內容,沒有值。 請參閱WSCollaborations。 |
|
|
+Collaboration1 | 此為階層式內容,沒有值 |
|
|
++CollaborationPort1 | 協同作業埠的名稱 |
| 是 |
+++WebServiceOperation1 | 此為階層式內容,沒有值 |
| 是 |
++++BodyName | Web 服務方法的名稱;必須是有效的 XML 元素名稱 |
| 是 |
++++BodyNS | Web 服務方法的名稱空間;必須是有效的 XML 名稱空間 |
| 是 |
++++BOName | 用於作業的「要求」商業物件名稱 |
| 是 |
++++Mode | synch asynch | asynch | 否 |
JNDI | 此為與 JMS 相關的階層式內容,沒有值 |
| 否 |
+LookupQueuesUsingJNDI | true false | false | 否 |
+JNDIProviderURL | 有效的 JNDI URL |
| 否 |
+InitialContextFactory | 起始環境定義的 Factory 類別名稱 |
| 否 |
+JNDIConnectionFactoryName | 使用 JNDI 環境定義來查閱的 Connection Factory 名稱。 |
| 否 |
+CTX_ObjectFactories
| 內容指定有關 JNDI 環境定義中安全性及物件查閱的其他資訊 |
| 否 |
若此內容設定為 WebService,則於連結協同作業埠時, 「系統管理程式」會將連接器顯示為 Web 服務連接器。 否則會顯示為正常的連接器。
預設值 = WebService。
此為 Meta 物件的名稱,資料處理常式使用此名稱來設定配置內容。
預設值 = MO_DataHandler_Default。
這個內容的值提供「Java 通訊協定處理常式」套件。 連接器使用此內容的值來設定系統內容 java.protocol.handler.pkgs。
預設值 = com.ibm.net.ssl.internal.www.protocol。
「通訊協定處理常式組織架構」使用此內容來載入及配置其通訊協定處理常式。 此為階層式內容,沒有值。
預設值 = 無。
此階層式內容沒有值。 其第一層的子項代表分離的通訊協定處理常式。
預設值 = 無。
SOAP/HTTP-HTTPS 通訊協定處理常式的名稱。請注意,此為階層式內容。 通訊協定處理常式與接聽器不同,通訊協定處理常式不可複製,且每個通訊協定只能有一個處理常式。 下面的表 38 顯示 SOAP/HTTP-HTTPS 通訊協定處理常式的子內容。 + 字元指出輸入項目在內容階層中的位置。
表 38. SOAP/HTTP-HTTPS 通訊協定處理常式配置內容
名稱 | 可能值 | 預設值 | 必要的 |
---|---|---|---|
++SOAPHTTPHTTPSHandler | 此為階層式內容,沒有值。 |
| 是 |
+++Protocol | 處理常式所實行的通訊協定類型。 若為 SOAP/HTTP 及 SOAP/HTTPS,此值為
soap/http。
|
| 是 |
+++HTTPReadTimeout | SOAP/HTTP 特有的內容,它可指定從遠端主機 (Web 服務) 讀取時的逾時間隔 (毫秒)。若未指定這個內容,或是將它設定為 0,則從遠端主機讀取時, 通訊協定處理常式將會無限期地暫停執行。 | 0 | 否 |
圖 32 顯示如「連接器配置程式」中所顯示的內容。
圖 32. SOAP/HTTP-HTTPS 通訊協定處理常式內容
SOAP/JMS 通訊協定處理常式的名稱。請注意,此為階層式內容。 通訊協定處理常式與接聽器不同,通訊協定處理常式不可複製,且每個通訊協定只能有一個處理常式。 下面的 表 39 顯示 SOAP/JMS 通訊協定處理常式的子內容。 + 字元指出輸入項目在內容階層中的位置。
名稱 | 可能值 | 預設值 | 必要的 |
---|---|---|---|
++SOAPJMSHandler | 此為階層式內容,沒有值。 |
| 是 |
+++Protocol | 處理常式所實行的通訊協定類型。 若為 SOAP/JMS,則該值為
soap/jms。
|
| 是 |
+++ResponseWaitTimeout | 這是 JMS 通訊協定特定處理常式的內容, 其指定通訊協定處理常式在 ReplyToQueue 上等待同步要求處理程序的逾時值 (毫秒)。 若回應未於此期限內到達,處理常式將使協同作業要求失效。 若未指定這個內容,或其設定為 0,通訊協定處理常式將在 ReplyToQueue 上一直等待。 | 0 | 否 |
+++ReplyToQueue | 此為必要的 JMS 通訊協定特定處理常式內容,用以為 ReplyTo 佇列命名。
若為同步要求處理程序,處理常式會將 JMSReplyTo 欄位設為這個 JMS 目的地。
如果 LookupQueuesUsingJNDI = true,SOAP/JMS 通訊協定處理常式就會使用 JNDI 來查閱此佇列。 | 無 | 是 |
圖 33 顯示如「連接器配置程式」中所顯示的內容。
通訊協定接聽器組織架構使用這個內容來載入通訊協定接聽器。此為階層式內容,沒有值。
這個內容必須是大於 1 的整數,建立可用於通訊協定接聽器組織架構的通訊協定接聽器工作程式執行緒數量。 如需進一步資訊,請參閱通訊協定接聽器。預設值 = 10。
這個內容必須是大於 WorkerThreadCount 的整數,設定通訊協定接聽器組織架構的資源儲存池大小。 組織架構可同時處理的要求上限為 WorkerThreadCount + RequestPoolSize。
預設值 = 20。
此為階層式內容,沒有值。這個內容的每個第一層子項代表分離的通訊協定接聽器。
通訊協定接聽器的名稱。可能會有多重通訊協定接聽器。 請注意,此為階層式內容。 您可建立這個內容的多重實例,並建立額外的、具有唯一名稱的接聽器。 執行時,您可變更特定接聽器的內容,但不能變更通訊協定內容。 多重接聽器的名稱必須是唯一的。可能的名稱 (非值):SOAPHTTPListener1、SOAPHTTPSListener1、SOAPJMSListener1
這個內容指定此接聽器所要實行的通訊協定。可能的值:soap/http、soap/https、soap/jms。
SOAP 資料處理常式 MIME 類型,用於此接聽器所接收的要求。
預設值 = xml/soap
特定的接聽器內容,對所指定的通訊協定接聽器來說是唯一的,或是必要的。
例如,HTTP
接聽器具有特定接聽器的內容--「埠」,其代表「接聽器」用來監視要求的「埠號」。 表 40 彙總 HTTP-HTTPS 接聽器特定的內容。 +
字元指出輸入項目在內容階層中的位置。
表 40. SOAP/HTTP 及 SOAP/HTTPS 通訊協定特定接聽器的配置內容
名稱 | 可能值 | 預設值 | 必要的 |
---|---|---|---|
+++SOAPHTTPListener1 | HTTP 通訊協定接聽器的專屬名稱。 這是 ProtocolListenerFramework -> ProtocolListeners 階層式內容的子項。 可以有多重接聽器:您可以另外建立此內容的實例及其階層,以外掛其他 HTTP 接聽器。 |
| 是 |
++++Protocol | soap/http (若為 SOAP/HTTP 通訊協定接聽器)
soap/https (若為 SOAP/HTTPS 通訊協定接聽器)
|
| 是 |
++++SOAPDHMimeType | xml/soap | xml/soap | 否 |
++++BOPrefix | 這個內容的值會傳遞至資料處理常式。 |
| 否 |
++++Host | 接聽器將於這個內容值所指定的 IP 位址上接聽。 若未指定 Host ,其預設為 localhost。 請注意,您可以指定主機名稱 (DNS 名稱),亦可指定接聽器執行所在之機器的 IP 位址。 一台機器可以有多重 IP 位址或多重名稱。 | localhost | 否 |
++++Port | 接聽器用來接聽要求的埠。 如果未指定,若為 SOAP/HTTP,埠預設值為80,若為 SOAP/HTTPS,則為443。如果您在連接器中複製接聽器,則 Host 和 Port 內容的組合必須是唯一的,否則接聽器就無法連結至該埠來接受要求。 | 80 (若為 SOAP/HTTP 接聽器)
443 (若為 SOAP/HTTPS 接聽器) | 否 |
++++SocketQueueLength | 送入之連線要求的佇列 (socket 佇列) 長度。 指定主機在一次儲存多少送入的連線之後,即拒絕連線。佇列長度的上限需視作業系統而定。 | 5 | 否 |
++++RequestWaitTimeout | 接聽器執行緒在等待 Web 服務要求到達時, 在主機或埠上暫停執行的時間 (毫秒)。 如果它在此期限內收到 Web 服務要求,接聽器將處理之。否則接聽器執行緒會檢查是否設定了連接器關閉旗標。 如果已設定,連接器將終止。否則將依照 RequestWaitTimeout 的期限,繼續暫停執行。 如果這個內容設定為 0,其將永遠暫停執行。若未指定,其預設為 60000ms。 | 60000 (ms) | 否 |
++++HTTPReadTimeout | 在從用戶端讀取 Web 服務要求時,將暫停執行接聽器的時間 (毫秒)。 若此參數設定為 0,接聽器就會無限期地暫停執行,直到它收到整個要求訊息。 | 0 | 否 |
++++HttpAsyncResponseCode | 對接聽器提出非同步要求時的 HTTP 回應程式碼:
200 (OK) 202 (ACCEPTED) | 202 (ACCEPTED) | 否 |
++++URLsConfiguration | 此為階層式內容,沒有值。 其包含一或數個此接聽器所支援的 URL 配置,亦可能會有 MIME 類型及 charset 值 (選用性)。 請注意,此為 ProtocolListenerFramework->ProtocolListeners-> SOAPHTTPListener1 階層式內容的子內容。 若未指定這個內容,接聽器會採用預設值。 | ContextPath:/ 已啟用:true 資料處理常式 MimeType:等於要求的 ContentType Charset:NONE。如需進一步資訊,請參閱SOAP/HTTP 及 SOAP/HTTPS 通訊協定接聽器處理程序。 | 否 |
+++++URL1 | 此為階層式內容,沒有值。其子項提供此接聽器所支援的 URL 名稱。 可有多重受支援的 URL。 請注意,您可以複製這個內容及其階層,以插入額外的 URL。 |
| 否 |
++++++ContextPath | 接聽器所接收之 HTTP 要求的 URI。在 URLsConfiguration 內容的 ContextPath 值中,此值必須是唯一的。否則連接器將記載錯誤,且無法啟動。 ContextPath 需區分大小寫;然而其可包含通訊協定、主機名稱及埠,不區分大小寫。 若於 ContextPath 中指定通訊協定,則應為 http。若指定了主機,則應與 Host 接聽器內容的值相同。 若已指定埠,則應與 Port 接聽器內容的值相同。 |
| 否 |
++++++Enabled | 這個內容的值可決定是否要為連接器啟用母項 URL 階層式內容。 | True | 否 |
++++++TransformationRules | 此為階層式內容,沒有值。它可保留一或多個轉換規則。 |
|
|
+++++++TransformationRule1 | 此為階層式內容,沒有值。它可保留轉換規則。 |
| 否 |
++++++++ContentType | 這個內容的值對應套用特殊處理方式 (資料處理常式 MIME 類型或 charset)
的送入要求,指定 ContentType。 若 TransformationRuleN
階層式內容未指定 ContentType, 連接器會記載警告訊息,並忽略
TransformationRuleN 內容。
|
| 否 |
++++++++MimeType | 當呼叫資料處理常式以處理所指定之 ContentType 的要求時, 所使用的 MIME 類型。 |
| 否 |
++++++++Charset | 當所指定之 ContentType 的要求轉換成商業物件時, 所要使用的 Charset。 |
| 否 |
圖 34 顯示如「連接器配置程式」中所顯示的內容。
表 41 彙總 SOAP/JMS 通訊協定特定接聽器的內容。 +
字元指出輸入項目在內容階層中的位置。
名稱 | 可能值 | 預設值 | 必要的 |
---|---|---|---|
+++SOAPJMSListener1 | JMS 通訊協定接聽器的專屬名稱。 這是 ProtocolListenerFramework -> ProtocolListeners 階層式內容的子項。 可以有多重接聽器:您可以另外建立此內容的實例及其階層,以外掛其他 JMS 接聽器。 |
| 是 |
++++Protocol | soap/jms |
| 是 |
++++SOAPDHMimeType | xml/soap | xml/soap | 否 |
++++BOPrefix | 這個內容的值會傳遞至 SOAPDHMimeType 內容所指定的資料處理常式。 |
| 否 |
++++RequestWaitTimeout | 這個內容設定 SOAP/JMS 接聽器執行緒於等待 Web 服務要求時, 暫停執行 InputQueue 的時間長度。 如果它於此期限內收到 Web 服務要求,接聽器將處理之。若於此期間內未收到要求, 接聽器執行緒會先檢查是否設定了連接器關閉旗標。 若設定了連接器關閉旗標,連接器將終止。否則將依照 RequestWaitTimeout 的期限,繼續暫停執行。 如果這個內容設定為 0,將無限期地暫停執行。 | 60000
毫秒 | 否 |
++++SessionPoolSize | 可配置給指定接聽器及其工作程式執行緒的階段作業數上限。 階段作業數下限 (及預設值) 為 2。對於較大的階段作業儲存池,連接器會需要較多的記憶體。 | 2 | 否 |
++++InputQueue | 這個內容可指定接聽器在輪詢來自 Web 服務的入埠訊息時,所要登記的輸入佇列名稱。 如果 LookupQueuesUsingJNDI = true,接聽器會使用 JNDI 來查閱此佇列, 並將 InputQueue 內容的值設定為 SOAP/JMS 連結之 jms:address 元素的 jndiDestinationName 屬性。 jms:address 元素指定於 WSDL 文件的 wsdl:port 區段中。 如果您於產生 WSDL 期間選取 SOAP/JMS 接聽器,「系統管理程式」會自動使用這個內容的 值來建立 jndiDestinationName 屬性。 如果 LookupQueueUsingJNDI = false,則「系統管理程式」會 建立 jmsProviderDestinationName 屬性。 |
| 是 |
++++InProgressQueue | 這個內容提供進行中佇列的名稱。 接聽器會將入埠訊息的複本由 InputQueue 傳送到 InProgressQueue。 如果 LookupQueuesUsingJNDI = true,接聽器使用 JNDI 來查閱此佇列。 |
| 是 |
++++ArchiveQueue | 這個內容提供保存佇列的名稱。接聽器將處理成功的 訊息複本由 InProgressQueue 傳送到 ArchiveQueue。 如果 LookupQueuesUsingJNDI = true,接聽器使用 JNDI 來查閱此佇列。 |
| 否 |
++++UnsubscribedQueue | 這個內容提供未訂閱之佇列的名稱。 接聽器將未訂閱之訊息的複本由 InProgressQueue 傳送到 UnsubscribedQueue。 如果 LookupQueueUsingJNDI = true,接聽器使用 JNDI 來查閱此佇列。 |
| 否 |
++++ErrorQueue | 這個內容提供錯誤佇列的名稱。接聽器將失敗訊息的複本傳送到 ErrorQueue。 如果 LookupQueueUsingJNDI = true,接聽器使用 JNDI 來查閱此佇列。 |
| 否 |
++++InDoubtEvents | 這個內容指定如何處理於 InProgressQueue
中,因連接器意外終止而尚未完全處理好的訊息。 其可採用下列其中一個值:
| Ignore | 否 |
++++ReplyToQueue | 這個內容提供 ReplyTo 佇列的名稱。 「WSDL 配置精靈」讀取這個內容,並將它寫入 WSDL 文件。 若未指定這個內容,公用程式便不會於 WSDL 文件的 SOAP/JMS 連結中建立 ReplyTo JMS 標頭。 (接聽器不使用這個內容。) 若指定了 JNDI 內容,且 LookupQueueUsingJNDI = false, 「WSDL 產生公用程式」仍會於 WSDL 文件中建立 JNDI 特定屬性。 請注意,這些 JNDI 特定屬性是必要的,因為 SOAP/JMS 連結並未提供任何方法, 可在沒有 JNDI 的情況下,指定 ReplyTo 屬性。 雖然不需要 InputQueue 的 JNDI 查閱作業,但 ReplyTo 佇列必須要有特定 JNDI 內容。 若 WSDL 公用程式未找到特定 JNDI 內容,公用程式便無法於 SOAP/JMS 連結中建立 ReplyTo 屬性。 |
|
|
++++ JMSVendorURI | 特別用來識別 JMS 實作方式的字串,其對應於 SOAP/JMS 連結之 jms:address 元素的 jmsVendorURI 屬性。 jms:address 元素指定於 WSDL 文件的 wsdl:port 區段中。接聽器不使用這個內容。 |
| 否 |
圖 35 顯示如「連接器配置程式」中所顯示的內容。
當網路使用 Proxy 伺服器時,於這個內容之下配置這些值。 此為階層式內容,沒有值。SOAP/HTTP/HTTPS 通訊協定處理常式將使用指定於這個內容下的值。
圖 36 顯示如「連接器配置程式」所顯示及下面所討論的 ProxyServer 內容。
HTTP Proxy 伺服器的主機名稱。若網路為 HTTP 通訊協定使用 Proxy 伺服器,請指定這個內容。
預設值 = 無
連接器用來連接 HTTP Proxy 伺服器的埠號。
預設值 = 80
這個內容的值提供一或數個主機 (適用於 HTTP),這些主機必須是直接連線,而非透過 Proxy 伺服器。 該值可為一個主機清單,用 "|" 將每個主機隔開。
預設值 = 無
HTTPS Proxy 伺服器的主機名稱。
預設值 = 無
連接器用來連接 HTTPS Proxy 伺服器的埠號。
預設值 = 443
這個內容的值提供一或數個主機 (適用於 HTTPS),這些主機必須是直接連線,而非透過 Proxy 伺服器。 該值可為一個主機清單,用 "|" 將每個主機隔開。
預設值 = 無
Socks Proxy 伺服器的主機名稱。當網路使用 Socks Proxy 時,請指定這個內容。
預設值 = 無
用來連接 Socks Proxy 伺服器的埠號。當網路使用 Socks Proxy 時,請指定這個內容。
預設值 = 無
HTTP Proxy 伺服器的使用者名稱。若 Web 服務要求的目的地為 HTTP URL,且您指定了 ProxyServer ->HttpProxyUsername,當使用 Proxy 鑑別時,SOAP HTTP/HTTPS 通訊協定 處理常式會建立 Proxy-Authorization 標頭。 處理常式使用 CONNECT 方法來進行鑑別。
proxy-authentication 標頭是以 base64 來編碼的,其結構如下:
Proxy-Authorization: Basic
Base64EncodedString
處理常式連結使用者名稱及密碼內容值 (以冒號 (:) 隔開),以建立 base64 編碼的字串。
預設值 = 無
HTTP Proxy 伺服器的密碼。如需此值用法的相關資訊, 請參閱HttpProxyUsername。
預設值 = 無
HTTPS Proxy 伺服器的使用者名稱。如果 Web 服務要求的目的地為 HTTPS URL, 且您指定了 ProxyServer ->HttpsProxyUsername,SOAP HTTP/HTTPS 通訊協定 處理常式會建立 Proxy-Authorization 標頭,以 Proxy 鑑別。 處理常式連結 HttpsProxyUsername 及 HttpsProxyPassword 配置內容值 (以冒號 (:) 隔開), 建立 base64 編碼的字串。
預設值 = 無
HTTPS Proxy 伺服器的密碼。如需此值用法的相關資訊, 請參閱HttpsProxyUsername。
預設值 = 無
指定這個內容下的值,為連接器配置 SSL。此為階層式內容,沒有值。
圖 37 顯示如「連接器配置程式」所顯示及下面所討論的 SSL 內容。
連接器所使用的 SSL 版本。如需進一步資訊,請參閱 IBM JSSE 文件,查詢受支援的 SSL 版本。
預設值 = SSL
若這個內容的值設定為 true,連接器就會將 javax.net.debug 系統 內容的值設定為 true。 IBM JSSE 使用這個內容來開啟追蹤機能。 如需進一步資訊,請參閱 IBM JSSE 文件。
預設值 = false
這個內容的值提供 KeyStore 及 TrustStore 的類型。 如需進一步資訊,請參閱 IBM JSSE 文件,查詢有效的金鑰儲存庫類型。
預設值 = JKS
這個內容提供金鑰儲存庫的完整路徑。 若未指定 KeyStore 及/或 KeyStoreAlias 內容,就會忽略 KeyStorePassword、KeyStoreAlias 、TrustStore、TrustStorePassword 內容。 若連接器無法使用這個內容中所指定的路徑來載入金鑰儲存庫,即無法啟動。 該路徑必須是金鑰儲存庫檔的完整路徑。
預設值 = 無
這個內容提供 Keystore 中之私密金鑰的密碼。
預設值 = 無
這個內容提供 KeyStore 中之金鑰組的別名。 SOAP/HTTPS 接聽器使用 KeyStore 中的這個私密金鑰。 此外,SOAP/HTTP-HTTPS 通訊協定處理常式於呼叫需要用戶端鑑別的 Web 服務時, 會使用 KeyStore 中的這個別名。 該內容必須設為有效的 JSSE 別名。
預設值 = 無
這個內容提供 TrustStore 的完整路徑。 TrustStore 可用來儲存連接器所信任的憑證。 TrustStore 的類型必須與 KeyStore 相同。 您必須指定 TrustStore 檔案的完整路徑。
預設值 = 無
這個內容提供 Truststore 的密碼。
預設值 = 無
這個內容指定是否要使用 SSL 用戶端鑑別功能。若設定為 true, SOAP/HTTPS 接聽器使用用戶端鑑別功能。
預設值 = false
當您將協同作業物件顯現為 Web 服務,並用於非 TLO 時,便會自動建立這個內容。 此為階層式內容,沒有值。這個內容的每個第一層子項代表顯現為 Web 服務的協同作業。 如需用來自動建立這些內容之工具的資訊,請參閱將協同作業顯現為 Web 服務。
圖 38 顯示如「連接器配置程式」所顯示及下面所討論的 WSCollaborations 內容。
這個內容會透過此連接器為顯現成 Web 服務的協同作業物件命名。 此為階層式內容,沒有值。這樣的內容可以有好幾個,每個顯現為 Web 服務的 協同作業物件各一個內容。 這個內容的每個第一層子項代表此協同作業物件的埠。
這個內容是要為協同作業埠命名。此為階層式內容,沒有值。這樣的內容可以有好幾個,在此協同作業中,每個連結到連接器的埠各一個內容。 這個內容的每個第一層子項代表 Web 服務作業。
這個內容代表協同作業物件的 Web 服務作業。此為階層式內容,沒有值。可有一或數個這樣的內容,針對在產生 WSDL 文件時,使用者所定義的每個 Web 服務作業, 各設定一個內容。
這個內容提供 Web 服務方法的名稱,且必須是有效的 XML 元素名稱。
預設值 = 無
這個內容提供 Web 服務方法的名稱空間,且必須是有效的 XML 名稱空間。
預設值 = 無
這個內容提供此作業的「要求」商業物件名稱。
預設值 = 無
這個內容指定作業的處理模式。若設定為 synch,連接器便會同步呼叫協同作業。 否則,依預設,連接器會以非同步的方式,將協同作業當作只有要求的作業來呼叫。
預設值 = asynch
連接器維護了一組 JNDI (Java 命名和目錄介面) 提供者內容, 當 SOAP/JMS 通訊協定處理常式及 JMS 通訊協定接聽器要連接至 JNDI 時,會使用這些內容。 此為階層式內容,沒有值。連接器使用 JNDI 來查閱 JMS Connection Factory 物件。 請注意,「WSDL 配置精靈」在產生 SOAP/JMS 連結時,會使用這個內容。
圖 39 顯示如「連接器配置程式」所顯示及下面所討論的 JNDI 內容。
若這個內容的值設定為 true,連接器的 SOAP/JMS 接聽器及 SOAP/JMS 通訊 協定處理常式將會使用 JNDI 來查閱佇列。
預設值 = false
這個內容提供 JNDI 服務提供者的 URL,其對應於 SOAP/JMS 連結之 jms:address 元素的 jndiProviderURL 屬性。 jms:address 元素指定於 wsdl:port 區段中。其用來作為預設的 JNDI 提供者, 且必須是有效的 JNDI URL。 如需進一步資訊,請參閱 JNDI 規格。
預設值 = 無
這個內容提供 Factory 類別的完整類別名稱 (例如,com.ibm.NamingFactory), 以建立起始環境定義。 請注意,此對應於 SOAP/JMS 連結之 jms:address 元素的 initialContextFactory 屬性。 jms:address 元素指定於 wsdl:port 區段中。
預設值 = 無
這個內容提供 Connection Factory 的名稱,使用 JNDI 環境定義來查閱。 請注意,此對應於 SOAP/JMS 連結之 jms:address 元素的 jndiConnectionFactoryName 屬性。 jms:address 元素指定於 wsdl:port 區段中。
預設值 = 無
內容指定有關 JNDI 環境定義中安全性及物件查閱的其他資訊。表 42 彙總這些內容。 + 字元指出輸入項目在內容階層中的位置。
表 42. 「Java 命名和目錄介面 (JNDI)」提供者內容
內容名稱 | 說明 |
+CTX_StateFactories
+CTX_URLPackagePrefixes +CTX_DNS_URL +CTX_Authoritative +CTX_Batchsize +CTX_Referral +CTX_SecurityProtocol +CTX_SecutiryAuthentication +CTX_SecurityPrincipal +CTX_SecurityCredentials +CTX_Language | 內容指定有關 JNDI 環境定義中安全性及物件查閱的其他資訊。如需詳細資訊,請參閱 J2EE 文件。 這些內容反映了「配接器」用於 JMS 的那些內容。 |
您可建立多重通訊協定接聽器的實例。 通訊協定接聽器被配置為 ProtocolListenerFramework -> ProtocolListeners 連接器內容的子內容。(ProtocolListenerFramework -> ProtocolListeners 的) 每項子內容皆可為連接器識別 不同的通訊協定接聽器。因此,您可於 ProtocolListeners 內容之下配置新的子內容,以建立其他通訊協定接聽器。 請確定您為新建立的接聽器內容,指定所有的子內容。每個接聽器的名稱皆必須是唯一的。 然而,請勿變更接聽器通訊協定內容 (soap/http、soap/https 或 soap/jms),對於接聽器的多重實例,這些內容仍維持原狀。
如果您要建立 SOAP/HTTP 或 SOAP/HTTPS 接聽器的多重實例, 請務必要為每個實例指定不同的「埠」及「主機」內容。 若您正指定多個 SOAP/JMS 接聽器,請務必為每個實例使用不同的佇列組合。