Utilizando editores para plataformas e aplicativos
Use editores para trabalhar com seus projetos de plataforma, projetos de aplicativos, projetos de ligação de aplicativos e projetos de pacotes configuráveis do CICS após criá-los.
Os editores de descrição de plataforma, de aplicativo e de ligação de aplicativos são abertos automaticamente após a criação de um projeto desse tipo. Para abrir o editor de manifest do pacote configurável após criar um projeto de pacote configurável do CICS, ou abrir qualquer um dos editores posteriormente, acesse a visualização Explorador de Projetos na perspectiva de Nuvem do CICS. Expanda a pasta META-INF para o projeto e dê um clique duplo em qualquer um dos arquivos .xml para o pacote configurável, exceto o arquivo manifest.xml. Como uma alternativa para o clique duplo, é possível clicar com o botão direito no arquivo e clicar em Abrir Com, em seguida, selecione o nome do editor. Quando o editor é aberto, a guia do nome do editor exibe o nome da plataforma, aplicativo, ligação de aplicativos ou pacote configurável do CICS.
Se você não tem um sistema de backup com versão que possibilita reverter para uma versão anterior dos projetos, em vez de editar os projetos existentes diretamente, você pode preferir copiá-los para outro projeto e depois editar as novas cópias.
Quando você trabalhar com projetos para aplicativos, verifique se o projeto do CICS Platform para a plataforma de destino está presente em sua área de trabalho local, pois o CICS Explorer requer este projeto para validar os seus aplicativos e ligações de aplicativos.
Erros e aviso durante o processo de edição são exibidos na janela do editor principal, na guia Problemas na perspectiva ou no campo de status no ambiente de trabalho.
Para inverter uma ou mais das mudanças antes de salvá-las, use a função Desfazer. No menu do ambiente de trabalho, clique em
ou pressione Ctrl+Z (cmd+Z para OS X).Ao concluir suas atualizações no pacote configurável de aplicativos, pacote de ligação de aplicativos ou pacote configurável do CICS, sempre atualize os números de versão maior, menor ou micro para o pacote configurável de acordo com a sua política de designação de versão. O CICS valida os números de versão quando você instala um aplicativo na plataforma, e você deve atualizar os números de versão para o pacote configurável do aplicativo e ligação de aplicativos sempre que atualizar os pacotes configuráveis do CICS para o aplicativo. Pacotes configuráveis de plataforma não usam controle de versão. Para obter informações sobre versão, consulte Controle de Versão.
Para salvar suas mudanças, clique no ícone Salvar ou pressione Ctrl+S (cmd+S para OS X). Se você tentar fechar o editor sem salvar as mudanças, um diálogo será exibido perguntando se deseja salvar suas mudanças ou fechar sem salvar.
Quando tiver salvo suas mudanças, exporte a plataforma ou aplicativo para o diretório inicial da plataforma em zFS. Selecione a ação de exportação da guia Visão Geral do editor para abrir o assistente de exportação. Um aplicativo, sua ligação de aplicativos e seus pacotes configuráveis do CICS associados são exportados juntos como um único processo. O novo número de versão é usado como parte do nome do diretório, assim, as versões anteriores dos pacotes configuráveis permanecem no diretório inicial da plataforma.
Para instalar a plataforma ou aplicativo no CICSplex, você precisará de uma nova definição de recurso PLATDEF ou APPLDEF que aponte para a plataforma ou diretório do aplicativo correto no diretório inicial da plataforma. Para criar essa definição de recurso durante o processo de exportação, selecione a caixa de opção no assistente de exportação.
Depois de ter instalado um aplicativo no CICSplex, será possível visualizá-lo no editor do descritor de aplicativo on-line. Esse editor pode ser usado para ativar, desativar ou desativar e descartar o aplicativo instalado e para visualizar seus recursos particulares. Para trabalhar com um aplicativo instalado, acesse a visualização Cloud Explorer na perspectiva CICS Cloud. No CICSplex onde a plataforma está localizada, selecione a versão do aplicativo instalado e dê um clique duplo no nome do aplicativo, ou clique com o botão direito no nome do aplicativo e, em seguida, clique em Abrir.
Editor do descritor de plataforma
Use o editor do descritor de plataforma para trabalhar com pacotes configuráveis da plataforma que ainda não foram instalados em um CICSplex. Após uma plataforma estar instalada e ativa, é possível usar menus na perspectiva de Nuvem do CICS para incluir ou remover regiões do CICS individuais em tipos de região, e é possível incluir ou remover pacotes configuráveis do CICS que são implementados com a plataforma. No entanto, não é possível modificar os tipos de região em uma plataforma instalada, portanto, use o editor do descritor de plataforma para finalizar seus tipos de região antes de instalar o pacote configurável da plataforma. Se você editar um pacote configurável de plataforma para uma plataforma que já esteja instalada, você deve parar, descartar, reinstalar e reinicializar a plataforma para implementar as mudanças.
O editor do descritor de plataforma tem três guias: Visão geral, Tipos de região e Implementação. A seção Ações na guia Visão Geral explica um processo para editar o projeto de plataforma e tem links para os assistentes e guias para executar cada tarefa.

