[z/OS]

Usando Adaptadores Locais Otimizados para Suporte de Entrada

Use essa tarefa quando estiver implementando o suporte aos adaptadores locais otimizados para chamar a entrada para os aplicativos WebSphere Application Server for z/OS Enterprise JavaBeans (EJB).

Sobre Esta Tarefa

Use os adaptadores locais otimizados para fazer chamadas de entrada a partir de um espaço de endereço externo para os aplicativos EJB que são implementados em um servidor WebSphere Application Server for z/OS local e para fazer chamadas de saída a partir de um aplicativo em execução no WebSphere Application Server for z/OS em um programa do servidor que está executando em um espaço de endereço externo. As seguintes etapas descrevem o processo necessário para chamar um aplicativo EJB que é implementado em um servidor WebSphere Application Server for z/OS local usando as interfaces de programação de aplicativo (API) dos adaptadores locais otimizados.

A seguinte ilustração mostra o fluxo quando usar os adaptadores locais otimizados com o Customer Information Control System (CICS). A seguinte ilustração mostra o fluxo quando usar os adaptadores locais otimizados com o Customer Information Control System (CICS).Chamada de entrada do CICS para um aplicativo EJB do servidor de aplicativos

A próxima ilustração é o fluxo quando usar os adaptadores locais otimizados com o Information Management System (IMS). Chamada de entrada IMS legada com o servidor de aplicativos por meio dos adaptadores locais otimizados

