WebSphere Extended Deployment, Version 6.0.x     Systèmes d'exploitation : AIX, HP-UX, Linux, Solaris, Windows, z/OS

Gestion de classes de travail à l'aide de scripts

Le script workclassoperations.py permet de gérer des classes de travail.

Syntaxe

Le script accepte la syntaxe suivante.
Syntaxe : wsadmin                            
	[-lang jython]                         
	[-f workclassoperations.py]                            
	[-odrname nomODR]                           
	[-odrnode noeudODR]                            
	[-wcname nomClasseTravail]                            
	[-appname nomApp]                            
	[-webmodule moduleWeb]                            
	[-adduri ["uri1?uri2?..."]]   -addmember                          
	[-type HTTP|SOAP|IIOP|JMS]                            
	[-vhost hôteVirtuel]                            
	[-wctype APP|GSC|ARP|ASP|GRP|GSP]                            
	[-addrule ["priority?expr?actiontype?action"]]                            
	[-deleterule [priorité]]                            
	[-deleteuri ["uri1?uri2?..."]]  [-deletemember]                         
	[-deletewc]                            
	[-listrule]                            
	[-listuri]  [-listmember]                        
	[-setdefaultaction ["actiontype?action"]]                 
      	[-modifydefaultaction ["actiontype?action"]]                  
      	[-getdefaultaction]                                                [-systemapp]

      	[-both]                                                      

Options de ligne de commande

Ajout ou définition d'une règle pour la classe de travail créée
Utilisez l'option de ligne de commande -addrule. Evitez de l'utiliser avec -deleterule, -listrule ou -getdefaultaction lors du même appel de commande. Si vous ajoutez plusieurs règles simultanément, dressez leur liste par ordre de priorité croissant.
  • 'priority' est la priorité affectée à la règle en cours de création. La priorité est une valeur entière telle que 0, 1, 2, 3, et ainsi de suite, 0 représentant la priorité la plus élevée.
  • Le point d'interrogation (?) est un un séparateur requis dans cette séquence.
  • 'expr' est une expression de règle. Pour plus d'informations, voir Stratégies de routage des classes de travail.
  • 'actiontype' est le type d'action à effectuer et est accompagné de valeurs énumérées de permit, permitsticky, reject ou redirect pour la règle de routage. Si vous créez une classe de travail de stratégie de service, 'actiontype' est le nom de la classe de transaction.
  • La valeur de 'action' dépend de 'actiontype'. Par exemple, si actiontype est 'redirect', l'action est une URL de redirection. Par exemple, redirect?http://www.ibm.com. Pour l'actiontype 'reject', l'action est un code de rejet. Par exemple, reject?404. Pour les classes de travail de cluster de serveurs génériques, l'action est le nom du cluster de serveurs génériques.