- Mudar o ID, a descrição ou o diretório inicial de plataforma para a plataforma.
- Incluir e remover tipos de região para a plataforma. A guia de Visão Geral tem funções básicas para criar novos tipos de região ou adotar tipos de região de uma topologia existente. Para modificar os tipos de região e trabalhar com as regiões CICS dentro delas, use a guia Tipos de Região. Clicar duas vezes no nome de um tipo de região irá levá-lo àquele tipo de região na guia Tipos de Região.
- Incluir e remover pacotes configuráveis do CICS que são implementados com a plataforma. Para editar qualquer um desses pacotes configuráveis do CICS, dê um clique duplo no nome do pacote configurável na lista no editor do descritor de plataforma para abrir o editor de manifest do pacote configurável.

- Incluir e remover tipos de região para a plataforma. É possível criar novos tipos de região ou adotar tipos de região de uma topologia existente.
- Criar novas definições da região CICS em tipos de região criados.
- Especificar ou editar as propriedades básicas para definições de região CICS em tipos de região criados.
- Incluir e remover definições da região CICS em tipos de região criados e compartilhá-las entre tipos de região criados. Qualquer definição de região do CICS órfã que não esteja atualmente em um tipo de região é exibida no topo da lista. Selecione a região para incluí-la em um tipo de região.
Use a guia Implementação do editor do descritor de plataforma
para mapear os pacotes configuráveis do
CICS
que são implementados com a plataforma
para os tipos de região na plataforma. Use o botão alternar para alternar entre trabalhar com os tipos de região e trabalhar com os pacotes configuráveis do CICS.

Editor do descritor de aplicativo e editor de manifest de pacote configurável
Use o editor do descritor de aplicativo e o editor de manifest do pacote configurável para atualizar seus aplicativos. O Atualizando Aplicativos descreve o processo a seguir para atualizar um aplicativo e implementar a nova versão do aplicativo em sua plataforma. Você também deve atualizar a ligação de aplicativos ao atualizar o aplicativo. Verifique se o projeto Plataforma CICS para a plataforma de destino está presente em sua área de trabalho local antes de começar a trabalhar com um aplicativo ou ligação de aplicativos.
O editor do descritor de aplicativo tem uma única guia: a guia Visão geral. A seção Ações na guia Visão Geral possui links para assistentes que podem ser usados para criar novos pacotes configuráveis do CICS ou uma ligação de aplicativo para o aplicativo e exportar o aplicativo e a ligação de aplicativos para o diretório inicial da plataforma.