Procedimento

  1. Ative o ambiente do servidor. Nessa etapa, ative o suporte para os adaptadores locais otimizados com as variáveis de ambiente do WebSphere no grupo ou célula do daemon do WebSphere Application Server. Isso prepara o WebSphere Application Server para receber solicitações de entrada.
  2. Desenvolva um aplicativo EJB. É possível desenvolver um aplicativo EJB ou preparar um aplicativo existente. Se estiver chamando para ou a partir de um programa Cobol ou C/C++, talvez você queira usar as ferramentas de montagem do IBM® Rational® Application Developer, como Rational Application Developer, para criar uma classe Java™ com os métodos auxiliares getter e setter que correspondem à estrutura de copybook Cobol ou C/C++ e para criar um aplicativo EJB para iniciar com as APIs nativas do adaptador local otimizado.

    Para obter informações adicionais sobre o uso das ferramentas de montagem para converter um copybook Cobol ou uma estrutura C em uma classe do auxiliar de ligação de dados Java, consulte o centro de informações da ferramenta de montagem.

    As ferramentas de montagem são fornecidas com o WebSphere Application Server for z/OS e contêm o arquivo Java archive (JAR) que contém o pacote com.ibm.websphere.ola, com o qual você deverá identificar seu enterprise bean como um destino potencial de uma chamada do adaptador local otimizado. Este pacote contém as classes ExecuteHome e Execute que retém as interfaces abstratas necessárias para chamar o adaptador. Você deve criar um bean de sessão stateless que implementa um método chamado execute(), que aceita uma matriz de byte como entrada e retorna uma matriz de byte como saída e especifica o nome com.ibm.websphere.ola.ExecuteHome para a interface inicial EJB e com.ibm.websphere.ola.Execute para a interface remota. O enterprise bean que você deseja iniciar a partir de um espaço de endereço externo deve incluir um método chamado 'execute' que aceita uma matriz de bytes como entrada e retorna uma matriz de bytes como saída. Esse é o método no qual você recebe o controle quando um espaço de endereço externo usar uma das chamadas da API do adaptador como Chamar ou Enviar Solicitação. O método execute é definido na interface remota, com.ibm.websphere.ola.Execute e contém a lógica de negócios para o aplicativo.

    Atenção: Sua implementação EJB não deve modificar ou aumentar as interfaces home e remotas de forma alguma. As exceções de aplicativo não são suportadas no método execute da interface remota. Se o seu aplicativo tiver que lançar uma exceção, ele deve lançar uma EJBException, que pode opcionalmente quebrar a exceção original encontrada.
  3. Implemente o aplicativo EJB. Depois de ter implementado o aplicativo EJB, você deverá compactá-lo em um arquivo archive corporativo (EAR) e implementá-lo no WebSphere Application Server. Este aplicativo EJB usa as interfaces home e remota fornecidas no pacote com.ibm.websphere.ola. Os enterprise beans desenvolvidos desta maneira são designados a um nome home Java Naming and Directory Interface (JNDI) e são implementados como qualquer outro componente EJB. Para saber mais sobre a instalação do aplicativo, leia o tópico, Instalando Arquivos de Aplicativo Corporativo.
  4. (Opcional) Usar o ambiente CICS. Conclua esta etapa apenas se estiver conectando-se a e usando o Customer Information Control System (CICS). Se você estiver usando o CICS, use essa etapa para ativar os adaptadores na região do CICS para fazer chamadas de saída para os aplicativos EJB que você implementou no seu WebSphere Application Server local. As chamadas de saída são feitas com as APIs nativas de adaptadores locais otimizados. Se não estiver usando o CICS, vá para a próxima etapa.
    Atenção: Certifique-se de que o produto esteja usando um registro do usuário baseado no SAF se você planejar propagar um ID de usuário SAF a partir do WebSphere Application Server for z/OS para o CICS.
  5. (Opcional) Usar o ambiente IMS. Conclua esta etapa se estiver conectando-se a e usando aplicativos IMS.
  6. Registre um espaço de endereço externo. Para os adaptadores locais otimizados fazer uma chamada de entrada para seu grupo de daemon local ou uma célula do WebSphere Application Server, você deverá ligar o espaço de endereço atual ao grupo do WebSphere Application Server e estabelecer atributos de conexão.
  7. Proteja os adaptadores locais otimizados para suporte de entrada.
  8. Faça chamadas de entrada. Dependendo do que você deseja obter e de quais sistemas com os quais está trabalhando, escolha o método que deseja usar para fazer chamadas com as APIs nativas.
    1. Use as APIs nativas do adaptador local otimizado para chamar um bean de sessão stateless e conectar-se a partir de um espaço de endereço externo com o WebSphere Application Server. Nesse método, você inicia um aplicativo EJB a partir de um programa de linguagem nativa externa usando as APIs primitivas e para recuperar a resposta. Esse método foi projetado para aplicativos aos quais deseja mais flexibilidade e onde o comprimento máximo da área de resposta não for conhecido antes da chamada.
    2. Use a API Chamar do adaptador local otimizado para chamar um bean de sessão stateless e conectar-se a partir de um espaço de endereço externo com o WebSphere Application Server. Nesse método, você inicia um aplicativo EJB com a API Chamar a partir de um programa de linguagem nativo externo e para recuperar uma resposta. Esse método foi projetado para exploradores aos quais deseja um caminho simplificado onde o comprimento da área de resposta for conhecido antes da chamada.
    3. Use o adaptador local otimizado para chamar um aplicativo EJB a partir do WebSphere Application Server a partir de um espaço de endereço externo em uma transação iniciada pelo cliente. Nesse método, você inicia uma transação em um ambiente do cliente e chama um aplicativo EJB que está em execução no WebSphere Application Server. A nova transação é propagada para o WebSphere Application Server. Este método é suportado apenas durante a chamada de um ambiente de ativação de transação, como o CICS.
    4. Use o adaptador local otimizado para chamar um aplicativo EJB a partir do WebSphere Application Server enquanto ignora o contexto da transação. Nesse método, você inicia uma transação em um ambiente do cliente e chama um aplicativo EJB que é implementado no WebSphere Application Server e ignora o contexto da transação. Este método é suportado apenas durante a chamada de um ambiente de ativação de transação, como o CICS.
  9. (Opcional) Monitore os adaptadores locais otimizados.

Resultados

Você implementou o suporte aos adaptadores locais otimizados para fazer chamadas de entrada aos aplicativos EJB que são implementados no WebSphere Application Server

Í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_useola_in
Nome do arquivo: tdat_useola_in.html