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

Gerenciando Classes de Trabalho com Scripts

O script workclassoperations.py pode ser utilizado para gerenciar classes de trabalho.

Uso

A seguir está o uso do script.
Uso: 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]

Opções de Linhas de Comandos

Inclua ou defina uma regra para a classe de trabalho criada
Utilize a opção de linha de comandos -addrule. Não utilize esta opção com as opções deleterule, -listrule ou -getdefaultaction na mesma chamada de comandos. Se você incluir mais de uma regra ao mesmo tempo, liste-as por ordem de prioridade começando do número menor para o número maior na seqüência.
  • 'priority' é a prioridade designada à regra sendo criada. A prioridade é um valor inteiro, por exemplo, 0, 1, 2, 3, etc., sendo que o 0 é a prioridade mais alta.
  • O ponto de interrogação (?) é um separador e é requerido nesta seqüência.
  • 'expr' é a expressão da regra. Consulte Políticas de Roteamento para Classes de Trabalho para obter informações adicionais.
  • 'tipo de ação' é o tipo de ação a ser tomada e que tem valores enumerados permit, permitsticky, reject ou redirect para a política de roteamento. Se você criar uma classe de trabalho de política de serviço, o tipo de ação será o nome da classe de transação.
  • 'action' seu valor depende do tipo de ação. Por exemplo, se o tipo de ação for 'redirect', a ação será a URL redirect. Por exemplo, redirect?http://www.ibm.com. Para o tipo de ação reject, a ação será um código reject. Por exemplo, reject?404. Para classes de trabalho do cluster de servidor genérico, a ação é o nome do cluster de servidor genérico.
Especifique o nome do aplicativo corporativo ou edição de aplicativo
Utilize a opção de linha de comandos -appname appName para especificar o nome do aplicativo corporativo ou da edição de aplicativo sem a extensão .ear.
Forneça uma coleta de padrões de URI para associar com o módulo da Web de classe de trabalho para o aplicativo corporativo.
Utilize a opção de linha de comandos -adduri -addmember para fornecer uma coleta de padrões de URI a serem associados ao módulo da Web da classe de trabalho para o aplicativo corporativo. Os padrões de URI são separados pelo ponto de interrogação (?) e cada padrão de URI deve começar com uma barra (/).
Indique a operação a ser aplicada para as políticas de roteamento e de serviço
Utilize a opção de linha de comandos -both para indicar que a operação -listrule ou -getdefaultaction deve ser aplicada para as políticas de roteamento e de serviço no nome da classe de trabalho fornecida.
Exclua uma regra específica
Utilize a opção de linha de comandos -deleterule para excluir uma regra específica da classe de trabalho especificada utilizando a opção -wcname. Ela não pode ser utilizada com as opções -addrule, -listrule ou -getdefaultaction na mesma chamada de comando.
Exclua uma coleta de padrões de URI da classe de trabalho do módulo da Web
Utilize a opção de linha de comandos -deleteuri -deletemember para fornecer uma coleta de padrões de URI a serem excluídos da classe de trabalho do módulo da Web. Essa opção é aplicável somente às classes de trabalho do aplicativo corporativo.
Exiba o URI do elemento do módulo da Web da classe de trabalho
Utilize a opção de linha de comandos -listuri -listmember para exibir o URI a partir do elemento de módulo da Web da classe de trabalho. Essa opção é aplicável somente em classes de trabalho de aplicativos corporativos.
Exclua uma classe de trabalho
Utilize a opção de linha de comandos -deletewc para excluir uma classe de trabalho. Com essa opção, você também deve especificar a opção de linha de comandos -wctype com um valor ARP (política de roteamento de aplicativo), ASP (Application Routing Policy), GRP (Generic Routing Policy) ou GSP (Generic Server Policy).
Obtenha um tipo de ação padrão e uma ação em uma classe de trabalho definida
Utilize a opção de linha de comandos -getdefaultaction para obter o tipo de ação e a ação padrão definidos na classe de trabalho que é especificada utilizando a opção -wcname. Não utilize essa opção de linha de comandos com as opções -addrule, -delete ou -listrule na mesma chamada de comando.
Exiba as regras definidas na classe de trabalho
Utilize a opção de linha de comandos -listrule para exibir as regras definidas na classe de trabalho. Não utilize essa opção com as opções -addrule, -deleterule ou -getdefaultaction na mesma chamada de comando.
Modifique a ação padrão para a classe de trabalho
Utilize -modifydefaultaction para modificar a ação padrão para a classe de trabalho existente especificada utilizando a opção -wcname e especificando o tipo de ação e a ação.
Especifique o nome do servidor proxy do ODR (On Demand Router)
Utilize a opção de linha de comandos -odrname odrName para especificar o nome do servidor proxy do ODR (On Demand Router).
Especifique o nome do nó do ODR
Utilize a opção de linha de comandos -odrnode odrNode para especificar o nome do nó do ODR.
Especifique uma ação padrão
Utilize a opção -setdefaultaction com o tipo de ação e a ação especificados para criar uma regra com a expressão denotada pelo asterisco (*) e configurar o tipo de ação e a ação com os valores fornecidos com a opção.
Especifique o tipo de pedido
Utilize a opção -type para especificar o protocolo ao qual essa classe de trabalho se aplica. Os valores aceitáveis são HTTP e SOAP. Se a opção -type não for especificada, o padrão de HTTP será assumido.
Especifique o nome do host virtual para o cluster de servidor genérico
Utilize a opção -vhost virtualHost para especificar o nome do host virtual para o cluster de servidor genérico.
Especifique o nome do módulo da Web
Utilize a opção -webmodule webModule para especificar o nome do módulo da Web sem a extensão .jar ou .war.
Especifique o nome da classe de trabalho
Utilize a opção -wcname workClassName para especificar o nome da classe de trabalho. Não são permitidos espaços no nome da classe de trabalho. Essa opção é sempre requerida.
Especifique o tipo de classe de trabalho
A opção -wctype utiliza um valor constante de APP para o aplicativo corporativo ou de GSC para o cluster de servidor genérico ao criar classes de trabalho, pois o tipo de ação padrão, o tipo de ação, é utilizado para diferenciar entre as classes de trabalho da política de roteamento e de serviço. Em operações onde a distinção não é óbvia, ARP, ASP, GRP e GSP são utilizados. Se a opção -deletewc for especificada, os valores aceitáveis serão ARP para excluir a classe de trabalho de roteamento de aplicativos, ASP para excluir a classe de trabalho da política de serviço do aplicativo, GRP para excluir a classe de trabalho da política de roteamento do cluster de servidor genérico e GSP para excluir a classe de trabalho da política de serviço do servidor genérico. Não há padrão, portanto, um valor deve ser especificado.
[Version 6.0.1 and later] Especifique o nome EJB para a classe de trabalho JMS
Utilize a opção -ejbName <myEJBname> para especificar o nome do bean Enterprise JavaBeans no módulo jar EJB.

