![[z/OS]](../images/ngzos.gif)
Considerações de Connection Factory para Adaptadores Locais Otimizados
Este tópico revisa as considerações para as connection factories ao usar adaptadores locais otimizados.
Uma connection factory deve ser configurada para ativar os adaptadores locais otimizados noz/OS para suporte de entrada e de saída, apesar de ser usado apenas diretamente para saída. Várias connection factories são suportadas. A connection factory pode ter qualquer nome.
Cada connection factory configurada pode ter diferentes configurações associadas a ela. As configurações que podem ser definidas incluem tamanhos do conjunto de conexões e propriedades customizadas.
- Nome de registro
1-12 caracteres alfanuméricos.
Configure esse valor para o nome de registro de destino
- ID do grupo IMS OTMA
1-8 caracteres alfanuméricos.
Configure esse valor para o nome do Information Management System (IMS) Open Transaction Manager Access (OTMA) de destino.Atenção: Esta configuração deve corresponder aos critérios definidos para um nome do grupo OTMA XCF, conforme documentado no centro de informações do IMS. - Nome do servidor IMS OTMA
1-16 caracteres alfanuméricos.
Configure esse valor para o nome do servidor IMS OTMA de destino.
Atenção: Esta configuração deve corresponder aos critérios definidos para um nome do servidor OTMA válido, conforme documentado no centro de informações do IMS. - SyncLevel do IMS OTMA
1 caractere - 0|1
Configure esse valor para 0 (zero) para SyncLevel NONE e 1 para SyncLevel CONFIRM. Se desejar que o IMS confirme o trabalho para uma transação processada, depois de enviar a resposta para o servidor de aplicativos sem receber um reconhecimento positivo de que a resposta foi aceita, selecione None como o nível de sincronização. Se desejar que o IMS confirme a transação somente depois de receber um reconhecimento positivo, selecione Confirm como o nível de sincronização. Se o reconhecimento for negativo, o trabalho em andamento será retrocedido. Observe que todas as chamadas para transações do IMS com OLA sobre OTMA são executadas como SEND_THEN_COMMIT (CM1). Consulte o Centro de Informações do IMS para obter mais informações sobre esses Níveis de Sincronização do OTMA e o processamento de CM1 SEND_THEN_COMMIT.
- Máximo de segmentos do IMS OTMA
Número Inteiro - 1
Configure esse valor para o número máximo de segmentos de mensagens do IMS suportados para enviar para o IMS ou receber do IMS.
- Tamanho de Recebimento Máximo da Mensagem do IMS OTMA
Número Inteiro - 32768
Configure esse valor para o número de tamanho máximo de qualquer mensagem recebida, incluindo todos os segmentos da mensagem.
- RemoteHostname
Sequência de Caracteres
Ao executar em uma plataforma não z/OS, especifica o nome do host no qual a consulta do JNDI do EJB do proxy OLA é direcionada.
- RemotePort
Número Inteiro
Quando estiver executando em uma plataforma não z/OS, especifique o número da porta no host remoto onde a consulta do JNDI do proxy OLA EJB estiver direcionada.
- RemoteJNDIName
Sequência de Caracteres
Ao executar em uma plataforma não z/OS, especifica o nome JNDI no host remoto no qual o EJB do proxy OLA está ligado. O host remoto é especificado pelas propriedades RemoteHostname e RemotePort.
- Nome do Usuário
Sequência de Caracteres
Especifica o usuário que é usado para enviar solicitações a um registro que está em execução com a segurança ativada. O ID do usuário de MVS associado com o nome de usuário é usado. Se não houver ID do usuário do MVS associado ao nome de usuário, nenhuma identidade será enviada na solicitação. Se nenhum nome de usuário for especificado, o ID do usuário do componente de chamada será usado para obter um ID do usuário do MVS.
- Password
Sequência de Caracteres
Especifica a senha para o nome de usuário.
- RemoteJNDIUsername
Sequência de Caracteres
Ao executar em uma plataforma não z/OS, especifica o nome de usuário que é usado para obter o contexto inicial de JNDI no sistema remoto. O contexto JNDI é usado para consultar o EJB do proxy OLA.
- RemoteJNDIPassword
Sequência de Caracteres
Ao executar em uma plataforma não z/OS, especifica a senha a ser usada com o RemoteJNDIUsername.
- RemoteJNDIRealm
Sequência de Caracteres
Ao executar em uma plataforma não z/OS, especifica o domínio de segurança a ser usado com o RemoteJNDIUsername.
- UseCICSContainer
Número inteiro - 0
Ao usar o CICS Link Server, especifica se os dados de solicitação e resposta devem estar em contêineres.
- LinkTaskTranID
Sequência de Caracteres
Quando o CICS Link Server é usado, especifica o ID de transação da tarefa de Link.
- LinkTaskReqContID
Sequência de Caracteres
Ao usar o CICS Link Server, especifica o nome da solicitação ou o contêiner de entrada.
- LinkTaskReqContType
Número Inteiro - 1
Ao usar o CICS Link Server, especifica o tipo do contêiner de solicitação (CHAR=0|BIT=1).
- LinkTaskRspContID
Sequência de Caracteres
Ao usar o CICS Link Server, especifica o nome do contêiner de resposta ou de saída.
- LinkTaskRspContType
Número Inteiro - 1
Ao usar o CICS Link Server, especifica o tipo do contêiner de resposta (CHAR=0|BIT=1).
- ConnectionWaitTimeout
Número inteiro - 30
A duração de tempo, especificada em segundos, para esperar por uma conexão do cliente correspondente para o nome de Registro atual. O espaço do endereço externo já deve ter sido registrado. Esse tempo limite aplica-se ao tempo de espera para que um serviço disponível com o nome do registro correspondente torne-se disponível.
O nome do cliente IMS OTMA, que é automaticamente gerado, tem 16 caracteres e não pode ser configurado com o adaptador de recursos de adaptadores locais otimizados. Para obter informações adicionais sobre o uso de adaptadores locais otimizados no IMS OTMA, consulte o tópico Ativando Adaptadores Locais Otimizados sobre o Suporte do OTMA/IMS.
As configurações do conjunto de conexões para o adaptador definem o número de conexões lógicas definidas no conjunto de conexões do WebSphere Application Server. Esse não é o mesmo que o número de conexões físicas entre o WebSphere Application Server e um espaço de endereço externo. Uma conexão lógica é essencialmente a visualização Java™ EE Connector Architecture (JCA) de uma conexão física, neste caso. As conexões lógicas são usadas por saída de chamada de aplicativos WebSphere para um espaço de endereço externo.
As configurações do conjunto de conexões para o adaptador definem o número de conexões lógicas definidas no conjunto de conexões do WebSphere Application Server. Esse não é o mesmo que o número de conexões físicas entre o WebSphere Application Server e um espaço de endereço externo. Neste caso, uma conexão lógica é basicamente a visualização JCA de uma conexão física.
O balanceamento entre conexões físicas e lógicas depende de quantos encadeamentos de aplicativos do WebSphere devem poder obter uma conexão (lógica), e de quantos pedidos devem poder ser enviados ou recebidos a qualquer momento em ou a partir de um espaço de endereço externo (físico). O número máximo de conexões físicas pode ser configurado para garantir que um espaço de endereço externo não encha o Application Server com solicitações, já que elas são usadas para a comunicação de entrada e de saída com o espaço de endereço externo. Se um espaço de endereço externo tentar se registrar com o WebSphere Application Server e especificar um número de conexões que seja o máximo de conexões físicas suportado para um servidor nesse nó, a solicitação de registro rejeitará o registro com um código de razão que indica uma falha. O registro também pode falhar se o máximo de conexões para o grupo de daemons for excedido. Lembre-se que as conexões físicas são pedidas pelo cliente e não são as mesmas das conexões lógicas passadas pelo adaptador JCA. Quando um pedido de saída é emitido, a conexão lógica JCA é emparelhada com uma conexão física durante o período da interação.
Após criar e salvar os connection factories, você poderá modificar as referências de recursos definidas em diversos módulos de aplicativos e especificar nomes de JNDI (Java Naming and Directory Interface) dos connection factories sempre que apropriado.

O valor do nível de conexão de Segmentos Máximos também pode ser configurado usando o método setOTMAMaxSegments(nnn) na Especificação de Conexão.
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.