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

Arbeitsklassen mit Scripts verwalten

Mit dem Script workclassoperations.py können Arbeitsklassen verwaltet werden.

Verwendung

Im Folgenden wird die Verwendung des Script beschrieben.
Verwendung: wsadmin
	[-lang jython]                            
	[-f workclassoperations.py]                            
	[-odrname ODR-Name]
	[-odrnode ODR-Knoten]
	[-wcname Name_der_Arbeitsklasse]
	[-appname Anwendungsname]
	[-webmodule Webmodul]
	[-adduri ["uri1?uri2?..."]]   -addmember                          
	[-type HTTP|SOAP|IIOP|JMS]                            
	[-vhost virtualHost]                            
	[-wctype APP|GSC|ARP|ASP|GRP|GSP]                            
	[-addrule ["Priorität?Ausdruck?Aktionstyp?Aktion"]]
	[-deleterule [Priorität]]
	[-deleteuri ["uri1?uri2?..."]]  [-deletemember]                         
	[-deletewc]                            
	[-listrule]                            
	[-listuri]  [-listmember]                        
	[-setdefaultaction ["Aktionstyp?Aktion"]]
      	[-modifydefaultaction ["Aktionstyp?Aktion"]]
      	[-getdefaultaction]                                                [-systemapp]

      	[-both]                                                      

Befehlszeilenoptionen

Eine Regel für die erstellte Arbeitsklasse hinzufügen oder definieren
Verwenden Sie die Befehlszeilenoption -addrule. Verwenden Sie diese Option nicht zusammen mit den Optionen deleterule, -listrule und -getdefaultaction im selben Befehlsaufruf. Wenn Sie mehrere Regeln gleichzeitig hinzufügen, listen Sie sie in aufsteigender Reihenfolge ihrer Priorität auf.
  • 'Priorität' steht für die Priorität, die der erstellten Regel zugeordnet wird. Die Priorität ist ein ganzzahliger Wert, z. B. 0, 1, 2, 3 usw., wobei 0 die höchste Priorität ist.
  • Das Fragezeichen (?) ist ein Trennzeichen und muss in dieser Folge verwendet werden.
  • 'Ausdruck' steht für den Regelausdruck. Nähere Informationen finden Sie im Artikel Routing-Policys für Arbeitsklassen.
  • 'Aktionstyp' ist der Typ der auszuführenden Aktion. Die gültigen Typen für Routing-Policys sind permit, permitsticky, reject und redirect. Wenn Sie eine Arbeitsklasse für eine Service-Policy erstellen, ist der Aktionstyp der Name der Transaktionsklasse.
  • Der Wert von 'Aktion' richtet sich nach dem Aktionstyp. Wenn als Aktionstyp beispielsweise 'redirect' verwendet wird, ist die Aktion der Umleitungs-URL, z. B. redirect?http://www.ibm.com. Beim Aktionstyp "reject" ist die Aktion ein Zurückweisungscode, z. B. reject?404. Wenn Sie Arbeitsklassen für generische Server-Cluster erstellen, ist die Aktion der Name des generischen Server-Cluster.
