ITCAM for SOA 7.2 Fix Pack 1

AddFltrCntrl_610「採取動作」指令

說明
AddFltrCntrl_610「採取動作」指令用於定義準則,透過拒絕經由資料收集器流至服務作業的訊息,來控制服務的啟動與停止。唯一可用的過濾控制是拒絕

您可以根據特定服務埠名稱 (也稱為「Web 服務說明語言 (Web Services Description Language) (WSDL)」埠名稱) 及作業名稱的特定呼叫方主機名稱或 IP 位址,來拒絕訊息。每則訊息都是根據您所指定的過濾準則來進行評估,如果訊息符合過濾準則,則會拒絕該訊息,且不允許它通過資料收集器。當拒絕訊息時,會將項目寫入監視動作日誌檔。

服務管理代理程式」工作區的「資料收集器過濾控制配置」表格視圖中會顯示此過濾準則。表格中的每一列都代表一個唯一的過濾準則定義。如需此表格直欄的相關資訊,請參閱 資料收集器過濾控制_610 屬性

重要: 在部分攔截點上無法使用訊息的 IP 位址或主機名稱。在這些情況下,如果在過濾準則中指出特定的主機名稱或 IP 位址,則根據那些準則將不會拒絕訊息,並會允許訊息通過資料收集器。然而,如果使用星號 (*) 萬用字元值來配置主機名稱及 IP 位址,則會拒絕來自所有主機名稱或 IP 位址的訊息。

您可以將過濾準則指定為主機名稱或 IP 位址,以及服務埠名稱、服務埠名稱空間、作業名稱或作業名稱空間的某種組合。這其中的每個欄位都必須指定完整值,或指定符合該準則所有值的星號 (*) 萬用字元值。部分表示式是無效。例如,您可以將作業名稱指定為 lookupCustomer,但不可以是 lookup*。值不會根據現有的服務埠名稱或作業名稱進行驗證。

您可以定義過濾準則的多種組合,以套用至特定的應用程式伺服器執行時期環境。多個過濾準則會按照最不明確到較明確的特定順序進行評估。

表 1 列出有效的過濾準則組合範例。任何其他未列在此表格中的可能組合都是無效的,且會以回覆碼 2 拒絕。

表 1. 按照最不明確到較明確之順序的過濾準則組合。
遠端 IP 位址或主機名稱 服務埠名稱空間 服務埠 作業名稱空間 作業 優先順序
* * * * * 14- 此準則最不明確,會最先進行評估
* * XYZ * * 13
* * XYZ * XYZ 12
* * XYZ XYZ XYZ 11
* XYZ XYZ * * 10
* XYZ XYZ * XYZ 9
* XYZ XYZ XYZ XYZ 8
IP/Hostname * * * * 7
IP/Hostname * XYZ * * 6
IP/Hostname * XYZ * XYZ 5
IP/Hostname * XYZ XYZ XYZ 4
IP/Hostname XYZ XYZ * * 3
IP/Hostname XYZ XYZ * XYZ 2
IP/Hostname XYZ XYZ XYZ XYZ 1

表 1 中,XYZ 代表服務埠名稱、服務埠名稱空間、作業名稱或作業名稱空間的實例。IP/Hostname 代表特定的 IP 位址或主機名稱。若要指定多個用戶端 IP 位址,請針對每個要過濾的特定 IP 位址,定義新的過濾準則。您無法指定子網路。

「過濾控制索引」直欄所顯示的值是用來唯一識別每個應用程式伺服器及應用程式伺服器執行時期環境之組合內的每個過濾控制。

如果指定的是主機名稱而不是 IP 位址,則會在過濾準則中轉換為其相等的 IP 位址。主機名稱也會新增至準則,且過濾準則會依照指定的內容與收到的訊息相比對。例如,如果您指定主機名稱為 mycomputer.domain.com,則送入訊息必須包含完全相同的字串或相對應的 IP 位址。如果您指定的是 IP 位址,則相對應的主機名稱也會新增至內部過濾準則。

