[z/OS][AIX Solaris HP-UX Linux Windows]

workclassoperations.py Script

您可以使用 workclassoperations.py Script 來建立、更新及管理工作類別。

用途

您可以使用 workclassoperations.py Script 來完成下列動作:
  • 建立及更新企業應用程式和通用伺服器叢集的工作類別。
  • 列出工作類別中的規則。
  • 列出工作類別的成員。
  • 刪除各種原則及通訊協定的工作類別。
  • 設定預設動作。
  • 修改預設動作。
  • 提取預設動作。
  • 新增規則。
  • 刪除規則。
  • 刪除成員。

位置

workclassoperations.py Script 位於 app_server_root/bin 目錄中。

使用情形

一般說明的 Script 用法如下:
./wsadmin.sh -lang jython -f workclassoperations.py
作業特定說明的 Script 用法如下:
./wsadmin.sh -lang jython -f workclassoperations.py operation --help
視您發出指令的位置而定，您可能必須指定 workclassoperation.py Script 的路徑。 例如，您在 c:\app_server_root\profiles\Dmgr01\bin 目錄中建立名為 Dmgr01 的設定檔。
./wsadmin.sh -lang jython -f ../../../bin/workclassoperations.py
請注意，如果部署管理程式未啟動，您必須包含其他參數 -conntype NONE:
./wsadmin.sh -lang jython -conntype NONE workclassoperations.py

運疇

listWorkClasses
依類型列出工作類別。 清單的格式為 workclassname type appname/odrname deploymentname
  • --type: 指定要列出的工作類別類型:
    • ASP: 應用程式服務原則
    • ARP: 應用程式遞送原則
    • GSP: 通用伺服器服務原則
    • GRP: 通用伺服器遞送原則
  • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
  • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