- Mudar o ID, a descrição ou o número da versão para o aplicativo.
- Incluir e remover pacotes configuráveis do CICS para o aplicativo.
- Acessar o editor de manifest do pacote configurável para atualizar pacotes configuráveis do CICS para o aplicativo.
- Acessar o editor de manifest do pacote configurável para atualizar pontos de entrada do aplicativo.
Para atualizar um pacote configurável do CICS ou ponto de entrada do aplicativo, dê um clique duplo em seu nome na lista no editor de aplicativos para abrir o editor de manifest do pacote configurável. O editor de manifest do pacote configurável possui três guias: Visão Geral, Pontos de Entrada e Escopos de Política. É possível usar o editor de manifest do pacote configurável para criar novas definições de recurso no pacote configurável do CICS, remover definições de recurso do pacote configurável do CICS, incluir e remover dependências em recursos importados, criar e editar pontos de entrada de aplicativos e definir escopos de política. Também é possível acessar editores de recurso para editar recursos existentes que são definidos no pacote configurável do CICS. Lembre-se de incrementar o número da versão para o pacote configurável do CICS quando suas atualizações estiverem completas.
Ao editar um pacote configurável do CICS ou um ponto de entrada do aplicativo (que é definido em um pacote configurável do CICS) para o aplicativo, e aumentar o número da versão para o pacote configurável do CICS, o CICS Explorer marca a antiga versão com um erro no editor de aplicativos. Remova a versão antiga do pacote configurável do CICS do pacote configurável do aplicativo selecionando-a e clicando em Remover no editor de aplicativos. Inclua o pacote configurável do CICS atualizado no pacote configurável do aplicativo clicando em Incluir no editor de aplicativos e selecionando a nova versão do pacote configurável do CICS da lista de pacotes configuráveis do CICS que estão disponíveis em sua área de trabalho.
Quando concluir todas as atualizações para o aplicativo e os pacotes configuráveis do CICS associados, lembre-se de atualizar os números de versão maior, menor ou micro para o pacote configurável do aplicativo para refletir o nível de mudanças que você fez, conforme descrito em Controle de Versão.
Editor do descritor de ligação de aplicativos
Use o editor do descritor de ligação de aplicativos para atualizar as informações de implementação de seus aplicativos. O Atualizando Aplicativos descreve o processo a seguir para atualizar um aplicativo e uma ligação de aplicativos e para usar a ligação de aplicativos para implementar a nova versão do aplicativo em sua plataforma. Verifique se o projeto Plataforma CICS para a plataforma de destino está presente em sua área de trabalho local antes de começar a trabalhar com um aplicativo ou ligação de aplicativos.
O editor do descritor de ligação de aplicativos tem duas guias: a guia Visão geral e a guia Implementação. A lista de ações na guia Visão Geral tem links para os assistentes que podem ser usados para criar pacotes configuráveis do CICS para implementar com a ligação de aplicativo e exportar o aplicativo e a ligação de aplicativo para o diretório inicial da plataforma.

- Mude o ID, a descrição ou o número da versão para a ligação de aplicativos.
- Mude a plataforma ou aplicativo que é referenciado pela ligação de aplicativos.
- Inclua e remova pacotes configuráveis do CICS que são implementados com a ligação de aplicativos.
- Acesse o editor de manifest do pacote configurável para atualizar os pacotes configuráveis do CICS que são implementados com a ligação de aplicativos.
- Acesse o editor de definição de política para atualizar as políticas definidas em pacotes configuráveis referenciados pela ligação de aplicativos.
Para atualizar um pacote configurável do CICS, clique duas vezes no nome do pacote configurável na lista de pacotes configuráveis do CICS no editor do descritor de ligação de aplicativos para abrir o editor de manifest do pacote configurável. Para atualizar uma política em um dos pacotes configuráveis referenciados, dê um clique duplo no nome da política na lista de políticas no editor do descritor de ligação de aplicativos para abrir o editor de definição de política. Ao atualizar um pacote configurável do CICS, remova a versão antiga do pacote configurável do CICS do pacote configurável de ligação de aplicativos e inclua a nova versão, da mesma maneira usada para o editor de aplicativos.


