配置連接器

使用「安裝程式」將連接器檔案安裝至您的系統後,您必須設定標準的及應用程式特有的連接器配置內容。

設定配置內容

連接器有兩種配置內容類型: 標準配置內容和連接器特有配置內容。 在執行連接器之前,您必須使用「系統管理程式 (SM)」來設定這些內容的值。

標準配置內容

標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的相關文件。 下表提供附錄中有關此連接器配置內容的特有資訊。
內容 說明
CharacterEncoding

此連接器不使用此內容。

Locale

由於此連接器尚未國際化,所以您無法變更此內容的值。 請參照連接器的版本注意事項,判斷目前所支援的語言環境。

因為此連接器僅支援 InterChange Server (ICS) 作為整合分配管理系統, 所以與其相關的配置內容僅有 ICS 的配置內容。

您至少必須設定下列標準連接器配置內容:

連接器特有的配置內容

連接器特有的配置內容提供連接器代理程式於執行時期所需的資訊。 連接器特有內容亦提供一種方法,可直接變更連接器代理程式中的靜態資訊或邏輯, 不需重新編碼和重新建置代理程式。

表 37 列出連接器特有的配置內容。 請參閱後續幾節的內容說明。 請注意,有些內容包含了其他內容。 + 字元指出輸入項目在內容階層中的位置。

註:
若您不打算將 SOAP/JMS 通訊協定接聽器或 SOAP/JMS 通訊協定處理常式搭配連接器來使用, 請務必刪除與 SOAP/JMS 相關的連接器特有內容,或是將其留白。


表 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 內容


+CTX_properties

內容指定有關 JNDI 環境定義中安全性及物件查閱的其他資訊

ConnectorType

若此內容設定為 WebService,則於連結協同作業埠時, 「系統管理程式」會將連接器顯示為 Web 服務連接器。 否則會顯示為正常的連接器。

預設值 = WebService

DataHandlerMetaObjectName

此為 Meta 物件的名稱,資料處理常式使用此名稱來設定配置內容。

預設值 = MO_DataHandler_Default

JavaProtocolHandlerPackages

這個內容的值提供「Java 通訊協定處理常式」套件。 連接器使用此內容的值來設定系統內容 java.protocol.handler.pkgs。

預設值 = com.ibm.net.ssl.internal.www.protocol

ProtocolHandlerFramework

「通訊協定處理常式組織架構」使用此內容來載入及配置其通訊協定處理常式。 此為階層式內容,沒有值。

預設值 = 無。

ProtocolHandlers

此階層式內容沒有值。 其第一層的子項代表分離的通訊協定處理常式。

預設值 = 無。

SOAPHTTPHTTPSHandler

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 通訊協定處理常式內容


SOAPJMSHandler

SOAP/JMS 通訊協定處理常式的名稱。請注意,此為階層式內容。 通訊協定處理常式與接聽器不同,通訊協定處理常式不可複製,且每個通訊協定只能有一個處理常式。 下面的表 39 顯示 SOAP/JMS 通訊協定處理常式的子內容。 + 字元指出輸入項目在內容階層中的位置。


表 39. SOAP/JMS 通訊協定處理常式配置內容
名稱 可能值 預設值 必要的
++SOAPJMSHandler 此為階層式內容,沒有值。
+++Protocol 處理常式所實行的通訊協定類型。 若為 SOAP/JMS,則該值為 soap/jms
註:
若您未指定此內容的值,連接器將不會起始設定此通訊協定處理常式。

+++ResponseWaitTimeout 這是 JMS 通訊協定特定處理常式的內容, 其指定通訊協定處理常式在 ReplyToQueue 上等待同步要求處理程序的逾時值 (毫秒)。 若回應未於此期限內到達,處理常式將使協同作業要求失效。 若未指定這個內容,或其設定為 0,通訊協定處理常式將在 ReplyToQueue 上一直等待。 0
+++ReplyToQueue 此為必要的 JMS 通訊協定特定處理常式內容,用以為 ReplyTo 佇列命名。 若為同步要求處理程序,處理常式會將 JMSReplyTo 欄位設為這個 JMS 目的地。

如果 LookupQueuesUsingJNDI = trueSOAP/JMS 通訊協定處理常式就會使用 JNDI 來查閱此佇列

圖 33 顯示如「連接器配置程式」中所顯示的內容。

圖 33. SOAP/JMS 通訊協定處理常式內容


ProtocolListenerFramework

通訊協定接聽器組織架構使用這個內容來載入通訊協定接聽器。此為階層式內容,沒有值。

WorkerThreadCount