Spécifiez le nom de l'application d'entreprise ou de l'édition d'application
A l'aide de l'option de ligne de commande -appname nomApp, spécifiez le nom de l'application d'entreprise ou de l'édition d'application sans l'extension .ear.
Fournissez un ensemble de motifs d'URI à associer avec le module Web de classe de travail pour l'application d'entreprise.
L'option de ligne de commande -adduri -addmember permet de fournir un ensemble de motifs URI à associer au module Web de classe de travail pour l'application d'entreprise. Les motifs d'URI sont séparés par un point d'interrogation (?) et chaque motif d'URI doit commencer par une barre oblique (/).
Indiquez l'opération à appliquer pour les stratégies de routage et de service
L'option de ligne de commande -both permet d'indiquer que l'opération -listrule ou l'opération -getdefaultaction doit être appliquée pour les stratégies de routage et de service sur le nom de la classe de travail donnée.
Supprimez une règle spécifique
L'option de ligne de commande -deleterule permet de supprimer une règle spécifique à partir de la classe de travail spécifiée à l'aide de l'option -wcname. Evitez de l'utiliser avec -addrule, -listrule ou -getdefaultaction lors du même appel de commande.
Supprimez une collection de motifs URI d'une classe de travail de module Web
L'option de ligne de commande -deleteuri -deletemember fournit un ensemble de motifs URI à supprimer de la classe de travail de module Web. Cette option est applicable aux classes de travail d'application d'entreprise uniquement.
Affichez l'URI à partir de l'élément de module Web de la classe de travail
L'option de ligne de commande -listuri -listmember permet d'afficher un URI à partir de l'élément de module Web de la classe de travail. Cette option est applicable aux classes de travail d'application d'entreprise uniquement.
Supprimez une classe de travail
L'option de ligne de commande -deletewc permet de supprimer une classe de travail. Avec cette option, vous devez également indiquer l'option de ligne de commande -wctype avec la valeur ARP (application routing policy), ASP (application service policy), GRP (generic routing policy) ou GSP (generic server policy).
Extrayez le type d'action et l'action par défaut d'une classe de travail définie
L'option de ligne de commande -getdefaultaction permet d'obtenir le type d'action et l'action définis dans la classe de travail indiquée à l'aide de l'option -wcname. Evitez d'utiliser cette option de ligne de commande avec l'option -addrule, -delete ou -listrule dans la même instruction d'appel.
Affichez les règles définies dans la classe de travail
L'option de ligne de commande -listrule permet d'afficher les règles définies dans la classe de travail. Evitez de l'utiliser avec -addrule, -deleterule ou -getdefaultaction lors du même appel de commande.
Modifiez l'action par défaut pour la classe de travail
L'option -modifydefaultaction permet de modifier l'action par défaut pour la classe de travail existante indiquée à l'aide de l'option -wcname et des paramètres actiontype et action.
Indiquez le nom du serveur proxy du routeur ODR
A l'aide de l'option de ligne de commande -odrname nomODR, spécifiez le nom du serveur proxy du routeur ODR.
Indiquez le nom du noeud ODR
A l'aide de l'option de ligne de commande -odrnode noeudODR, indiquez le nom de votre noeud ODR.
Indiquez une action par défaut
L'option -setdefaultaction suivie d'actiontype et d'action permettent de créer une règle avec l'expression signalée par un astérisque (*) et de définir le type d'action et l'action associés aux valeurs fournies.
Indiquez le type de demande
L'option -type permet d'indiquer le protocole auquel cette classe de travail s'applique. HTTP et SOAP sont des valeurs acceptées. En l'absence d'option -type, HTTP est utilisé par défaut.
Indiquez le nom de l'hôte virtuel du cluster de serveurs génériques
L'option -vhost hôteVirtuel permet d'indiquer le nom de l'hôte virtuel du cluster de serveurs génériques.
Indiquez le nom du module Web
L'option -webmodule ModuleWeb permet d'indiquer le nom du module Web sans extension .jar ou .war.
Indiquez le nom de la classe de travail
L'option -wcname nomClasseTravail permet d'indiquer le nom de la classe de travail. Aucun caractère d'espacement n'est autorisé dans le nom de la classe de travail. Cette option est toujours requise.
Indiquez le type de classe de travail
L'option -wctype accepte la valeur constante APP pour une application d'entreprise ou la valeur constante GSC pour un cluster de serveurs génériques lors de la création de classes de travail car le type d'action par défaut, actiontype, est employé pour distinguer les classes de routage des classes de travail de stratégie de service. Dans les opérations où la distinction n'est pas évidente, ARP, ASP, GRP et GSP sont employés. Si l'option -deletewc est indiquée, les options acceptées sont ARP pour supprimer la classe de travail de routage d'application, ASP pour supprimer la classe de travail de stratégie de service d'application, GRP pour supprimer la classe de travail de stratégie de routage de cluster de serveurs génériques et GSP pour supprimer la classe de travail de stratégie de service de serveur générique. Il n'existe pas de valeur par défaut ; vous devez donc indiquer une valeur.
[Version 6.0.1 and later] Spécifiez le nom EJB de la classe de travail JMS
L'option -ejbName <monnomEJB> permet de spécifier le nom du bean Enterprise JavaBeans dans le module jar EJB.

Exemple