Exemplo:

A seguir estão alguns exemplos:
Crie uma classe de trabalho de política de roteamento para o aplicativo my_App denominado my_Work_Class. A classe de trabalho aplica-se a todos os URIs com padrão /test1 e /test2/* do módulo da Web my_Web_Module e contém uma regra única que permite pedidos a partir do domínio ibm.com. A ação padrão faz com que todos os outros pedidos sejam rejeitados com o código de erro 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"
Crie uma classe de trabalho do aplicativo corporativo para uma política de roteamento. Sua ação padrão é reject com um código reject 404. Caso esteja emitindo este comando no sistema operacional base do UNIX, a seqüência de escape (\%%) deve ser substituída por (\%).
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"    
Crie uma classe de trabalho de aplicativo corporativo para uma política de serviço. Se estiver emitindo este comando em um sistema operacional de base UNIX, substitua a seqüência de escape (\%%) por (\%).
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" 
Crie uma classe de trabalho para uma política de roteamento com um tipo padrão de HTTP. Seu tipo de ação padrão é permit e a ação é o nome do cluster de servidor genérico para onde os pedidos são roteados.
wsadmin -lang jython -f workclassoperations.py -odrname ODR -odrnode myNode01
-wcname GSCWorkClass  -vhost default_host -wctype GSC -setdefaultaction "permit?myGSC" -adduri -addmember "/test1/*"
Crie uma classe de trabalho par a política de serviço com um tipo padrão de HTTP. Se você estiver emitindo este comando no sistema operacional de base UNIX, a seqüência de escape (\%%) deverá ser substituída por (\%).
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"
Exclua uma regra com prioridade 1 na classe de trabalho CustomWorkClass para uma política de roteamento.
wsadmin -lang jython -f workclassoperations.py -deleterule 1 -wcname CustomWorkClass
 -appname A -wctype ARP"    
Liste as regras na classe de trabalho CustomWorkClass para as políticas de roteamento (opção -both) e de serviço para o aplicativo corporativo A.
wsadmin -lang jython -f workclassoperations.py -listrule -wcname CustomWorkClass
-both -appname A -wctype APP"     
Liste as regras na classe de trabalho CustomWorkClass para as políticas de roteamento (opção -both) e de serviço para o cluster de servidores genéricos.
wsadmin -lang jython -f workclassoperations.py -listrule -wcname CustomWorkClass
-both -odrname ODR -odrnode theTestNode01 -wctype GSC"    
Obtenha ações padrão na classe de trabalho denominada CustomWorkClass para políticas de roteamento (opção -both) e de serviço.
wsadmin -lang jython -f workclassoperations.py -getdefaultaction -wcname CustomWorkClass
-both -appname A -wctype APP"     
Exclua uma classe de trabalho de política de roteamento denominada CustomWorkClass no aplicativo corporativo A.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-appname A -wctype ARP"    
Exclua uma classe de trabalho de política de serviço denominada CustomWorkClass na edição do aplicativo corporativo A.
 wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-appname A -wctype ASP" 
Exclua a classe de trabalho de política de serviço denominada CustomWorkClass no ODR denominado myODR.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-odrname myODR -wctype GSP"   
Exclua uma classe de trabalho de política de roteamento denominada CustomWorkClass no ODR denominado myODR.
wsadmin -lang jython -f workclassoperations.py -deletewc -wcname CustomWorkClass
-odrname myODR -wctype GRP"    
Liste os URIs na classe de trabalho denominada CustomWorkClass para o aplicativo A e o módulo da Web microwebapp.
wsadmin -lang jython -f workclassoperations.py -listuri -listmember -wcname CustomWorkClass
-appname A -webmodule microwebapp"    
Exclua os URIs na classe de trabalho denominada CustomWorkClass para o aplicativo A e o módulo da Web microwebapp. Utilize -wctype ARP ou ASP para distinguir entre as classes de trabalho de políticas de roteamento e de serviço. Se -wctype não for utilizado, a classe de trabalho de política de roteamento será utilizada.
wsadmin -lang jython -f workclassoperations.py -deleteuri  -deletemember "/myURI/help.jsp"
-wcname CustomWorkClass -appname A -webmodule microwebapp"    
Crie uma classe de trabalho do aplicativo corporativo para uma política de roteamento com duas regras adicionais e o padrão. Se você estiver emitindo este comando no sistema operacional de base UNIX, a seqüência de escape (\%%) deverá ser substituída por (\%).
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" 
Inclui URIs em uma classe de trabalho existente denominada CustomWorkClass para o aplicativo A e o módulo da Web microwebapp.
wsadmin -lang jython -f workclassoperations.py -adduri -addmember "/myURI/help.jsp" -wcname
CustomWorkClass -appname A -webmodule microwebapp -wctype ARP"  
Crie uma classe de trabalho SOAP de aplicativo corporativo para uma política de roteamento. Sua ação padrão é reject com um código reject 404. Se você estiver emitindo este comando no sistema operacional de base UNIX, a seqüência de escape (\%%) deverá ser substituída por (\%).
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] Crie uma classe de trabalho IIOP denominada IIOPWorkClass_001 para uma política de serviço que seja mapeada para a classe de transação padrão para todos os EJBs e todos os métodos no módulo de EJB denominado IIOPTestEjb_Server.jar contido no aplicativo denominado MyEjbApplication.
ImportantColonSymbol As classes de trabalho de política de roteamento não são suportadas para IIOP. Somente classes de trabalho de política de serviço são suportadas. Adicionalmente, para especificar mais de um EJB ou método, utilize o seguinte formato: <ejbName>:<ejbMethod>?<ejbName>:<ejbMethod>.

Por exemplo: -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 *:*
Crie uma classe de trabalho IIOP denominada IIOPWorkClass_002 para uma política de serviço que seja mapeada para a classe de transação denominada TC_A_IIOP_002 para o EJB denominado Demo e todos os métodos no módulo do EJB Demo denominado IIOPTestEjb_Server.jar contido no aplicativo denominado MyEjbApplication.
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:*
Crie uma classe de trabalho IIOP denominada IIOPWorkClass_003 para uma política de serviço que seja mapeada para a classe de transação padrão para um EJB denominado Demo e todos os métodos no módulo do EJB Demo denominado IIOPTestEjb_Server.jar contido no aplicativo denominado MyEjbApplication. Se o nome do método for mySpecialMethod e o nome do host do cliente for localhost, mapeie a política de serviço para a classe de transação 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] Crie uma classe de trabalho de JMS. Para classes de trabalho de JMS, o formato deve ser <barramento>:<destino>?<bust>:<destino>Este exemplo é para duas entradas.
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
Políticas de Roteamento para Classes de Trabalho

Tópico de Referência    

Termos de Uso | Feedback Última atualização: Mar 21, 2006 12:46:23 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. Todos os Direitos Reservados.
Este centro de informações é desenvolvido em tecnologia Eclipse. (http://www.eclipse.org)