這個內容必須是不小於 1 的整數,建立可用於通訊協定接聽器組織架構的通訊協定接聽器工作程式執行緒數量。 如需進一步資訊,請參閱通訊協定接聽器。預設值 = 10

RequestPoolSize

這個內容必須是大於 WorkerThreadCount 的整數,設定通訊協定接聽器組織架構的資源儲存池大小。 組織架構可同時處理的要求上限為 WorkerThreadCount + RequestPoolSize。

預設值 = 20

ProtocolListeners

此為階層式內容,沒有值。這個內容的每個第一層子項代表分離的通訊協定接聽器。

Listener1

通訊協定接聽器的名稱。可能會有多重通訊協定接聽器。 請注意,此為階層式內容。 您可建立這個內容的多重實例,並建立額外的、具有唯一名稱的接聽器。 執行時,您可變更特定接聽器的內容,但不能變更通訊協定內容。 多重接聽器的名稱必須是唯一的。可能的名稱 (非值):SOAPHTTPListener1SOAPHTTPSListener1SOAPJMSListener1

Protocol

這個內容指定此接聽器所要實行的通訊協定。可能的值:soap/httpsoap/httpssoap/jms

註:
若您未指定這個內容的值,連接器將不會起始設定此通訊協定接聽器。

SOAPDHMimeType

SOAP 資料處理常式 MIME 類型,用於此接聽器所接收的要求。

預設值 = xml/soap

ListenerSpecific

