[z/OS]

Ativando o Ambiente do Servidor para Usar Adaptadores Locais Otimizados

Você deve ativar o servidor de aplicativos para receber solicitações de entrada e saída usando o suporte de adaptadores locais otimizados. Adaptadores Locais Otimizados para z/OS são um conjunto de serviços de chamada (APIs) que fornecem aos aplicativos z/OS nativos a capacidade de fazer chamadas de entrada para enterprise beans do servidor de aplicativos e ativam programas nativos para agirem como um servidor e aceitarem solicitações de aplicativos em execução no WebSphere Applications Server.

Antes de Iniciar

As regiões do WebSphere Application Server que usam adaptadores locais otimizados devem ser executadas em modo de 64 bits. Quando você cria um servidor de aplicativos, ele normalmente é configurado para executar no modo de 64 bits.

Procedimento

  1. Aloque ou selecione uma biblioteca de módulo de carregamento para conter os módulos de carregamento do adaptador local otimizado. Esta biblioteca é usada por aplicativos em execução fora do WebSphere Application Server. Ela pode ser um conjunto de dados particionados ou um PDS-E, e requer aproximadamente 40 trilhas (3390) para reter os módulos do adaptador local otimizado. Nos exemplos subsequentes, esse conjunto de dados é chamado de WAS.OLA.LOADLIB.
  2. Alterne para o diretório profile_root/bin do nó e execute o script copyZOS.sh com a opção OLAMODS:
    cd /wasconfig/azcell/aznodea/AppServer/profiles/default/bin 
    copyZOS.sh  OLAMODS   WAS.OLA.LOADLIB

    O script copyZOS.sh grava os módulos de carregamento do adaptador local otimizado no conjunto de dados especificado após a palavra-chave OLAMODS.

  3. Configure variáveis de ambiente do WebSphere para permitir que o servidor de aplicativos use adaptadores locais otimizados. As variáveis estão descritas no tópico, as variáveis de ambiente dos adaptadores locais Otimizados.

    É necessário configurar estas variáveis para cada servidor de aplicativos independente ou célula de implementação de rede.

    1. Configure a variável WAS_DAEMON_ONLY_enable_adapter para toda a célula para true para permitir que os daemons da célula processem chamadas do adaptador local otimizadas de entrada e de saída. Essa variável deve ser configurada para usar os adaptadores locais otimizados.
    2. Use as variáveis válidas em toda a célula, WAS_DAEMON_ONLY_adapter_max_conn, WAS_DAEMON_ONLY_adapter_max_serv e WAS_DAEMON_ONLY_adapter_max_shrmem para configurar o número máximo de conexões, o número máximo de serviços de saída e a quantidade máxima de memória compartilhada alocada pelo daemon para sessões do adaptador local otimizado.
    3. Use a variável ola_cicsuser_identity_propagate para controlar a propagação de identidades de segurança durante o registro. Esta variável, que pode ser configurada no nível de nó ou célula, deve ser configurada como 1 para permitir que as amostras de adaptadores locais otimizados sejam executadas.
      Importante: Leia as informações sobre a variável ola_cicsuser_identity_propagate no tópico Variáveis de Ambiente de Adaptadores Locais Otimizados para entender as implicações de segurança de configurar esta variável em seu servidor.
    4. Se estiver usando o CICS Link Server e desejar especificar diversos contêineres usando um MappedRecord, configure a variável LinkTaskChanID para o nome do canal que irá reter os contêineres.
    5. Se estiver usando o CICS Link Server e deseja especificar diversos contêineres usando um MappedRecord, configure LinkTaskChanType para o tipo de canal que irá reter os contêineres (CHAR=0|BIT=1). O valor padrão para essa variável é 1.
    É possível usar o console administrativo ou script para configurar estas variáveis. O script olaRar.py descrito na próxima etapa configura a variável WAS_DAEMON_ONLY_enable_adapter para true, mas não altera nenhuma outra variável de ambiente do WebSphere Application Server.
  4. Instale o Resource Adapter Archive, que é o arquivo ola.rar, e crie uma connection factory. Para cada nó de servidor de aplicativos que usa os adaptadores locais otimizados, você também deve instalar o Resource Adapter Archive e criar uma connection factory. O script copyZOS.sh cria um link simbólico para este archive a partir de cada diretório install_root/installableApps do nó de servidor de aplicativos.
    É possível usar o console administrativo ou o script olaRar.py para instalar o adaptador de recursos e criar a connection factory:
    • Para usar o script olaRar.py para instalar o adaptador de recursos e a connection factory, consulte o tópico arquivo de script olaRar.py. Certifique-se de instalar o archive do adaptador de recursos e de criar uma connection factory em cada nó do servidor de aplicativos que manipula conexões do adaptador local otimizado de entrada e de saída.

      Esse script também configura a variável WAS_DAEMON_ONLY_enable_adapter para toda a célula paratrue, mas o script não configura nenhuma outra variável de ambiente do WebSphere para os adaptadores locais otimizados.

    • Para usar o console administrativo para instalar o adaptador de recursos, consulte o tópico Instalar o Resource Adapter Archive (RAR). É possível criar um connection factory no console administrativo no painel Adaptadores de Recursos. Clique no nome de seu adaptador de recursos recém-criado e em Propriedades Adicionais, clique em Connection Factories J2C > Novo. Ao criar a connection factory, o campo-chave que você deve preencher é o nome JNDI.

    Se desejar usar o recurso de alta disponibilidade do adaptador de recursos, deverá configurar propriedades do conjunto de conexões adicionais em cada connection factory. Consulte o tópico, Ativando Suporte de Alta Disponibilidade do Adaptador de Recursos, para obter mais informações sobre como configurar e usar esse recurso.

    Para obter mais informações sobre os connection factories, consulte o tópico Considerações do Connection Factory para adaptadores locais otimizados.

  5. Reinicie o daemon do WebSphere Application Server para colocar estas mudanças em vigor. O reinício do daemon causa a parada de todos os servidores da célula no mesmo sistema z/OS.
    Quando o daemon estiver iniciando, confirme que o adaptador esteja ativo. Uma mensagem no log do daemon indica se o adaptador local otimizado está ativado ou não, da seguinte forma:
    • O suporte está ativado: BBOMOOO1I enable_adapter:1
    • O suporte não está ativado: BBOMOOO1I enable_adapter:0

Resultados

O suporte aos adaptadores locais otimizados agora está ativado.

O que Fazer Depois

Agora é possível implementar e iniciar aplicativos que usam os adaptadores locais otimizadosWebSphere Application Server for z/OS nos nós do servidor de aplicativos ativado.
Para todas as conexões externas que usam os adaptadores locais otimizados, assegure que elas estejam executando a versão mais recente do conjunto de dados OLAMODS para seu nível do WebSphere Application Server:
  1. Execute o script copyZOS.sh com a opção OLAMODS para o conjunto de dados para assegurar que os módulos estejam no nível mais recente. Por exemplo:
    copyZOS.sh  OLAMODS   WAS.OLA.LOADLIB
  2. Certifique-se de que este conjunto de dados esteja disponível para todos os espaços de endereço externos que usam os adaptadores locais otimizados. Por exemplo, certifique-se que ele esteja disponível na STEPLIB para tarefas em lote, na biblioteca DFHRPL para CICS (Customer Information Control System) e nas definições de dados de DFSESL para IMS.

    É possível compartilhar o mesmo conjunto de dados gerado em diferentes clusters; não é necessário ter uma cópia separada para cada cluster.


Í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=tdat_enableconnector
Nome do arquivo: tdat_enableconnector.html