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:
- O componente CICS TS Feature Pack for Dynamic Scripting V2.0 do z/OS está completamente instalado e configurado.
- O usuário entende como criar e implementar pacotes configuráveis no CICS.
- O CICS Explorer SDK é iniciado e as seguintes conexões são estabelecidas:
- Uma conexão CMCI para o CICSPlex no
qual a sua região de destino CICS é
definida.
- Uma conexão FTP do z/OS® com o sistema z/OS apropriado, com autoridade de acesso suficiente.
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
- 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
- No CICS Explorer SDK, clique em .
- Na janela "Selecionar um assistente", expanda Exemplos do CICS e PHP.
- Selecione Exemplo de Script Dinâmico CICS (PHP) e clique em Avançar. Uma segunda janela será exibida mostrando os projetos que foram criados.
- 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.
- 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.
- 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.
- 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.