Use a ferramenta de script wsadmin para configurar os adaptadores de recurso Java™ 2 Connector com arquivos RAR (Resource Adapter Archive). Um arquivo RAR fornece as classes e outro código para suportar um adaptador de recurso para acesso a um EIS (enterprise information system) específico, como o Customer Information Control
System (CICS). Configure adaptadores de recursos
para um EIS apenas depois de instalar o arquivo RAR apropriado.
Antes de Iniciar
Um arquivo RAR, que geralmente é chamado conector Java
Connector Architecture (JCA), deve estar em conformidade com a Especificação
JCA 1.5 e 1.6. Para que os adaptadores de recurso suportem o JCA Versão 1.6, existe um suporte incluído para anotações
Java nos módulos RAR. Para obter informações adicionais sobre suporte a anotações e
metadados, consulte o tópico, suporte a JCA 1.6 para obter anotações em módulos RAR.
Atenda a estes requisitos usando uma ferramenta de montagem suportada (conforme
descrito no artigo Ferramentas de Montagem) para montar uma coleta de arquivos Java Archive
(JAR), outros componentes executáveis, classes de utilitários, etc., em um arquivo RAR implementável. Em seguida, você estará pronto
para instalar o arquivo RAR no servidor de aplicativos.
Existem duas maneiras de concluir esta tarefa. Este tópico utiliza o objeto AdminConfig para instalar adaptadores de recursos.
Ou então, é possível usar o script installJ2CResourceAdapter da biblioteca de scripts AdminJ2C para instalar um adaptador de recursos J2C em sua configuração, como demonstra o seguinte exemplo:
AdminJ2C.installJ2CResourceAdapter(“myNode", "C:\temp\jca15cmd.rar", "J2CTest")
A biblioteca de scripts fornece um conjunto de procedimentos para automatizar as funções de administração mais comuns. É possível executar
cada procedimento de script individualmente, ou combinar diversos procedimentos para
desenvolver rapidamente novos scripts.
Procedimento
- Ative o script wsadmin. Consulte o artigo do tópico Iniciando o Cliente de Script wsadmin, para obter informações adicionais.
- Identifique o ID de configuração do nó no qual o adaptador de recursos
está instalado, conforme demonstra os seguintes exemplos:
Saída do exemplo:
mynode(cells/mycell/nodes/mynode|node.xml#Node_1)
- Identifique os atributos opcionais.
O objeto J2CResourceAdapter
não requer argumentos específicos. Utilize o seguinte comando para exibir
os atributos opcionais para o objeto J2CResourceAdapter:
A seguir é exibida a saída de comando que exibe cada atributo opcional e o tipo de dados
para o atributo, e denota os atributos padrão:
Attribute Type Default
name String
description String
classpath String
nativepath String
providerType String
isolatedClassLoader boolean false
archivePath String
threadPoolAlias String Default
singleton boolean false
hACapability ENUM RA_NO_HA
isEnableHASupport boolean false
propertySet J2EEResourcePropertySet
jaasLoginConfiguration JAASConfigurationEntry
deploymentDescriptor Connector
connectionDefTemplateProps ConnectionDefTemplateProps
activationSpecTemplateProps ActivationSpecTemplateProps
j2cAdminObjects J2CAdminObject
adminObjectTemplateProps AdminObjectTemplateProps
j2cActivationSpec J2CActivationSpec
properties Property
- Configure os atributos de interesse.
Determine os atributos a serem
configurados para o adaptador de recursos J2C. Nos exemplos a seguir, os comandos configuram o caminho de arquivo
RAR para a variável rarFile e o nome e opções de configuração de descrição para a variável
option:
- Crie um adaptador de recursos.
Utilize o comando
installResourceAdapter para o objeto AdminConfig para instalar o adaptador de recursos com as
opções de configuração anteriormente configuradas, conforme demonstram os seguintes exemplos:
Utilizando Jacl:
$AdminConfig installResourceAdapter $rarFile mynode $option
Utilizando Jython:
AdminConfig.installResourceAdapter(rarFile, 'mynode', option)
Saída do exemplo:
RAR1(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)
- Salve as alterações na configuração. Consulte o tópico Salvando Mudanças na Configuração com a Ferramenta wsadmin, para obter informações adicionais.
- Apenas em um ambiente de implementação de rede, sincronize o nó. Consulte o tópico Sincronizando Nós com a Ferramenta wsadmin, para obter informações adicionais.