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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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:
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.
- 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:
- 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
- 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.