特定的接聽器內容,對所指定的通訊協定接聽器來說是唯一的,或是必要的。 例如,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,其將永遠暫停執行。若未指定,其預設為 60000ms60000 (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 內容


為這個內容指定特殊的值
*/*, 可讓通訊協定接聽器將此規則套用於任何 ContentType。 請注意,如果接聽器發現針對共用 ContentType 之同一個環境定義路徑有多個規則, 接聽器會記載錯誤,且無法起始設定。


++++++++MimeType 當呼叫資料處理常式以處理所指定之 ContentType 的要求時, 所使用的 MIME 類型。
++++++++Charset 當所指定之 ContentType 的要求轉換成商業物件時, 所要使用的 Charset。

圖 34 顯示如「連接器配置程式」中所顯示的內容。

圖 34. SOAP/HTTP 通訊協定接聽器內容


表 41 彙總 SOAP/JMS 通訊協定特定接聽器的內容。 + 字元指出輸入項目在內容階層中的位置。


表 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 中,因連接器意外終止而尚未完全處理好的訊息。 其可採用下列其中一個值:
  • FailOnStartup 記載錯誤,並立即關閉
  • Reprocess 處理 InProgressQueue 中剩餘的訊息
  • Ignore 不處理進行中佇列中的任何訊息
  • LogError 記載錯誤,但不關閉
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 顯示如「連接器配置程式」中所顯示的內容。

圖 35. SOAP/JMS 通訊協定接聽器內容


註:
確定指定於下列內容中的佇列名稱都是唯一的:

ProxyServer

當網路使用 Proxy 伺服器時,於這個內容之下配置這些值。 此為階層式內容,沒有值。SOAP/HTTP/HTTPS 通訊協定處理常式將使用指定於這個內容下的值。

圖 36 顯示如「連接器配置程式」所顯示及下面所討論的 ProxyServer 內容。

圖 36. ProxyServer 內容


HttpProxyHost

HTTP Proxy 伺服器的主機名稱。若網路為 HTTP 通訊協定使用 Proxy 伺服器,請指定這個內容。

預設值 = 無

HttpProxyPort

連接器用來連接 HTTP Proxy 伺服器的埠號。

預設值 = 80

HttpNonProxyHosts

這個內容的值提供一或數個主機 (適用於 HTTP),這些主機必須是直接連線,而非透過 Proxy 伺服器。 該值可為一個主機清單,用 "|" 將每個主機隔開。

預設值 = 無

HttpsProxyHost

HTTPS Proxy 伺服器的主機名稱。

預設值 = 無

HttpsProxyPort

連接器用來連接 HTTPS Proxy 伺服器的埠號。

預設值 = 443

HttpsNonProxyHosts

這個內容的值提供一或數個主機 (適用於 HTTPS),這些主機必須是直接連線,而非透過 Proxy 伺服器。 該值可為一個主機清單,用 "|" 將每個主機隔開。

預設值 = 無

SocksProxyHost

Socks Proxy 伺服器的主機名稱。當網路使用 Socks Proxy 時,請指定這個內容。

註:
基礎 JDK 必須支援 socks。

預設值 = 無

SocksProxyPort

用來連接 Socks Proxy 伺服器的埠號。當網路使用 Socks Proxy 時,請指定這個內容。

預設值 = 無

HttpProxyUsername

HTTP Proxy 伺服器的使用者名稱。若 Web 服務要求的目的地為 HTTP URL,且您指定了 ProxyServer ->HttpProxyUsername,當使用 Proxy 鑑別時,SOAP HTTP/HTTPS 通訊協定 處理常式會建立 Proxy-Authorization 標頭。 處理常式使用 CONNECT 方法來進行鑑別。

proxy-authentication 標頭是以 base64 來編碼的,其結構如下:


Proxy-Authorization: Basic

Base64EncodedString

處理常式連結使用者名稱及密碼內容值 (以冒號 (:) 隔開),以建立 base64 編碼的字串。

預設值 = 無

HttpProxyPassword

HTTP Proxy 伺服器的密碼。如需此值用法的相關資訊, 請參閱HttpProxyUsername

預設值 = 無

HttpsProxyUsername

HTTPS Proxy 伺服器的使用者名稱。如果 Web 服務要求的目的地為 HTTPS URL, 且您指定了 ProxyServer ->HttpsProxyUsername,SOAP HTTP/HTTPS 通訊協定 處理常式會建立 Proxy-Authorization 標頭,以 Proxy 鑑別。 處理常式連結 HttpsProxyUsername 及 HttpsProxyPassword 配置內容值 (以冒號 (:) 隔開), 建立 base64 編碼的字串。

預設值 = 無

HttpsProxyPassword

HTTPS Proxy 伺服器的密碼。如需此值用法的相關資訊, 請參閱HttpsProxyUsername

預設值 = 無

SSL

指定這個內容下的值,為連接器配置 SSL。此為階層式內容,沒有值。

圖 37 顯示如「連接器配置程式」所顯示及下面所討論的 SSL 內容。

圖 37. SSL 內容


SSLVersion

連接器所使用的 SSL 版本。如需進一步資訊,請參閱 IBM JSSE 文件,查詢受支援的 SSL 版本。

預設值 = SSL

SSLDebug

若這個內容的值設定為 true,連接器就會將 javax.net.debug 系統 內容的值設定為 true。 IBM JSSE 使用這個內容來開啟追蹤機能。 如需進一步資訊,請參閱 IBM JSSE 文件。

預設值 = false

KeyStoreType

這個內容的值提供 KeyStore 及 TrustStore 的類型。 如需進一步資訊,請參閱 IBM JSSE 文件,查詢有效的金鑰儲存庫類型。

預設值 = JKS

KeyStore

這個內容提供金鑰儲存庫的完整路徑。 若未指定 KeyStore 及/或 KeyStoreAlias 內容,就會忽略 KeyStorePassword、KeyStoreAlias 、TrustStore、TrustStorePassword 內容。 若連接器無法使用這個內容中所指定的路徑來載入金鑰儲存庫,即無法啟動。 該路徑必須是金鑰儲存庫檔的完整路徑。

預設值 = 無

KeyStorePassword

這個內容提供 Keystore 中之私密金鑰的密碼。

預設值 = 無

KeyStoreAlias

這個內容提供 KeyStore 中之金鑰組的別名。 SOAP/HTTPS 接聽器使用 KeyStore 中的這個私密金鑰。 此外,SOAP/HTTP-HTTPS 通訊協定處理常式於呼叫需要用戶端鑑別的 Web 服務時, 會使用 KeyStore 中的這個別名。 該內容必須設為有效的 JSSE 別名。

預設值 = 無

TrustStore

這個內容提供 TrustStore 的完整路徑。 TrustStore 可用來儲存連接器所信任的憑證。 TrustStore 的類型必須與 KeyStore 相同。 您必須指定 TrustStore 檔案的完整路徑。

預設值 = 無

TrustStorePassword

這個內容提供 Truststore 的密碼。

預設值 = 無

UseClientAuth

這個內容指定是否要使用 SSL 用戶端鑑別功能。若設定為 true, SOAP/HTTPS 接聽器使用用戶端鑑別功能。

預設值 = false

WSCollaborations

當您將協同作業物件顯現為 Web 服務,並用於非 TLO 時,便會自動建立這個內容。 此為階層式內容,沒有值。這個內容的每個第一層子項代表顯現為 Web 服務的協同作業。 如需用來自動建立這些內容之工具的資訊,請參閱將協同作業顯現為 Web 服務

註:
若您於「系統管理程式」中刪除協同作業或其埠, 連接器並不會自動刪除代表該協同作業的內容。 您必須使用「連接器配置程式」來刪除這些內容。

圖 38 顯示如「連接器配置程式」所顯示及下面所討論的 WSCollaborations 內容。

圖 38. WSCollaborations 內容


Collaboration1

這個內容會透過此連接器為顯現成 Web 服務的協同作業物件命名。 此為階層式內容,沒有值。這樣的內容可以有好幾個,每個顯現為 Web 服務的 協同作業物件各一個內容。 這個內容的每個第一層子項代表此協同作業物件的埠。

CollaborationPort1

這個內容是要為協同作業埠命名。此為階層式內容,沒有值。這樣的內容可以有好幾個,在此協同作業中,每個連結到連接器的埠各一個內容。 這個內容的每個第一層子項代表 Web 服務作業。

WebServiceOperation1

這個內容代表協同作業物件的 Web 服務作業。此為階層式內容,沒有值。可有一或數個這樣的內容,針對在產生 WSDL 文件時,使用者所定義的每個 Web 服務作業, 各設定一個內容。

BodyName

這個內容提供 Web 服務方法的名稱,且必須是有效的 XML 元素名稱。

預設值 = 無

BodyNS

這個內容提供 Web 服務方法的名稱空間,且必須是有效的 XML 名稱空間。

預設值 = 無

BOName

這個內容提供此作業的「要求」商業物件名稱。

預設值 = 無

Mode

這個內容指定作業的處理模式。若設定為 synch,連接器便會同步呼叫協同作業。 否則,依預設,連接器會以非同步的方式,將協同作業當作只有要求的作業來呼叫。

預設值 = asynch

JNDI

連接器維護了一組 JNDI (Java 命名和目錄介面) 提供者內容, 當 SOAP/JMS 通訊協定處理常式及 JMS 通訊協定接聽器要連接至 JNDI 時,會使用這些內容。 此為階層式內容,沒有值。連接器使用 JNDI 來查閱 JMS Connection Factory 物件。 請注意,「WSDL 配置精靈」在產生 SOAP/JMS 連結時,會使用這個內容。

圖 39 顯示如「連接器配置程式」所顯示及下面所討論的 JNDI 內容。

圖 39. JNDI 內容


LookupQueuesUsingJNDI

若這個內容的值設定為 true,連接器的 SOAP/JMS 接聽器及 SOAP/JMS 通訊 協定處理常式將會使用 JNDI 來查閱佇列。

預設值 = false

JNDIProviderURL

這個內容提供 JNDI 服務提供者的 URL,其對應於 SOAP/JMS 連結之 jms:address 元素的 jndiProviderURL 屬性。 jms:address 元素指定於 wsdl:port 區段中。其用來作為預設的 JNDI 提供者, 且必須是有效的 JNDI URL。 如需進一步資訊,請參閱 JNDI 規格。

針對雙向語言的轉換,會啟用這個內容。

預設值 = 無

InitialContextFactory

這個內容提供 Factory 類別的完整類別名稱 (例如,com.ibm.NamingFactory), 以建立起始環境定義。 請注意,此對應於 SOAP/JMS 連結之 jms:address 元素的 initialContextFactory 屬性。 jms:address 元素指定於 wsdl:port 區段中。

預設值 = 無

JNDIConnectionFactoryName

這個內容提供 Connection Factory 的名稱,使用 JNDI 環境定義來查閱。 請注意,此對應於 SOAP/JMS 連結之 jms:address 元素的 jndiConnectionFactoryName 屬性。 jms:address 元素指定於 wsdl:port 區段中。

預設值 = 無

CTX 內容

內容指定有關 JNDI 環境定義中安全性及物件查閱的其他資訊。表 42 彙總這些內容。 + 字元指出輸入項目在內容階層中的位置。

針對雙向語言的轉換,會啟用 +CTX_DNS_URL 內容。


表 42. 「Java 命名和目錄介面 (JNDI)」提供者內容
內容名稱 說明
+CTX_ObjectFactories

+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/httpsoap/httpssoap/jms),對於接聽器的多重實例,這些內容仍維持原狀。

註:
「通訊協定」內容是非常重要的,因為其作為切換選項來使用。 若您不想使用接聽器或處理常式,則將這個內容留白。

如果您要建立 SOAP/HTTP 或 SOAP/HTTPS 接聽器的多重實例, 請務必要為每個實例指定不同的「埠」及「主機」內容。 若您正指定多個 SOAP/JMS 接聽器,請務必為每個實例使用不同的佇列組合。

您無法建立處理常式的多重實例。每個通訊協定只能有一個處理常式。

Copyright IBM Corp. 1997, 2004