WebSphere Extended Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, z/OS

スクリプトによる作業クラスの管理

workclassoperations.py スクリプトを使用して 作業クラスを管理できます。

使用法

以下に、スクリプトの使用法を示します。
Usage: wsadmin                            
	[-lang jython]                            
	[-f workclassoperations.py]                            
	[-odrname odrName]                            
	[-odrnode odrNode]                            
	[-wcname workClassName]                            
	[-appname appName]                            
	[-webmodule webModule]                            
	[-adduri ["uri1?uri2?..."]]   -addmember                          
	[-type HTTP|SOAP|IIOP|JMS]                            
	[-vhost virtualHost]                            
	[-wctype APP|GSC|ARP|ASP|GRP|GSP]                            
	[-addrule ["priority?expr?actiontype?action"]]                            
	[-deleterule [priority]]                            
	[-deleteuri ["uri1?uri2?..."]]  [-deletemember]                         
	[-deletewc]                            
	[-listrule]                            
	[-listuri]  [-listmember]                        
	[-setdefaultaction ["actiontype?action"]]                 
      	[-modifydefaultaction ["actiontype?action"]]                  
      	[-getdefaultaction]                                                [-systemapp]

      	[-both]                                                      

コマンド行・オプション

作成した作業クラスのルールを追加または定義してください
-addrule コマンド行オプションを使用してください。このオプションは同一のコマンド呼び出しで、 -deleterule-listrule-getdefaultaction オプションと 共に使用しないでください。同時に複数のルールを追加する場合、 優先順位の順に、低い数から高い数へ順々に リストしてください。
  • 「priority」は、作成するルールに割り当てる優先順位です。優先順位は、 0、1、2、3 などの整数値で、0 が最も優先度の 高い値です。
  • 疑問符 (?) は 区切り文字で、このシーケンスで必要です。
  • 「expr」はルール式です。詳しくは、作業クラスの ルーティング・ポリシーを参照してください。
  • 「actiontype」は実行するアクションのタイプで、 ルーティング・ポリシーに対する permitpermitstickyreject、または redirect の列挙値を持ちます。サービス・ポリシー作業クラスを作成する場合、 actiontype はトランザクション・クラス名です。
  • 「action」の値は actiontype によります。 例えば、 actiontype が「redirect」の場合、アクションはリダイレクト URL です。例えば、redirect?http://www.ibm.com となります。 actiontype が「reject」の場合、アクションはリジェクト・コードです。例えば、reject?404 となります。 汎用サーバー・クラスター作業クラスの場合、アクションは汎用サーバー・クラスターの 名前です。
