Configurando Novos Adaptadores de Recurso J2C Utilizando Script wsadmin

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

  1. Ative o script wsadmin. Consulte o artigo do tópico Iniciando o Cliente de Script wsadmin, para obter informações adicionais.
  2. Identifique o ID de configuração do nó no qual o adaptador de recursos está instalado, conforme demonstra os seguintes exemplos:
    • Utilizando Jacl:

      set node [$AdminConfig getid /Cell:mycell/Node:mynode/]
    • Utilizando Jython:

      node = AdminConfig.getid('/Cell:mycell/Node:mynode/')
      print node
    Saída do exemplo:
    mynode(cells/mycell/nodes/mynode|node.xml#Node_1)
  3. 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:

    • Utilizando Jacl:

      $AdminConfig defaults J2CResourceAdapter
    • Utilizando Jython:

      print AdminConfig.defaults('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
  4. 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:

    • Utilizando Jacl:

      [AIX Solaris HP-UX Linux Windows]
      set rarFile c:/currentScript/cicseci.rar
      set option  {-rar.name  RAR1 -rar.desc "New resource adapter"} 
      [z/OS][IBM i]
      set rarFile /currentScript/cicseci.rar
      set option {-rar.name  RAR1 -rar.desc "New resource adapter"}
    • Utilizando Jython:

      [AIX Solaris HP-UX Linux Windows]
      rarFile = 'c:/currentScript/cicseci.rar'
      option  = '[-rar.name  RAR1 -rar.desc "New resource adapter"]'
      [z/OS]
      rarFile = '/currentScript/cicseci.rar'
      option  = '[-rar.name  RAR1 -rar.desc "New resource adapter"]'
  5. 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)
  6. 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.
  7. 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.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_jcadapter
Nome do arquivo: txml_jcadapter.html