Voici quelques exemples :
Créez une classe de travail de règle de routage pour l'application mon_App dénommée ma_Classe_Travail. La classe de travail s'applique à tous les URI ayant pour motif /test1 et /test2/* à partir du module Web my_Web_Module et contient une règle unique autorisant les demandes à partir du domaine ibm.com. L'action par défaut a pour effet de refuser toutes les demandes avec le code erreur 404.
wsadmin -lang jython -f workclassoperations.py -appname mon_App -wcname ma_classe_travail  -type HTTP -wctype APP -webmodule mon_module_Web -adduri -addmember "/test1?/test2/*" -addrule  "1?clienthost LIKE \'\%%.ibm.com\'?permit?mon_App" -setdefaultaction "reject?404"
Créez une classe de travail d'application d'entreprise pour une règle de routage. Son action par défaut est le refus de traitement avec le code 404. Si vous émettez cette commande sur une plateforme UNIX, la séquence d'échappement (\%%) doit être remplacée par (\%).
wsadmin -lang jython -f workclassoperations.py -appname A -wcname ClasseTravailPersonnalisée
-type HTTP -wctype APP -webmodule monModuleWeb -adduri -addmember "/test1?/test2/*" -addrule
"1?clienthost=\'localhost\' and serverhost like \'\%%.ibm.com\'?permit" -setdefaultaction
"reject?404"    
Créez une classe de travail d'application d'entreprise pour une stratégie de service. Si vous émettez cette commande sur une plateforme UNIX, la séquence d'échappement (\%%) doit être remplacée par (\%).
wsadmin -lang jython -f workclassoperations.py -appname A -wcname ClasseTravail2Personnalisée
-type HTTP -wctype APP -webmodule monModuleWeb -setdefaultaction "Default_TC"
-adduri -addmember "/test1?/test2/*" -addrule "1?clienthost=\'localhost\' and serverhost
like \'\%%.ibm.com\'?Default_TC" 
Créez une classe de travail pour une règle de routage ayant HTTP comme type par défaut. Son type d'action par défaut est permit, et l'action est le nom du cluster de serveurs génériques vers lequel sont dirigées les demandes.
wsadmin -lang jython -f workclassoperations.py -odrname ODR -odrnode monNoeud01
-wcname ClasseTravailGSC  -vhost default_host -wctype GSC -setdefaultaction "permit?monGSC" -adduri -addmember "/test1/*"
Créez une classe de travail pour une stratégie de service ayant HTTP comme type par défaut. Si vous émettez cette commande sur une plateforme UNIX, la séquence d'échappement (\%%) doit être remplacée par (\%).
wsadmin -lang jython -f workclassoperations.py -odrname ODR -odrnode monNoeud01
-wcname ClasseTravailGSC -vhost default_host -wctype GSC -addrule "1?serverhost=\'localhost\'
and serverhost like \'\%%.ibm.com\'?TransactionClassA" -setdefaultaction "TransactionClassB"
Supprimez une règle avec priorité 1 dans la classe de travail ClasseTravailPersonnalisée pour une règle de routage.
wsadmin -lang jython -f workclassoperations.py -deleterule 1 -wcname ClasseTravailPersonnalisée
 -appname A -wctype ARP"    
Dressez la liste des règles de la classe de travail ClasseTravailPersonnalisée à la fois (option -both) pour les règles de routage et les stratégies de service d'une application d'entreprise A.
wsadmin -lang jython -f workclassoperations.py -listrule -wcname ClasseTravailPersonnalisée
-both -appname A -wctype APP"    
Dressez la liste des règles de la classe de travail ClasseTravailPersonnalisée à la fois (option -both) pour les règles de routage et les stratégies de service d'un cluster de serveurs génériques.
wsadmin -lang jython -f workclassoperations.py -listrule -wcname ClasseTravailPersonnalisée
-both -odrname ODR -odrnode NoeudTest01 -wctype GSC"    
Recherchez les actions par défaut de la classe de travail ClasseTravailPersonnalisée à la fois (option -both) pour les règles de routage et les stratégies de service.
wsadmin -lang jython -f workclassoperations.py -getdefaultaction -wcname ClasseTravailPersonnalisée
-both -appname A -wctype APP"     
Supprimez une classe de travail de règle de routage dénommée ClasseTravailPersonnalisée sous une application d'entreprise A.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname ClasseTravailPersonnalisée
-appname A -wctype ARP"    
Supprimez une classe de travail de stratégie de service dénommée ClasseTravailPersonnalisée sous l'édition A d'application d'entreprise.
 wsadmin -lang jython -f workclassoperations.py -deletewc -wcname ClasseTravailPersonnalisée
-appname A -wctype ASP" 
Supprimez une classe de travail de stratégie de service dénommée ClasseTravailPersonnalisée sous le routeur ODR dénommé monODR.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname ClasseTravailPersonnalisée
-odrname monODR -wctype GSP"   
Supprimez une classe de travail de règle de routage dénommée ClasseTravailPersonnalisée sous le routeur ODR dénommé monODR.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname ClasseTravailPersonnalisée
-odrname monODR -wctype GRP"    
Dressez la liste des URI d'une classe de travail dénommée ClasseTravailPersonnalisée pour l'application A et le module Web microwebapp.
wsadmin -lang jython -f workclassoperations.py -listuri -listmember -wcname ClasseTravailPersonnalisée
-appname A -webmodule microwebapp"    
Supprimez les URI d'une classe de travail dénommée ClasseTravailPersonnalisée pour l'application A et le module Web microwebapp. Avec le commutateur -wctype, utilisez ARP ou ASP pour indiquer le type de classe de travail de stratégie (de routage ou de service, respectivement). Si -wctype n'est pas indiquée, la classe de travail de règle de routage est employée.
wsadmin -lang jython -f workclassoperations.py -deleteuri  -deletemember "/myURI/help.jsp"
-wcname ClasseTravailPersonnalisée -appname A -webmodule microwebapp"    
Créez une classe de travail d'application d'entreprise pour une règle de routage avec deux règles supplémentaires et la valeur par défaut. Si vous émettez cette commande sur une plateforme UNIX, la séquence d'échappement (\%%) doit être remplacée par (\%).
wsadmin -lang jython -f workclassoperations.py -appname A -webmodule microwebapp
-wcname ClasseTravail2Personnalisée -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" 
Ajoutez des URI à une classe de travail dénommée ClasseTravailPersonnalisée pour l'application A et le module Web microwebapp.
wsadmin -lang jython -f workclassoperations.py -adduri -addmember "/myURI/help.jsp" -wcname
ClasseTravailPersonnalisée -appname A -webmodule microwebapp -wctype ARP"  
Créez une classe de travail SOAP d'application d'entreprise pour une règle de routage. Son action par défaut est le refus de traitement avec le code 404. Si vous émettez cette commande sur une plateforme UNIX, la séquence d'échappement (\%%) doit être remplacée par (\%).
wsadmin -lang jython -f workclassoperations.py -appname A -wcname ClasseTravailPersonnalisée -type
SOAP -wctype APP -webmodule monModuleWeb -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] Créez une classe de travail IIOP appelée ClasseTravailIIOP_001 pour une stratégie de service mappée vers une classe de transaction par défaut pour tous les EJB et toutes les méthodes d'un module EJB appelé IIOPTestEjb_Server.jar se trouvant dans une application appelée MonApplicationEjb.
ImportantColonSymbol Les classes de travail des règles de routage ne sont pas prises en charge pour IIOP. Seules les classes de travail des stratégies de service le sont. De plus, pour spécifier plusieurs EJB ou méthodes, utilisez le format suivant : <nomEjb>:<méthodeEjb>?<nomEjb>:<méthodeEjb>.

Exemple : -addmember Démo_001:méthode_001?Démo_002:méthode_002

wsadmin -lang jython -f  workclassoperations.py -appname  
MonApplicationEjb -wcname ClasseTravailIIOP_001  -type IIOP  -wctype
ASP  -webmodule  IIOPTestEjb_Server  -setdefaultaction "Default_TC"
-addmember *:*
Créez une classe de travail IIOP appelée ClasseTravailIIOP_002 pour une stratégie de service mappée vers la classe de transaction appelée TC_A_IIOP_002 pour l'EJB appelé Démo et toutes les méthodes figurant dans le module EJB Démo appelé IIOPTestEjb_Server.jar qui se trouve dans l'application appelée MonApplicationEjb.
wsadmin -lang jython -f workclassoperations.py -appname 
MonApplicationEjb -wcname ClasseTravailIIOP_002 type IIOP -wctype
ASP -webmodule IIOPTestEjb_Server -setdefaultaction "TC_A_IIOP_002" 
-addmember Démo:*
Créez une classe de travail IIOP appelée ClasseTravailIIOP_003 pour une stratégie de service mappée vers la classe de transaction par défaut pour un EJB appelé Démo et toutes les méthodes figurant dans le module EJB Démo appelé IIOPTestEjb_Server.jar qui se trouve dans l'application appelée MonApplicationEjb. Si le nom de la méthode est maMéthodeSpéciale et que le nom d'hôte du client est localhost, mappez la stratégie de service à la classe de transaction TC_A_IIOP_003.
wsadmin -lang jython -f workclassoperations.py -appname 
MonApplicationEjb -wcname ClasseTravailIIOP_003 -type IIOP -wctype
ASP -webmodule IIOPTestEjb_Server -setdefaultaction "Default_TC" 
-addmember Démo:maMéthodeSpéciale -addrule "1?clienthost=\'localhost\'?TC_A_IIOP_003"
[Version 6.0.1 and later] Créez une classe de travail JMS. Pour les classes de travail JMS, le format est <bus>:<destination>?<bust>:<destination> (pour deux entrées).
wsadmin.sh -lang jython -f workclassoperations.py -appname A 
-wcname ClasseTravailJMS1 -type JMS -wctype ASP -webmodule
microwebmodule.war -setdefaultaction "Default_TC" -addmember 
bus1:destination1
wsadmin.sh -lang jython -f workclassoperations.py -appname MdbAA 
-wcname ClasseTravailJMS2 -type JMS -wctype ASP -ejbmodule MDBAA
-ejbNameMDBAA  -setdefaultaction "Default_TC"  -addmember 
bus1:destination2



Related reference
Règles de routage des classes de travail

Rubrique Référence    

Conditions d'utilisation | Commentaires Dernière mise à jour le : Mar 16, 2006 9:55:50 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. All Rights Reserved.
Ce centre de documentation s'appuie sur la technologie Eclipse. (http://www.eclipse.org)