エンタープライズ・アプリケーションまたはアプリケーション・エディションの名前を指定
-appname appName コマンド行オプションを使用して、拡張子 .ear を付けずにエンタープライズ・アプリケーションまたはアプリケーション・エディションの名前を指定します。
URI パターンのコレクションを指定して、エンタープライズ・アプリケーションの 作業クラス Web モジュールに関連付けます。
-adduri -addmember コマンド行オプションを使用して、 エンタープライズ・アプリケーションの作業クラス Web モジュールに関連付けする URI パターンのコレクションを 指定してください。URI パターンは疑問符 (?) 符号で分離され、 それぞれの URI パターンはスラッシュ (/) で始める必要があります。
オペレーションを指示して、ルーティングとサービス・ポリシーを適用
-both コマンド行オプションを使用して、 -listrule または -getdefaultaction オペレーションが、指定された作業クラス名でルーティングとサービス・ポリシーの 両方に適用するよう指示してください。
特定のルールの削除
-deleterule コマンド行オプションを使用して、 -wcname オプションを使用して指定した作業クラスから特定のルールを削除してください。このオプションは、 同じコマンド呼び出し上で -addrule-listrule-getdefaultaction オプション と共に使用することはできません。
Web モジュール作業クラスから URI パターンのコレクションを削除
-deleteuri -deletemember コマンド行オプションを使用して、 Web モジュール作業クラスから削除する URI パターンのコレクションを指定してください。このオプションは エンタープライズ・アプリケーション作業クラスにのみ適用できます。
作業クラスの Web モジュール・エレメントから URI を表示
-listuri -listmember コマンド行オプションを使用して、 作業クラスの Web モジュール・エレメントから URI を表示してください。 このオプションはエンタープライズ・アプリケーション作業クラス にのみ適用できます。
作業クラスの削除
-deletewc コマンド行オプションを使用して、作業クラスを削除してください。 またこのオプションで、 ARP (アプリケーション・ルーティング・ポリシー)、ASP (アプリケーション・サービス・ポリシー)、 GRP (汎用ルーティング・ポリシー)、GSP (汎用サーバー・ポリシー) のいずれかの 値を持つ -wctype コマンド行オプションを指定する必要があります。
デフォルトのアクション・タイプと、定義済み作業クラスのアクションの取得
-getdefaultaction コマンド行オプションを使用して、 デフォルトの actiontype と、-wcname オプションを使用して指定した作業クラスに定義したアクション を取得してください。このコマンド行オプションは同一のコマンド呼び出しで、 -addrule-delete-listrule オプションと共に 使用しないでください。
作業クラスに定義されたルールの表示
-listrule コマンド行オプションを使用して、作業クラスに定義されたルールを表示 してください。このオプションは同一のコマンド呼び出しで、-addrule-deleterule-getdefaultaction オプションと共に使用しないでください。
作業クラスのデフォルトのアクションの変更
-modifydefaultaction を使用して、-wcname オプションの使用と actiontype と action の指定によって、指定された既存作業クラスに対するデフォルトのアクションを 変更してください。
オンデマンド・ルーター (ODR) プロキシー・サーバーの名前の指定
-odrname odrName コマンド行オプションを使用して、オンデマンド・ルーター (ODR) プロキシー・サーバー の名前を指定してください。
ODR ノード名の指定
-odrnode odrNode コマンド行オプションを使用して、ODR ノードの名前を指定して ください。
デフォルトのアクションの指定
actiontype と action を指定した -setdefaultaction オプションを使用して、 アスタリスク (*) 記号で指示する式でルールを作成し、アクション・タイプとアクションをオプションで指定した値に設定してください。
要求タイプの指定
-type オプションを使用して、この作業クラスが適用するプロトコルを 指定してください。許容値は HTTP と SOAP です。-type オプションが指定されない場合、デフォルトの HTTP が想定されます。
汎用サーバー・クラスター用仮想ホストの名前の指定
-vhost virtualHost オプションを使用して、 汎用サーバー・クラスター用仮想ホストの名前を指定してください。
Web モジュールの名前の指定
-webmodule webModule オプションを使用し、.jar または .war 拡張子を付けないで Web モジュール名を指定してください。
作業クラスの名前の指定
-wcname workClassName オプションを使用し、作業クラスの名前 を指定してください。作業クラス名にはスペースを入れることはできません。このオプションは常時 必要です。
作業クラス・タイプの指定
デフォルトのアクション・タイプ (actiontype) は、ルーティングとサービス・ポリシー作業クラス を識別するために使用されるため、作業クラスの作成時に、-wctype オプションは、 エンタープライズ・アプリケーションの APP または汎用サーバー・クラスターの GSC の いずれかの定数値を利用します。区別が明白でないオペレーションでは、 ARPASPGRPGSP が使用されます。-deletewc オプションが指定されている場合、 許容値は、アプリケーション・ルーティング作業クラスを削除する ARP、 アプリケーション・サービス・ポリシー作業クラスを削除する ASP、汎用サーバー・クラスター・ルーティング・ポリシー作業クラスを 削除する GRP、汎用サーバー・サービス・ポリシー作業クラスを 削除する GSP です。デフォルトの設定がないので、値を指定 してください。
[Version 6.0.1 and later] JMS 作業クラスの EJB 名の指定
EJB jar モジュール内の Enterprise JavaBeans Bean 名を指定するには、-ejbName<myEJBname> オプションを使用します。

Example

