Usando Editores para Plataformas, Aplicativos e Políticas

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 plataforma, aplicativo e ligação de aplicativos se abrem automaticamente após você criar um projeto desse tipo. Para abrir o editor de manifesto 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.

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 reverter uma ou mais das mudanças antes de salvá-las, use a função Desfazer. No menu do ambiente de trabalho, clique em Editar > Desfazer ou pressione Ctrl-Z.

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 O ícone Salvar ou pressione Ctrl-S. 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.

Editor de Plataforma

Use o editor 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. Porém, não é possível modificar os tipos de região em uma plataforma instalada, assim, use o editor de plataforma para finalizar seus tipos de região antes de instalar o pacote configurável de 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 de plataforma tem três guias, Visão Geral, Tipos de Região e Implementação. A lista de ações na guia Visão Geral explica um processo para editar o projeto de plataforma e tem links com os assistentes e guias para executar cada tarefa.

A guia Visão Geral do editor de plataforma mostra o ID, a descrição e o diretório inicial para a plataforma, os tipos de região na plataforma e os pacotes configuráveis de CICS que são implementados com a plataforma. As ações que podem ser executadas na plataforma são listadas.
Use a guia Visão Geral do editor de plataforma para estas tarefas:
  • Alterar o ID, descrição ou diretório inicial de plataforma para a plataforma.
  • Incluir ou 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 ou remover pacotes configuráveis do CICS que são implementados com a plataforma. Para editar qualquer um desses pacotes configuráveis do CICS, clique duas vezes no nome do pacote configurável na lista no editor de plataforma para abrir o editor de manifesto de pacote configurável.
A guia Tipos de Região do editor de plataforma mostra os tipos de região na plataforma e as definições de região do CICS em tipos de região criados. Os tipos de região adotados são marcados como Adotados. Se um tipo de região for selecionado, a guia mostrará as propriedades e opções avançadas para o tipo de região. Se uma definição de região de CICS for selecionada, a guia mostrará os atributos da definição de região do CICS e os tipos d região que incluem a região.
Use a guia Tipos de Região do editor de plataforma para estas tarefas:
  • Incluir ou 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 de região do CICS em tipos de região criados.
  • Especificar ou editar as propriedades básicas para as definições de região do CICS em tipos de região criados.
  • Incluir e remover definições de região do CICS em tipos de região criados e compartilhá-los 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.
O editor de plataforma não se conecta ao CICSplex de destino, assim, não é possível usá-lo para incluir, remover ou compartilhar regiões do CICS em tipos de região adotados. Somente é possível trabalhar com definições de região do CICS em tipos de região criados.

Use a guia Implementação do editor 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 alternarO botão alternar para alternar entre trabalhar com os tipos de região e trabalhar com os pacotes configuráveis do CICS.

A guia Implementação do editor de plataforma mostra os tipos de região na plataforma e os pacotes configuráveis do CICS que são implementados com a plataforma. Os tipos de região estão na primeira coluna, e os pacotes configuráveis do CICS estão na segunda coluna.
Selecione cada pacote configurável do CICS e use as caixas de opção para especificar os tipos de região nos quais ele deve ser implementado. Quaisquer pacotes configuráveis do CICS que ainda não estão ligados a nenhum tipo de região são sinalizados com um erro.

Editor de Aplicativos e Editor de Manifesto do Pacote Configurável

Use o editor de aplicativos e o editor de manifesto 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.

O editor de aplicativos tem uma única guia, a guia Visão Geral. A lista de ações na guia Visão Geral tem links com os assistentes que podem ser usados para cariar novos pacotes configuráveis de CICS ou uma ligação de aplicativo para o aplicativo e exportar o aplicativo e a ligação do aplicativo para o diretório inicial da plataforma.

