Implementando o aplicativo de exemplo CICS TS Feature Pack for Dynamic Scripting V2.0

O CICS TS Feature Pack for Dynamic Scripting V2.0 fornece um aplicativo de exemplo que pode ser implementado para verificar se a instalação foi bem-sucedida, e ajuda a entender como é possível começar a desenvolver e implementar aplicativos PHP.

Antes de Iniciar

Antes de implementar o aplicativo de exemplo, as seguintes condições devem ser atendidas:

Sobre Esta Tarefa

O CICS TS Feature Pack for Dynamic Scripting V2.0 inclui duas áreas funcionais: O componente CICS TS Feature Pack for Dynamic Scripting V2.0 do z/OS, que é instalado em seu sistema host utilizando SMP/E e a função que é instalada no CICS Explorer SDK que inclui a definição da plataforma de destino PHP e o assistente de exemplo PHP. O feature pack fornece um aplicativo de exemplo que pode ser implementado para verificar se a instalação foi bem-sucedida, além de ajuda a entender como é possível começar a desenvolver e implementar aplicativos PHP. O aplicativo de exemplo é implementado usando o CICS Explorer SDK. O componente do z/OS deve ser totalmente instalado e configurado antes da implementação do aplicativo de amostra.

Procedimento

  1. Siga as instruções em Configurando o ambiente de destino do CICS TS Feature Pack for Dynamic Scripting V2.0 para configurar o "CICS TS Runtime com o PHP" como sua plataforma de destino no CICS Explorer SDK
  2. No CICS Explorer SDK, clique em Arquivo > Novo > Exemplo.
  3. Na janela "Selecionar um assistente", expanda Exemplos do CICS e PHP.
  4. Selecione Exemplo de Script Dinâmico CICS (PHP) e clique em Avançar. Uma segunda janela será exibida mostrando os projetos que foram criados.
  5. Clique em Concluir. Três projetos são criados:
    • Um pacote configurável OSGi com suporte ao Web 3.0, nomeado com.ibm.cics.server.examples.php.web. Esse pacote configurável contém os arquivos a seguir para manipular as solicitações do PHP:
      • Um Ativador de amostra é fornecido com CICSPHPInitialiser.getInstance().activate(context) declarado no método start( ), para que esse pacote configurável possa ser registrado no mecanismo PHP.
      • Um MANIFEST.MF configurado para incluir a dependência do Servlet 3.0 jar, JCICS jar e PHP jar.
      • Um web.xml configurado para utilizar PHPServlet para manipular solicitações do PHP.
      • O php.ini padrão. É possível atualizá-lo de acordo com seus requisitos.
      • A amostra index.php e a imagem, que permitem que a API JCICS repita as informações de APPLID da região para HTML.
    • Um projeto do Aplicativo OSGi, denominado com.ibm.cics.server.examples.php.app, que contém o pacote configurável OSGi com suporte ao Web 3.0 denominado com.ibm.cics.server.examples.php.web. Esse projeto pode ser exportado como um arquivo eba para implementá-lo.
    • Um Projeto de Pacote Configurável CICS, denominado com.ibm.cics.server.examples.php.bundle, que contém um recurso EBABUNDLE, que faz referência a projeto com.ibm.cics.server.examples.php.app. Esse projeto é implementado no DFH$PHP do servidor JVM do Liberty de amostra.
    É possível visualizar os pacotes configuráveis na área de janela Package Explorer.
  6. Clique com o botão no Projeto de Pacote Configurável do CICS denominado com.ibm.cics.server.examples.php.bundle e clique em Exportar Projeto de Pacote Configurável para o UNIX File System do z/OS para exportá-lo para o zFS.
  7. Defina e instale um recurso BUNDLE que referencie o projeto de pacote configurável do CICS que é exportado na etapa 6. Para obter detalhes, consulte o tópico da ajuda Implementando Pacotes Configuráveis OSGi em um Servidor JVM do CICS Explorer SDK.
  8. Acesse a URL http://hostname:port/com.ibm.cics.server.examples.php.web, onde hostname e port são o nome do host e a porta definidos em seu servidor JVM do Liberty.

Resultados

Uma tela é exibida em seu navegador, contendo o texto "Seu Exemplo de Script Dinâmico (PHP) do CICS agora está em execução na Região CICS APPLID", em que APPLID é o APPLID da região CICS. Para obter mais informações, consulte Implementando Pacotes Configuráveis OSGi em um Servidor JVM.