以下に例を示します。
my_Work_Class という名前の my_App アプリケーションに対する ルーティング・ポリシー作業クラスを作成します。作業クラスは、my_Web_Module Web モジュールの パターン /test1/test2/* を持つすべての URI に適用され、 ibm.com ドメインからの要求を許可する単一ルールを含みます。デフォルトのアクションにより、 その他のすべての要求はエラー・コード 404 でリジェクトされます。
wsadmin -lang jython -f workclassoperations.py -appname my_App -wcname my_Work_Class  -type HTTP -wctype APP -webmodule my_Web_Module -adduri -addmember "/test1?/test2/*" -addrule  "1?clienthost LIKE ¥'¥%%.ibm.com¥'?permit?my_App" -setdefaultaction "reject?404"
ルーティング・ポリシーのエンタープライズ・アプリケーション作業クラスを作成します。デフォルトのアクションは、 リジェクト・コード 404 でのリジェクトです。このコマンドを UNIX 環境で発行した場合、エスケープ・シーケンス (¥%%) は (¥%) に置き換えられます。
wsadmin -lang jython -f workclassoperations.py -appname A -wcname CustomWorkClass
-type HTTP -wctype APP -webmodule myWebModule -adduri -addmember "/test1?/test2/*" -addrule
"1?clienthost=¥'localhost¥' and serverhost like ¥'¥%%.ibm.com¥'?permit" -setdefaultaction
"reject?404"    
サービス・ポリシーのエンタープライズ・アプリケーション作業クラスを作成します。このコマンドを UNIX 環境で発行した場合、エスケープ・シーケンス (¥%%) を (¥%) に置き換えます。
wsadmin -lang jython -f workclassoperations.py -appname A -wcname Custom2WorkClass
-type HTTP -wctype APP -webmodule myWebModule -setdefaultaction "Default_TC"
-adduri -addmember "/test1?/test2/*" -addrule "1?clienthost=¥'localhost¥' and serverhost
like ¥'¥%%.ibm.com¥'?Default_TC" 
デフォルト・タイプ HTTP で、ルーティング・ポリシーの作業クラスを作成します。その デフォルトのアクション・タイプは permit で、アクションは要求の送付先になる汎用サーバー・クラスター名 です。
wsadmin -lang jython -f workclassoperations.py -odrname ODR -odrnode myNode01
-wcname GSCWorkClass  -vhost default_host -wctype GSC -setdefaultaction "permit?myGSC" -adduri -addmember "/test1/*"
デフォルト・タイプ HTTP で、サービス・ポリシーの作業クラスを作成します。このコマンドを UNIX 環境で発行している場合、エスケープ・シーケンス (¥%%) は (¥%) に置き換えられます。
wsadmin -lang jython -f workclassoperations.py -odrname ODR -odrnode myNode01
-wcname GSCWorkClass -vhost default_host -wctype GSC -addrule "1?serverhost=¥'localhost¥'
and serverhost like ¥'¥%%.ibm.com¥'?TransactionClassA" -setdefaultaction "TransactionClassB"
ルーティング・ポリシーの CustomWorkClass 作業クラスの、優先順位が 1 であるルールを削除します。
wsadmin -lang jython -f workclassoperations.py -deleterule 1 -wcname CustomWorkClass
 -appname A -wctype ARP"    
エンタープライズ・アプリケーション A のルーティング・ポリシーとサービス・ポリシーの両方について (-both オプション)、CustomWorkClass 作業クラスのルールをリストします。
wsadmin -lang jython -f workclassoperations.py -listrule -wcname CustomWorkClass
-both -appname A -wctype APP"     
汎用サーバー・クラスターのルーティング・ポリシーとサービス・ポリシーの両方について (-both オプション)、 CustomWorkClass 作業クラスのルールをリストします。
wsadmin -lang jython -f workclassoperations.py -listrule -wcname CustomWorkClass
-both -odrname ODR -odrnode theTestNode01 -wctype GSC"    
ルーティングとサービス・ポリシーの両方 (-both オプション) で、 CustomWorkClass という名前の作業クラスのデフォルトのアクションを取得します。
wsadmin -lang jython -f workclassoperations.py -getdefaultaction -wcname CustomWorkClass
-both -appname A -wctype APP"     
エンタープライズ・アプリケーション A にある CustomWorkClass という名前のルーティング・ポリシー作業クラス を削除します。
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-appname A -wctype ARP"    
エンタープライズ・アプリケーション A エディションにある CustomWorkClass という名前のサービス・ポリシー作業クラス を削除します。
 wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-appname A -wctype ASP" 
myODR という名前の ODR にある CustomWorkClass というサービス・ポリシー作業クラスを 削除します。
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-odrname myODR -wctype GSP"   
myODR という名前の ODR にある CustomWorkClass というルーティング・ポリシー作業クラスを 削除します。
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-odrname myODR -wctype GRP"    
アプリケーション A と Web モジュール microwebapp の CustomWorkClass という名前の作業クラスで URI をリストします。
wsadmin -lang jython -f workclassoperations.py -listuri -listmember -wcname CustomWorkClass
-appname A -webmodule microwebapp"    
アプリケーション A と Web モジュール microwebapp の CustomWorkClass という名前の作業クラスで URI を削除します。 -wctype ARP または ASP を使用して、ルーティング・ポリシー作業クラスとサービス・ポリシー作業クラス を識別します。 -wctype が使用されない場合、ルーティング・ポリシー作業クラス が使用されます。
wsadmin -lang jython -f workclassoperations.py -deleteuri  -deletemember "/myURI/help.jsp"
-wcname CustomWorkClass -appname A -webmodule microwebapp"    
2 つの追加ルールとデフォルトでルーティング・ポリシーのエンタープライズ・アプリケーション作業クラスを 作成します。このコマンドを UNIX 環境で発行している場合、エスケープ・シーケンス (¥%%) は (¥%) に置き換えられます。
wsadmin -lang jython -f workclassoperations.py -appname A -webmodule microwebapp
-wcname Custom2WorkClass -wctype APP -type HTTP -adduri -addmember "/test1?/test2/*"
-setdefaultaction "redirect?http://www.ibm.com" -addrule "1?clienthost=¥'localhost¥'
and serverhost like ¥'¥%%.ibm.com¥'?permit?A"  -addrule "2?protocol IN (¥'HTTP¥',¥'HTTPS¥')?permitsticky?A" 
アプリケーション A と Web モジュール microwebapp の CustomWorkClass という名前の既存作業クラスに URI を 追加します。
wsadmin -lang jython -f workclassoperations.py -adduri -addmember "/myURI/help.jsp" -wcname
CustomWorkClass -appname A -webmodule microwebapp -wctype ARP"  
ルーティング・ポリシーのエンタープライズ・アプリケーション SOAP 作業クラスを作成します。デフォルトのアクションは、 リジェクト・コード 404 でのリジェクトです。このコマンドを UNIX 環境で発行している場合、エスケープ・シーケンス (¥%%) は (¥%) に置き換えられます。
wsadmin -lang jython -f workclassoperations.py -appname A -wcname CustomWorkClass -type 
SOAP -wctype APP -webmodule myWebModule -adduri -addmember "RemoteTest:addJob?RemoteTest:removeJob" 
-addrule "1?clienthost=¥'localhost¥' and serverhost like ¥'¥%%.ibm.com¥'?permit" 
-setdefaultaction "reject?404"
[Version 6.0.1 and later] MyEjbApplication という名前のアプリケーションに含まれた IIOPTestEjb_Server.jar という名前の EJB モジュールのすべての EJB およびすべてのメソッドに対するデフォルトのトランザクション・クラスにマッピングするサービス・ポリシーの IIOP 作業クラス (IIOPWorkClass_001 という名前) を作成します。
ImportantColonSymbol ルーティング・ポリシーの作業クラスは、IIOP に対してサポートされていません。サービス・ポリシーの作業クラスのみがサポートされています。加えて、複数の EJB またはメソッドを指定するには、次の形式を使用します。<ejbName>:<ejbMethod>?<ejbName>:<ejbMethod>

例えば、次のとおりです。-addmember Demo_001:method_001?Demo_002:method_002

wsadmin -lang jython -f  workclassoperations.py -appname  
MyEjbApplication -wcname IIOPWorkClass_001  -type IIOP  -wctype 
ASP  -webmodule  IIOPTestEjb_Server  -setdefaultaction "Default_TC"
-addmember *:*
MyEjbApplication という名前のアプリケーションに含まれた IIOPTestEjb_Server.jar という 名前の Demo EJB モジュールの Demo という名前の EJB およびすべてのメソッドに対する トランザクション・クラス (TC_A_IIOP_002 という名前) にマッピングするサービス・ポリシーの IIOP 作業クラス (IIOPWorkClass_002 という名前) を作成します。
wsadmin -lang jython -f  workclassoperations.py -appname  
MyEjbApplication -wcname IIOPWorkClass_002 type IIOP -wctype 
ASP -webmodule IIOPTestEjb_Server -setdefaultaction "TC_A_IIOP_002" 
-addmember Demo:*
MyEjbApplication という名前のアプリケーションに含まれた IIOPTestEjb_Server.jar という名前の Demo EJB モジュールの Demo という名前の EJB およびすべてのメソッドに対するデフォルトのトランザクション・クラスにマッピングするサービス・ポリシーの IIOP 作業クラス (IIOPWorkClass_003 という名前) を作成します。メソッド名が mySpecialMethod で、クライアント・ホスト名が localhost である場合、トランザクション・クラス TC_A_IIOP_003 にサービス・ポリシーをマップします。
wsadmin -lang jython -f  workclassoperations.py -appname  
MyEjbApplication -wcname IIOPWorkClass_003 -type IIOP -wctype 
ASP  -webmodule  IIOPTestEjb_Server  -setdefaultaction "Default_TC"
-addmember Demo:mySpecialMethod -addrule "1?clienthost=¥'localhost¥'?TC_A_IIOP_003"
[Version 6.0.1 and later] JMS 作業クラスを作成します。JMS 作業クラスの場合、<bus>:<destination>?<bust>:<destination> の形式を使用してください。次の例は 2 つのエントリー用です。
wsadmin.sh -lang jython -f workclassoperations.py -appname A 
-wcname JMSWorkClass1 -type JMS -wctype ASP -webmodule 
microwebmodule.war -setdefaultaction "Default_TC" -addmember 
bus1:destination1
wsadmin.sh -lang jython -f workclassoperations.py -appname MdbAA 
-wcname JMSWorkClass2 -type JMS -wctype ASP -ejbmodule MDBAA 
-ejbNameMDBAA  -setdefaultaction "Default_TC"  -addmember 
bus1:destination2



Related reference
作業クラスのルーティング・ポリシー

Reference topic    

Terms of Use | Feedback Last updated: Mar 20, 2006 12:29:37 PM EST
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=?topic=/com.ibm.websphere.xd.doc/info/odoe_task/rodwcscript.html

© Copyright IBM 2005, 2006. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)