Gerando Stubs de Chamada COBOL

É possível usar o gerador de stub de chamada COBOL para criar um stub de chamada Java™ para chamar um programa COBOL. Inclua a chamada de stub em um aplicativo em lote baseado em Java.

Antes de Iniciar

Leia o tópico Visão geral do contêiner COBOL.

Instale os produtos a seguir, que são necessários para usar o gerador de stub da chamada COBOL:

  • IBM® Rational Application Developer para WebSphere Software, Versão 7.5 ou posterior, que fornece as ferramentas J2EE Connector (J2C)
  • Java Runtime Environment (JRE), Versão 1.6.0 ou posterior

Para verificar se as ferramentas do Java EE Connector (J2C) estão ativadas, inicie o Rational Application Developer, selecione a perspectiva do Java EE e selecione Arquivo > Novo > Outro. Se o assistente J2C estiver disponível, será possível criar um projeto J2C e as ferramentas J2C serão ativadas.

Se a instalação do Rational Application Developer não tiver as ferramentas Java EE Connector (J2C), use o Installation Manager para modificar sua instalação do Rational Application Developer e instale as ferramentas J2C:

  1. Inicie o Installation Manager.
  2. Na página Modificar Pacotes, selecione IBM Rational Application Developer para WebSphere Software > ferramentas J2EE Connector (J2C) > Avançar.
  3. Conclua a instalação das ferramentas J2C.

Sobre Esta Tarefa

É possível executar o gerador de stub de chamada COBOL a partir de uma linha de comandos, uma tarefa Ant ou da interface gráfica do produto Rational Application Developer.

O gerador de stub da chamada COBOL executa as etapas a seguir:

  1. Analisa o programa de origem COBOL.
  2. Gera o código Java para o stub da chamada para chamar o programa COBOL.
  3. Gera o código Java para as ligações de dados para o parâmetro de entradas e o valor de retorno que são utilizados pelo programa COBOL. O programa de origem é tido como sendo um programa COBOL válido que foi analisado e compilado por um compilador COBOL.

As classes de ligação de dados Java para os parâmetros COBOL e o valor de retorno são gerados pela ferramenta de ligação de dados J2C, que faz parte das ferramentas Java EE Connector do produto Rational Application Developer. Quando você executa o gerador de stub da chamada COBOL a partir de uma linha de comandos, o gerador de stub da chamada e a ferramenta de ligação de dados são executados em uma sessão do Eclipse sem interface com o usuário. A sessão do Eclipse sem interface com o usuário é ativada como um processo Java separado. Quando você executa o gerador de stub da chamada COBOL a partir da interface gráfica, o gerador de stub da chamada e a ferramenta de ligação de dados são executados dentro da sessão do Rational Application Developer ativa.

Procedimento

  1. Crie um projeto do Rational Application Developer para o código gerado.
  2. Verifique a instrução PROCEDURE no arquivo de origem COBOL.
    A instrução PROCEDURE deve ser listada no arquivo de origem COBOL, não em um copybook incluído pelo arquivo de origem. Se o gerador de stub da chamada não localizar a instrução PROCEDURE no arquivo de origem COBOL, o gerador de stub da chamada falhará com um erro:
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Impossível localizar a instrução PROCEDURE no arquivo COBOL_source_file
    Além disso, a instrução PROCEDURE não deve conter nomes de parâmetros duplicados na cláusula USING. Se a cláusula USING contiver um nome de parâmetro duplicado, o gerador de stub da chamada falhará com um erro:
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      COBOLDataElement duplicado detectado: parameter name
  3. Atualize o arquivo de configuração do gerador de stub da chamada.

    Consulte o tópico sobre o arquivo de configuração do gerador de stub da chamada.

  4. Execute o gerador de stub da chamada COBOL.

    É possível executar o gerador de stub da chamada de três maneiras:

    A partir de uma linha de comandos
    1. Crie um script que chame o gerador de stub da chamada.
    2. Execute o script.
      $ java –jar lib/COBOLCallStubGenerator.jar script_path/Sample01.cbl –configFile csg.properties –callStubPackage my.pkg

    Consulte o tópico sobre como chamar o gerador de stub da chamada a partir de uma linha de comandos.

    A partir de um programa Ant
    1. Defina uma tarefa Ant que chame o gerador de stub da chamada.
    2. Especifique um arquivo de construção Ant, tal como o arquivo CSG.xml que é fornecido com o gerador de stub da chamada COBOL, para executar o gerador de stub da chamada.
    3. Execute o arquivo de construção Ant.

    Consulte o tópico sobre como chamar o gerador de stub da chamada a partir de uma tarefa Ant.

    Na interface gráfica do Rational Application Developer
    1. Configure uma construção Ant no menu Executar > Ferramentas Externas > Configuração de Ferramentas Externas que chama o gerador de stub da chamada.
    2. Especifique se o arquivo de construção Ant, tal como CSG.xml, executa o gerador de stub da chamada.
    3. Execute o arquivo de construção Ant.

    Consulte o tópico sobre como chamar o gerador de stub da chamada a partir de uma interface gráfica.

Resultados

Se a chamada do gerador de stub da chamada for bem-sucedida, o gerador de stub da chamada criará um stub de chamada Java para chamar um programa COBOL.

Com uma chamada de Rational Application Developer sem interface com o usuário, pode resultar em um erro quando o gerador de stub da chamada for executado. A execução do gerador de stub da chamada a partir de uma linha de comandos ou a tarefa Ant usa uma chamada sem interface com o usuário. Examine os logs a seguir para solucionar um erro:
workspace_path/.metadata/.log
O log identifica se os problemas com as ferramentas baseadas em Eclipse, tal como a chamada sem interface com o usuário, não foi iniciada e causou o erro.
user_home/.eclipse/ibm.software.delivery.platform_7.5.0/configuration
Cada chamada sem interface com o usuário pode criar arquivos de log no diretório de configuração. Se os arquivos de log existirem, eles poderão fornecer informações de resolução de problemas sobre o erro.

O que Fazer Depois

Use o stub de chamada Java gerado para chamar um programa COBOL.


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