Namen der Enterprise-Anwendung bzw. Anwendungsedition angeben
Verwenden Sie die Befehlszeilenoption -appname Anwendungsname, um den Namen der Enterprise-Anwendung bzw. Anwendungsedition ohne die Erweiterung .ear anzugeben.
Sammlung von URI-Mustern angeben, die dem Webmodul für die Arbeitsklasse der Enterprise-Anwendung zugeordnet werden
Verwenden Sie die Befehlszeilenoption -adduri-addmember, um die URI-Muster anzugeben, die dem Webmodul für die Arbeitsklasse der Enterprise-Anwendung zugeordnet werden sollen. Die einzelnen URI-Muster müssen durch ein Fragezeichen (?) getrennt werden und jeweils mit einem Schrägstrich (/) beginnen.
Operation angeben, die für Routing- und Service-Policys angewendet wird
Verwenden Sie die Befehlszeilenoption -both, wenn die Operation -listrule oder -getdefaultaction für Routing- und Service-Policys einer bestimmten Arbeitsklasse anwendet werden soll.
Eine bestimmte Regel löschen
Verwenden Sie die Befehlszeilenoption -deleterule, wenn Sie eine bestimmte Regel aus der Arbeitsklasse löschen möchten, die Sie mit der Option -wcname angeben. Verwenden Sie diese Option nicht zusammen mit den Optionen -addrule, -listrule und -getdefaultaction im selben Befehlsaufruf.
Eine Gruppe von URI-Mustern aus dem Webmodul für eine Arbeitsklasse löschen
Verwenden Sie die Befehlszeilenoption -deleteuri-deletemember, um die aus dem Webmodul für die Arbeitsklasse zu löschenden URI-Muster anzugeben. Diese Option gilt nur für die Arbeitsklassen von Enterprise-Anwendungen.
Den URI aus dem Element für das Webmodul für die Arbeitsklasse anzeigen
Verwenden Sie die Befehlszeilenoption -listuri-listmember, um den URI aus dem Element für das Webmodul in der Arbeitsklasse anzuzeigen. Diese Option gilt nur für die Arbeitsklassen von Enterprise-Anwendungen.
Eine Arbeitsklasse löschen
Verwenden Sie die Befehlszeilenoption -deletewc, um eine Arbeitsklasse zu löschen. Wenn Sie diese Option verwenden, müssen Sie auch die Befehlszeilenoption -wctype mit dem Wert ARP (Anwendungs-Routing-Policy), ASP (Anwendungsservice-Policy), GRP (generische Routing-Policy) oder GSP (generische Service-Policy) angeben.
Standardaktionstyp und Aktion in einer definierten Arbeitsklasse abrufen
Verwenden Sie die Befehlszeilenoption -getdefaultaction, um den Standardaktionstyp und die Aktion abzurufen, die in der Arbeitsklasse definiert sind, die Sie mit der Option -wcname angeben. Verwenden Sie diese Befehlszeilenoption nicht zusammen mit den Optionen -addrule, -delete und -listrule in einem Befehlsaufruf.
Die in der Arbeitsklasse definierten Regeln anzeigen
Verwenden Sie die Befehlszeilenoption -listrule, um die Regeln anzuzeigen, die in der Arbeitsklasse definiert sind. Verwenden Sie diese Option nicht zusammen mit den Optionen -addrule, -deleterule und -getdefaultaction in einem Befehlsaufruf.
Die Standardaktion für die Arbeitsklasse ändern
Verwenden Sie die Befehlszeilenoption -modifydefaultaction, um die Standardaktion für die vorhandene Arbeitsklasse, die Sie mit der Option -wcname angeben, zu ändern und den Aktionstyp und die Aktion anzugeben.
Den Namen des Proxy-Servers für den On Demand Router (ODR) angeben
Verwenden Sie die Befehlszeilenoption -odrname ODR-Name, um den Namen des Proxy-Servers für den On Demand Router (ODR) anzugeben.
Den Namen des ODR-Knotens angeben
Verwenden Sie die Befehlszeilenoption -odrnode ODR-Knoten, um den Namen Ihres ODR-Knotens anzugeben.
Eine Standardaktion angeben
Geben Sie mit der Option -setdefaultaction einen Aktionstyp und eine Aktion an, um eine Regel zu erstellen.
Den Anforderungstyp angeben
Verwenden Sie die Option -type, um das Protokoll anzugeben, für das diese Arbeitsklasse gilt. Gültige Werte sind HTTP und SOAP. Wenn Sie die Option -type nicht angeben, wird die Standardeinstellung HTTP verwendet.
Den Namen des virtuellen Hosts für den generischen Server-Cluster angeben
Verwenden Sie die Option -vhost virtueller_Host, um den Namen des virtuellen Hosts für den generischen Server-Cluster anzugeben.
Den Namen des Webmoduls angeben
Verwenden Sie die Option -webmodule Webmodul, um den Namen des Webmoduls ohne die Erweiterung .jar bzw. .war anzugeben.
Den Namen der Arbeitsklasse angeben
Verwenden Sie die Option -wcname Name_der_Arbeitsklasse, um den Namen der Arbeitsklasse anzugeben. Der Name der Arbeitsklasse darf keine Leerzeichen enthalten. Diese Option muss immer angegeben werden.
Typ der Arbeitsklasse angeben
Mit der Option -wctype wird beim Erstellen von Arbeitsklassen ein konstanter Wert angegeben, z. B. APP für eine Enterprise-Anwendung oder GSC für einen generischen Server-Cluster, weil der Standardaktionstyp (Aktionstyp) für die Unterscheidung zwischen den Arbeitsklassen für Routing-Policys und Service-Policys verwendet wird. In Operationen, in denen die Unterscheidung nicht offensichtlich ist, werden die Werte ARP, ASP, GRP und GSP verwendet. Wenn Sie die Option -deletewc angeben, sind die gültigen Werte ARP zum Löschen einer Arbeitsklasse für eine Anwendungs-Routing-Policy, ASP für das Löschen einer Arbeitsklasse für eine Anwendungsservice-Policy, GRP für das Löschen einer Arbeitsklasse für eine generische Routing-Policy für Server-Cluster und GSP für das Löschen einer Arbeitsklasse für eine generische Service-Policy für Server-Cluster. Es ist kein Standardwert verfügbar, deshalb muss ein Wert definiert werden.
[Version 6.0.1 and later] Namen der EJB für JMS-Arbeitsklasse angeben
Verwenden Sie die Option -ejbName <meinEJBName>, um den Namen der EJB im EJB-JAR-Modul anzugeben.