createWorkClass
建立工作類別。 新的服務原則不包含任何應用程式模組或分類規則。 您必須個別建立及關聯應用程式模組與分類規則。
  • :
    • --type: 指定要列出的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --nodename: 指定節點的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
    • --protocol: 指定傳輸要求的通訊協定。 目前支援的通訊協定為 HTTP、IIOP、SOAP 及 JMS。
    • --wcaction: 指定當要求符合指定工作類別的成員時要採取的預設動作。
    • --module: 指定要關聯成員的應用程式模組。 如果您指定 --appname 和 --members 參數，則為必要。
    • --members: 指定特定通訊協定專用型樣:
      • HTTP: /test1?/test2/*
      • IIOP: ejbName:ejbMethod?ejbName:ejbMethod
      • SOAP: webService:operationName?webService:operationName
      • JMS: bus:destination?bus: destination
    • --rule: 以 "priority? rule?action" 格式指定分類規則
    • --virtualhost: 指定虛擬主機。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
  • removeWorkClass: 移除工作類別。
    • --type: 指定要移除的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
  • addMembers: 新增成員至工作類別。 ODR 會使用新成員來比對送入的要求。
    • --type: 指定要移除的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
    • --protocol: 指定傳輸要求的通訊協定。 目前支援的通訊協定為 HTTP、IIOP、SOAP 及 JMS。
    • --module: 指定要關聯成員的應用程式模組。 如果您指定 --appname 和 --members 參數，則為必要。
    • --members: 指定特定通訊協定專用型樣:
      • HTTP: /test1?/test2/*
      • IIOP: ejbName:ejbMethod?ejbName:ejbMethod
      • SOAP: webService:operationName?webService:operationName
      • JMS: bus:destination?bus: destination
    • --ejbname: 指定 EJB 的名稱。 僅當您將 --protocol 參數指定為 JMS ，並將 --module 參數指定為 IIOP時才需要。
  • removeMembers: 從工作類別移除成員。 ODR 不再使用該成員。
    • --type: 指定要修改的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
    • --protocol: 指定傳輸要求的通訊協定。 目前支援的通訊協定為 HTTP、IIOP、SOAP 及 JMS。
    • --module: 指定要解除成員關聯的應用程式模組。 如果您指定 --appname 和 --members 參數，則為必要。
    • --members: 指定特定通訊協定專用型樣:
      • HTTP: /test1?/test2/*
      • IIOP: ejbName:ejbMethod?ejbName:ejbMethod
      • SOAP: webService:operationName?webService:operationName
      • JMS: bus:destination?bus: destination
  • listMembers: 列出工作類別的成員。
    • --type: 指定要列出的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --nodename: 指定節點的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
    • --protocol: 指定傳輸要求的通訊協定。 目前支援的通訊協定為 HTTP、IIOP、SOAP 及 JMS。
  • addRules: 將 ODR 所使用的分類規則新增至工作類別。 如果您使用類似萬用字元 '%' on UNIX ® 作業系統來發出指令，請將 ESC 序列 (\ %%) 取代為 (\ %%)。
    • --type: 指定要修改的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --nodename: 指定節點的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
    • --rule: 以 "priority? rule?action" 格式指定分類規則
  • removeRule: 從工作類別中移除分類規則。 ODR 不再使用此規則。
    • --type: 指定要修改的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
    • --expression: 指定規則表示式。
    • --priority: 指定要符合之規則的優先順序。 優先順序最低的規則會先比對。
  • listRules: 列出分類規則。
    • --type: 指定要修改的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
  • modifyDefaultAction: 編輯工作類別的預設動作。
    • --type: 指定要修改的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
    • --wcaction: 指定當要求符合指定工作類別的成員時要採取的預設動作。
  • getDefaultAction: 指定工作類別的預設動作。
    • --type: 指定要列出的工作類別類型:
      • ASP: 應用程式服務原則
      • ARP: 應用程式遞送原則
      • GSP: 通用伺服器服務原則
      • GRP: 通用伺服器遞送原則
    • --appname: 指定應用程式的名稱。 如果您將 --type 參數指定為 ASP 或 ARP，則此為必要參數。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
  • modifyVirtualHost: 編輯工作類別的虛擬主機。
    • --type: 指定要修改的工作類別類型。 有效類型為 GSP 和 GRP。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。
    • --virtualhost: 指定虛擬主機。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
  • getVirtualHost: 列出工作類別的虛擬主機。
    • --type: 指定要列出的工作類別類型。 有效類型為 GSP 和 GRP。
    • --odrname: 指定隨需應變路由器 (ODR) 的名稱。 如果您將 --type 參數指定為 GSP 或 GRP，則此為必要參數。
    • --wcname: 指定指定類型內工作類別的唯一名稱。

範例

列出所有工作類別:
./wsadmin.sh -lang jython -f workclassoperations.py listWorkClasses
列出應用程式 Trade的所有工作類別:
./wsadmin.sh -lang jython -f workclassoperations.py listWorkClasses 
--appname Trade
建立應用程式 Trade 的 HTTP 應用程式遞送原則工作類別，預設動作為 reject ，拒絕碼為 404:
./wsadmin.sh -lang jython -f workclassoperations.py createWorkClass 
--type ARP --wcname CustomWorkClass --protocol HTTP --wcaction "reject?404" --appname Trade 
--module myModule.war --members "/test1?/test2"
列出應用程式 Trade的所有遞送原則工作類別:
./wsadmin.sh -lang jython -f workclassoperations.py listWorkClasses 
--type ARP --appname Trade
檢視應用程式 Trade的 HTTP 應用程式遞送原則工作類別的預設動作:
./wsadmin.sh -lang jython -f workclassoperations.py getDefaultAction 
--type ARP --wcname CustomWorkClass --appname Trade
在應用程式 Trade-edition1.0的 HTTP 應用程式服務原則工作類別中，將預設動作修改為 Default_TC :
./wsadmin.sh -lang jython -f workclassoperations.py modifyDefaultAction --type ASP --wcname Default_HTTP_WC 
--wcaction Default_TC --appname Trade-edition1.0
將 DayTrader 應用程式版本 1.2 的預設 HTTP 工作類別對映至服務原則 GOLD的預設交易類別:
import java.lang.System as System

wasinstallroot=System.getProperty("was.install.root")
execfile(wasinstallroot+"/bin/IMPPYModules.py")
import java.lang.System as System

wasinstallroot=System.getProperty("was.install.root")
execfile(wasinstallroot+"/bin/IMPPYModules.py")

#application with name DayTrader installed with edition 1.2
appName="DayTrader-edition1.2"
#Default_TC_GOLD is the default transaction class mapped to service policy GOLD
modifyAppSLADefaultAction("Default_HTTP_WC", appName, tcName, 0)

AdminConfig.save()
對於轉移使用者: 等同於 IMPPYModules.py 的 WebSphere® Virtual Enterprise 指令是 XDPYModules.py。 如果您要從 WebSphere Virtual Enterprise進行轉移，您可以繼續使用 XDPYModules.py 指令，其運作方式與 IMPPYModules.py 指令相同。
將分類規則新增至應用程式 Trade的應用程式服務原則工作類別:
./wsadmin.sh -lang jython -f workclassoperations.py addRules --wcname CustomWorkClass 
--appname Trade --type ARP --rule "1?clienthost=\'localhost\' and serverhost like \'\%%.ibm.com\'?permit?Trade"
從應用程式 Trade的應用程式服務原則工作類別中，依優先順序移除分類規則:
./wsadmin.sh -lang jython -f workclassoperations.py removeRule --wcname 
CustomWorkClass --appname Trade --type ARP --priority 1
移除應用程式 Trade的 HTTP 應用程式遞送原則工作類別:
./wsadmin.sh -lang jython -f workclassoperations.py removeWorkClass --type ARP 
--wcname CustomWorkClass --appname Trade