重要: 在您定義過濾控制並將其新增至表格之後,便無法再對其進行編輯。您必須使用 DelFltrCntrl_610 來刪除過濾準則,然後再次使用 AddFltrCntrl_610 來新增定義。
傳送動作
若要傳送 AddFltrCntrl_610「採取動作」指令,請完成下列步驟:
  1. Tivoli Enterprise Portal 目前工作區的其中一個視圖,用滑鼠右鍵按一下並選取長條圖中的條列或表格視圖中的橫列。選取採取動作 -> 選取,以顯示「採取動作」視窗。
  2. 如果要顯示可用的動作清單,請在「動作」之下,按一下名稱欄位。這時會顯示一份可用動作的清單。
  3. 在此清單中,按一下 AddFltrCntrl_610
  4. 「採取動作」視窗的指令欄位的一部分會填入指令語法,且會顯示「編輯引數值」視窗讓您輸入過濾準則。直欄中的欄位會預先填寫「服務資產管理_610」屬性表格或「資料收集器過濾控制_610」屬性表格的資料。輸入您要針對每個引數過濾的值。若要符合該引數的所有訊息,請使用星號 (*) 萬用字元值。
  5. 輸入值之後,按一下確定。即會關閉「編輯引數值」視窗,並且回到「採取動作」視窗,而輸入的過濾準則現在已包含在指令欄位中。
  6. 目的地系統欄位包含一個以上您可以在其中傳送指令的目標系統。按一下想要的系統名稱,然後按一下確定
  7. 即會顯示含有結果回覆碼的「動作狀態」視窗。若要關閉視窗,請按一下確定。「採取動作」視窗也會關閉。
  8. 如果您順利接收到回覆碼,請重新整理「 服務管理代理程式」工作區的顯示畫面,即可看見「資料收集器過濾控制配置」表格視圖中已將新的過濾準則併入成為新的一列。

定義過濾控制之後,即會拒絕符合過濾準則的後續訊息。

引數
表 2 說明可以指定給此「採取動作」指令的引數。
表 2. AddFltrCntrl_610「採取動作」指令的引數。
名稱

Application_ServerName_U

應用程式伺服器的名稱 (例如,WebSphere® 環境的 server1)

Application_ServerEnv

應用程式伺服器環境。有效值為:

  • WebSphereApplication Server
  • .NET
  • WebLogic Server
  • JBoss
  • CICS®
  • SAP
  • WebSphereCommunity Edition

Local_Hostname_U

本端主機名稱。完整主機名稱或星號 (*) 萬用字元值。

Port_Namespace_U

服務埠名稱空間 (也稱為「Web 服務說明語言 (Web Services Description Language)」埠名稱空間)。視過濾準則組合表格中所說明的限制而定,這可以是完整的服務埠名稱空間或星號 (*) 萬用字元值。

Service_Name_U

服務埠名稱 (也稱為「Web 服務說明語言 (Web Services Description Language)」埠名稱)。視過濾準則組合表格中所說明的限制而定,這可以是完整的服務埠名稱或星號 (*) 萬用字元值。

Operation_Namespace_U

與指定服務相關聯的作業名稱空間。視過濾準則組合表格中所說明的限制而定,這可以是完整的作業名稱空間或星號 (*) 萬用字元值。

Operation_Name_U

與指定服務相關聯的作業名稱。視過濾準則組合表格中所說明的限制而定,這可以是完整的作業名稱或星號 (*) 萬用字元值。

RemoteIPAddress

遠端 IP 位址。此欄位也可以是主機名稱,它會在稍後轉換為其相等的 IP 位址。視過濾準則組合表格中所說明的限制而定,這可以是完整的 IP 位址或主機名稱,或星號 (*) 萬用字元值。您無法指定子網路。

回覆碼
當您執行「採取動作」指令時,會接收到下列其中一個回覆碼:
  • 0 = 動作已順利完成,且過濾控制已新增至過濾控制表格。
  • 1 = 未對過濾準則進行任何變更。
  • 2 = 未順利完成動作。您的過濾準則可能有錯誤。過濾準則未新增至過濾控制表格。


意見回饋