- Todo pacote configurável do CICS que ainda não estiver ligado a nenhum tipo de região será marcado com a letra X. Trabalhando com os pacotes configuráveis do CICS, selecione cada novo pacote configurável do CICS e use as caixas de opção para especificar os tipos de região em que ele deve ser implementado.
- Quaisquer tipos de região especificadas na ligação de aplicativos, mas que não podem ser encontradas na versão atual do projeto da plataforma associada à ligação de aplicativo, são marcadas com um ponto de exclamação. Verifique se você está trabalhando com a versão correta do projeto da plataforma e visualize o projeto da plataforma no editor do descritor de plataforma para verificar os tipos de região. Se você tiver removido o tipo de região da plataforma, ou mudado para uma plataforma que não inclua o tipo de região, limpe o projeto de ligação de aplicativos. Trabalhando com os tipos de região, selecione cada tipo de região não desejado e limpe as caixas de seleção para todos os pacotes configuráveis do CICS especificados para esse tipo de região.
Ao concluir todas as atualizações para a ligação de aplicativos e os pacotes configuráveis do CICS associados, lembre-se de atualizar os números de versão maior, menor ou micro para o pacote configurável da ligação de aplicativos para refletir o nível de mudanças que você fez, conforme descrito em Controle de Versão.
Controle de Versão
Você gerencia diferentes versões dos aplicativos usando o controle de versão. Cada pacote configurável do CICS, pacote configurável de aplicativo e ligação de aplicativos tem um ID e informações de versão para identificá-lo exclusivamente. A versão usa os identificadores principal, secundário e micro, portanto, é possível indicar a significância de uma mudança e gerenciar dependências entre os pacotes configuráveis. Esse conceito é chamado versão semântica e é obtido do OSGi Alliance. Embora seu foco sejam pacotes Java™, é possível usar os mesmos princípios para aplicar os pacotes configuráveis em geral.
A versão semântica fornece uma maneira de incrementar as partes principal, secundária ou micro de uma versão para indicar a compatibilidade ou a incompatibilidade com versões anteriores de um pacote configurável. Por exemplo, correções de bug podem incrementar a parte micro da versão, as mudanças compatíveis incrementam a parte secundária da versão e mudanças incompatíveis incrementam a parte principal da versão. Para obter mais informações sobre versão semântica, consulte o White Paper técnico do OSGi Alliance, Versão semântica.
Você deve aplicar uma política de designação de versão aos seus pacotes configuráveis do CICS, aos pacotes configuráveis do aplicativo e às ligações de aplicativos para implementar e gerenciar atualizações no ambiente do CICS. Você não pode usar uma versão existente de um pacote configurável do aplicativo para implementar novas versões dos pacotes configuráveis do CICS para o aplicativo e não pode usar uma versão existente de uma ligação de aplicativos com uma nova versão de um pacote configurável do aplicativo. Você deve atualizar as versões do pacote configurável do aplicativo e da ligação de aplicativos sempre que atualizar os pacotes configuráveis do CICS para o aplicativo.
Quando você altera a versão de um aplicativo, de acordo com os princípios de versão semântica, a nova versão deve refletir a maior mudança em um pacote configurável do CICS que é incluído no aplicativo. Por exemplo, você pode alterar um pacote configurável do CICS para um aplicativo da Versão 1.0.1 para a Versão 1.0.2, que é uma mudança de versão micro, e alterar outro pacote configurável do CICS para o aplicativo da Versão 1.2.0 para a Versão 1.3.0, que é uma mudança de versão secundária. O pacote configurável do aplicativo que inclui esses dois pacotes configuráveis do CICS deve, portanto, ter uma mudança de versão secundária, de modo que se o aplicativo estava antes na Versão 2.5.1, ele deve mudar para a Versão 2.6.0.
O número da versão para a ligação de aplicativos não precisa ser o mesmo do número da versão para o aplicativo associado. No entanto, de acordo com os princípios de versão semântica, você deve atualizar o número da versão para a ligação de aplicativos para refletir a maior mudança no aplicativo ou nos pacotes configuráveis do CICS implementados com a ligação de aplicativos.
Editor do descritor de aplicativo on-line
Use o editor do descritor de aplicativo on-line para visualizar aplicativos que estão instalados em uma plataforma. Não é possível fazer mudanças no formato do aplicativo instalado usando este editor.
O editor de aplicativos on-line tem três guias: Visão Geral, Recursos Privados e Atributos. A seção Ações na guia Visão Geral tem links para as outras guias.

- É possível disponibilizar a versão do aplicativo para os responsáveis pela chamada por meio de seus pontos de entrada do aplicativo usando os botões Disponibilizar e Tornar Indisponível nesta guia.
- É possível ativar, desativar ou descartar a versão do aplicativo usando os botões Ativar e Desativar nesta guia.
- A opção para descartar a versão do aplicativo está disponível como uma seleção a partir do botão Desativar.