A guia Visão Geral do editor de aplicativos mostra o ID, versão e descrição para o aplicativo, os pacotes configuráveis CICS que serão instalados como parte do aplicativo e os pontos de entrada definidos pelos pacotes configuráveis CICS referenciados. As ações que podem ser executadas no aplicativo estão listadas.
Use a guia Visão Geral do editor de aplicativos para essas tarefas:
  • Alterar o ID, descrição ou número de versão para o aplicativo.
  • Incluir e remover pacotes configuráveis do CICS no aplicativo.
  • Acessar o editor de manifesto do pacote configurável para atualizar os pacotes configuráveis do CICS para o aplicativo.
  • Acessar o editor de manifesto 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 manifesto do pacote configurável. O editor do manifesto do pacote configurável tem três guias, Visão Geral, Pontos de Entrada e Escopos de Política. É possível usar o editor de manifesto 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 aumentar o número da versão para o pacote configurável do CICS quando concluir suas atualizações.

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 de Ligação de Aplicativos

Use o editor de ligação de aplicativos para atualizar as informações de implementação para os 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.

O editor 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.

A guia Visão Geral do editor de aplicativos mostra o ID, versão e descrição para a ligação de aplicativos, os pacotes configuráveis do CICS que serão instalados como parte do aplicativo e as políticas definidas pelos pacotes configuráveis do CICS referenciados. As ações que podem ser executadas na ligação de aplicativos estão listadas.
Use a guia Visão Geral do editor de ligação de aplicativos para essas tarefas:
  • Alterar o ID, descrição ou número da versão para a ligação de aplicativos.
  • Alterar a plataforma ou aplicativo que é referenciado pela ligação de aplicativos.
  • Incluir ou remover pacotes configuráveis do CICS que são implementados com a ligação de aplicativos.
  • Acessar o editor de manifesto do pacote configurável para atualizar pacotes configuráveis do CICS que são implementados com a ligação de aplicativos.
  • Acessar o editor de manifesto do pacote configurável para atualizar políticas para o aplicativo.

Para atualizar um pacote configurável do CICS ou uma política, clique duas vezes no nome do pacote configurável ou política na lista no editor de ligação de aplicativos para abrir o editor de manifesto do pacote configurável. Ao atualizar um pacote configurável ou uma política do CICS, remova a antiga versão do pacote configurável do CICS do pacote configurável de ligação de aplicativos e inclua a nova versão, da mesma maneira como para o editor de aplicativos.

Use a guia Implementação do editor de ligação de aplicativos para mapear os pacotes configuráveis do CICS para o aplicativo referenciado e também os pacotes configuráveis do CICS que são implementados com a ligação de aplicativos, para os tipos de regiões na plataforma de destino. Use o botão alternarO botão alternar para alternar entre trabalhar com os tipos de região e trabalhar com os pacotes configuráveis do CICS.
A guia Implementação do editor de aplicativos mostra os tipos de região na plataforma e os pacotes configuráveis do CICS para o aplicativo e a ligação de aplicativos. Os tipos de região estão na primeira coluna, e os pacotes configuráveis do CICS estão na segunda coluna.
  • 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 está trabalhando com a versão correta do projeto da plataforma e visualize o projeto da plataforma no editor 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 indesejado e desmarque 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 as mudanças nos aplicativos usando 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 White Paper Técnico sobre Versão Semântica.

Você deve aplicar uma política de designação de versão aos seus pacotes configuráveis do CICS e aos pacotes configuráveis de gerenciamento para implementar e gerenciar atualizações no ambiente do CICS. Não é possível usar uma versão existente de um pacote configurável de aplicativo para instalar novas versões dos pacotes configuráveis do CICS para o aplicativo e nem usar uma versão existente de uma ligação de aplicativos com uma versão nova de um pacote configurável de aplicativo. Você deve atualizar o pacote configurável do aplicativo e a ligação de aplicativos sempre que atualizar os pacotes configuráveis do CICS para o aplicativo.

Quando você altera a versão de um pacote configurável de gerenciamento, 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 esteja incluído no pacote configurável de gerenciamento. 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 pacote configurável do aplicativo estava antes na Versão 2.5.1, ele mude 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.