Beispiel

Es folgen verschiedene Beispiele:
Arbeitsklasse für eine Routing-Policy mit dem Namen meine_Arbeitsklasse für die Anwendung meine_Anwendung erstellen. Die Arbeitsklasse gilt für alle URIs mit dem Muster /test1 und /test2/* aus dem Webmodul mein_Webmodul und enthält eine einzige Regel, die Anforderungen aus der Domäne ibm.com zulässt. Die Standardaktion bewirkt, dass alle anderen Anforderungen mit dem Fehlercode 404 zurückgewiesen werden.
wsadmin -lang jython -f workclassoperations.py -appname meine_Anwendung -wcname meine_Arbeitsklasse -type HTTP -wctype APP -webmodule mein_Webmodul -adduri -addmember "/test1?/test2/*" -addrule  "1?clienthost LIKE \'\%%.ibm.com\'?permit?meine_Anwendung" -setdefaultaction "reject?404"
Arbeitsklasse für eine Routing-Policy für eine Enterprise-Anwendung erstellen. Die Arbeitsklasse definiert die Standardaktion "reject" mit dem Zurückweisungscode 404. Wenn Sie diesen Befehl auf einem UNIX-basierten Betriebssystem absetzen, müssen Sie die Escape-Zeichenfolge (\%%) durch (\%) ersetzen.
wsadmin -lang jython -f workclassoperations.py -appname A -wcname EigeneArbeitsklasse
-type HTTP -wctype APP -webmodule meinWebmodul -adduri -addmember "/test1?/test2/*" -addrule
"1?clienthost=\'localhost\' and serverhost like \'\%%.ibm.com\'?permit" -setdefaultaction
"reject?404"    
Arbeitsklasse für eine Service-Policy für eine Enterprise-Anwendung erstellen. Wenn Sie diesen Befehl auf einem UNIX-basierten Betriebssystem absetzen, müssen Sie die Escape-Zeichenfolge (\%%) durch (\%) ersetzen.
wsadmin -lang jython -f workclassoperations.py -appname A -wcname EigeneArbeitsklasse2
-type HTTP -wctype APP -webmodule meinWebmodul -setdefaultaction "Default_TC"
-adduri -addmember "/test1?/test2/*" -addrule "1?clienthost=\'localhost\' and serverhost
like \'\%%.ibm.com\'?Default_TC" 
Arbeitsklasse für eine Routing-Policy mit dem Standardtyp HTTP erstellen. Der Standardaktionstyp ist "permit", und die Aktion ist der Name des generischen Server-Cluster, an den die Anforderungen weitergeleitet werden.
wsadmin -lang jython -f workclassoperations.py -odrname ODR -odrnode meinKnoten01
-wcname GSCWorkClass  -vhost default_host -wctype GSC -setdefaultaction "permit?myGSC" -adduri -addmember "/test1/*"
Arbeitsklasse für die Service-Policy mit dem Standardtyp HTTP erstellen. Wenn Sie diesen Befehl auf einem UNIX-basierten Betriebssystem absetzen, müssen Sie die Escape-Zeichenfolge (\%%) durch (\%) ersetzen.
wsadmin -lang jython -f workclassoperations.py -odrname ODR -odrnode meinKnoten01
-wcname GSCWorkClass -vhost default_host -wctype GSC -addrule "1?serverhost=\'localhost\'
and serverhost like \'\%%.ibm.com\'?TransactionClassA" -setdefaultaction "TransactionClassB"
Regel mit der Priorität 1 in der Arbeitsklasse EigeneArbeitsklasse für eine Routing-Policy löschen.
wsadmin -lang jython -f workclassoperations.py -deleterule 1 -wcname EigeneArbeitsklasse
 -appname A -wctype ARP"    
Regeln in der Arbeitsklasse EigeneArbeitsklasse für Routing- und für Service-Policys (Option -both) für die Enterprise-Anwendung A auflisten.
wsadmin -lang jython -f workclassoperations.py -listrule -wcname EigeneArbeitsklasse
-both -appname A -wctype APP"     
Regeln in der Arbeitsklasse EigeneArbeitsklasse für Routing- und für Service-Policys (Option -both) für den generischen Server-Cluster auflisten.
wsadmin -lang jython -f workclassoperations.py -listrule -wcname EigeneArbeitsklasse
-both -odrname ODR -odrnode derTestknoten01 -wctype GSC"    
Standardaktionen in der Arbeitsklasse EigeneArbeitsklasse für Routing- und für Service-Policy (Option -both) abrufen.
wsadmin -lang jython -f workclassoperations.py -getdefaultaction -wcname EigeneArbeitsklasse
-both -appname A -wctype APP"     
Arbeitsklasse für eine Routing-Policy mit dem Namen EigeneArbeitsklasse in der Enterprise-Anwendung A löschen.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname EigeneArbeitsklasse
-appname A -wctype ARP"    
Arbeitsklasse für eine Service-Policy mit dem Namen EigeneArbeitsklasse in der Enterprise-Anwendung A löschen.
 wsadmin -lang jython -f workclassoperations.py -deletewc -wcname EigeneArbeitsklasse
-appname A -wctype ASP" 
Arbeitsklasse für eine Service-Policy mit dem Namen EigeneArbeitsklasse im ODR meinODR löschen.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname EigeneArbeitsklasse
-odrname meinODR -wctype GSP"   
Arbeitsklasse für eine Routing-Policy mit dem Namen EigeneArbeitsklasse im ODR meinODR löschen.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname EigeneArbeitsklasse
-odrname meinODR -wctype GRP"    
URIs in der Arbeitsklasse EigeneArbeitsklasse für die Anwendung A und das Webmodul microwebapp auflisten.
wsadmin -lang jython -f workclassoperations.py -listuri -listmember -wcname EigeneArbeitsklasse
-appname A -webmodule microwebapp"    
URIs in der Arbeitsklasse EigeneArbeitsklasse für die Anwendung A und das Webmodul microwebapp löschen. Verwenden Sie die Option -wctype ARP oder -wctype ASP, wenn Sie zwischen einer Arbeitsklasse für Routing-Policys und einer Arbeitsklasse für Service-Policys unterscheiden müssen. Wenn Sie -wctype nicht angeben, wird die Arbeitsklasse für Routing-Policys verwendet.
wsadmin -lang jython -f workclassoperations.py -deleteuri  -deletemember "/meinURI/help.jsp"
-wcname EigeneArbeitsklsse -appname A -webmodule microwebapp"    
Arbeitsklasse für eine Enterprise-Anwendung für eine Routing-Policy mit zwei zusätzlichen Regeln und der Standardregel erstellen. Wenn Sie diesen Befehl auf einem UNIX-basierten Betriebssystem absetzen, müssen Sie die Escape-Zeichenfolge (\%%) durch (\%) ersetzen.
wsadmin -lang jython -f workclassoperations.py -appname A -webmodule microwebapp
-wcname EigeneArbeitsklasse -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" 
Fügt einer vorhandenen Arbeitsklasse mit dem Namen EigeneArbeitsklasse für die Anwendung A und das Webmodul microwebapp URIs hinzu.
wsadmin -lang jython -f workclassoperations.py -adduri -addmember "/meinURI/help.jsp" -wcname
EigeneArbeitsklasse -appname A -webmodule microwebapp -wctype ARP"  
SOAP-Arbeitsklasse für Routing-Policy für eine Enterprise-Anwendung erstellen. Die Arbeitsklasse definiert die Standardaktion "reject" mit dem Zurückweisungscode 404. Wenn Sie diesen Befehl auf einem UNIX-basierten Betriebssystem absetzen, müssen Sie die Escape-Zeichenfolge (\%%) durch (\%) ersetzen.
wsadmin -lang jython -f workclassoperations.py -appname A -wcname EigeneArbeitsklasse -type
SOAP -wctype APP -webmodule meinWebmodul -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] Erstellen Sie eine IIOP-Arbeitsklasse mit dem Namen IIOPArbeitsklasse_001, die die Service-Policy für alle EJBs und alle Methoden im EJB-Modul IIOPTestEjb_Server.jar in der Anwendung MeineEjbAnwendung der Standardtransaktionsklasse zuordnet.
ImportantColonSymbol Arbeitsklassen für Routing-Policy werden für IIOP nicht unterstützt. Es werden nur Arbeitsklassen für Service-Policys unterstützt. Wenn Sie mehrere EJBs oder Methoden angeben möchten, verwenden Sie das folgende Format: <EJB-Name>:<EJB-Methode>?<EJB-Name>:<EJB-Methode>.

Beispiel: -addmember Demo_001:methode_001?Demo_002:methode_002

wsadmin -lang jython -f  workclassoperations.py -appname  
MeineEjbAnwendung -wcname IIOPArbeitsklasse_001  -type IIOP  -wctype
ASP  -webmodule  IIOPTestEjb_Server  -setdefaultaction "Default_TC"
-addmember *:*
Erstellen Sie eine IIOP-Arbeitsklasse mit dem Namen IIOPArbeitsklasse_002, die die Service-Policy für die EJB Demo und alle Methoden in Demo-EJB-Modul IIOPTestEjb_Server.jar in der Anwendung MeineEjbAnwendung der Transaktionsklasse TC_A_IIOP_002 zuordnet.
wsadmin -lang jython -f workclassoperations.py -appname 
MeineEjbAnwendung -wcname IIOPArbeitsklasse_002 type IIOP -wctype
ASP -webmodule IIOPTestEjb_Server -setdefaultaction "TC_A_IIOP_002" 
-addmember Demo:*
Erstellen Sie eine IIOP-Arbeitsklasse IIOPArbeitsklasse_003, die die Service-Policy für die EJB mit dem Namen Demo und alle Methoden im Demo-EJB-Modul IIOPTestEjb_Server.jar in der Anwendung MeineEjbAnwendung der Standardtransaktionsklasse zuordnet. Wenn der Methodenname meineSondermethode und der Clienthostname localhost lauten, soll die Service-Policy der Transaktionsklasse TC_A_IIOP_003 zugeordnet werden.
wsadmin -lang jython -f workclassoperations.py -appname 
MeineEjbAnwendung -wcname IIOPArbeitsklasse_003 -type IIOP -wctype
ASP -webmodule IIOPTestEjb_Server -setdefaultaction "Default_TC" 
-addmember Demo:meineSondermethode -addrule "1?clienthost=\'localhost\'?TC_A_IIOP_003"
[Version 6.0.1 and later] Erstellen Sie eine JMS-Arbeitsklasse. Für JMS-Arbeitsklassen muss das folgende Format verwendet werden: <Bus>:<Destination>?<Bus>:<Destination>. Dieses Beispiel enthält zwei Einträge.
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
Routing-Policys für Arbeitsklassen

Referenzartikel    

Nutzungsbedingungen | Feedback Letzte Aktualisierung: Mar 23, 2006 9:51:53 AM 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. Alle Rechte vorbehalten.
Dieses Information Center beruht auf der Eclipse-Technologie. (http://www.eclipse.org)