Implementando um pacote configurável do CICS

É possível implementar um pacote configurável do CICS exportando-o diretamente para um sistema de arquivos do z/OS UNIX System Services (z/OS UNIX) a partir do CICS Explorer. Use um recurso BUNDLE para localizar o pacote configurável no zFS e criar dinamicamente os recursos a partir do pacote configurável na região CICS.

Antes de Iniciar

Você deve assegurar que as permissões de arquivo do zFS estejam configuradas para que os pacotes configuráveis exportados a partir do CICS Explorer possam ser gravados no diretório inicial da plataforma ou diretório de destino no zFS e lido por todas as regiões CICS na plataforma, ou a região CICS apropriada.
  • Configure a máscara de criação de modo de arquivo para o daemon FTP do z/OS para assegurar que o proprietário tenha permissões de gravação e que o grupo tenha permissões de leitura. Para configurar isto, use a instrução UMASK no arquivo de configuração FTP.DATA.
  • Opcionalmente, se você também estiver usando entradas da lista de controle de acesso (ACL) do UNIX System Services (USS) para controlar a segurança, assegure que as ACLs padrão sejam herdadas do diretório inicial da plataforma no zFS, por exemplo /var/cicsts/CICSplex/platform1, em que CICSplex é o nome de seu CICSplex e platform1 é o nome de sua plataforma.

Sobre Esta Tarefa

Após criar um pacote configurável do CICS no CICS Explorer, você deverá exportá-lo para um sistema de arquivos z/OS UNIX para torná-lo disponível no CICS. É possível implementar um projeto de pacote configurável do CICS individualmente ou com um pacote configurável de gerenciamento. Por exemplo, se o projeto de pacote configurável fizer parte de um aplicativo a ser implementado em uma plataforma, será possível implementá-lo com o pacote configurável de aplicativos exportando o projeto do aplicativo. O procedimento a seguir descreve como implementar um pacote configurável do CICS individualmente.

Nota: Se você não estiver autorizado a implementar o pacote configurável diretamente em um sistema de arquivos do z/OS, será possível exportar o projeto de pacote configurável do CICS como um arquivo compactado para o seu sistema de arquivos local. Para obter informações adicionais, consulte Exportando um Projeto de Pacote Configurável CICS para seu sistema de arquivos local. No entanto, essa opção não se aplica a um projeto de pacote configurável do CICS que contenha um pacote configurável OSGi.

Procedimento

  1. Navegue para o Explorador de Projetos.
  2. Clique com o botão direito em seu projeto de pacote configurável do CICS e clique em Exportar Projeto de Pacote Configurável para Sistema de Arquivos z/OS UNIX. Agora é possível escolher exportar para o diretório inicial de sua plataforma ou para um local específico no sistema de arquivos.
  3. Clique em um dos botões a seguir para especificar onde exportar o aplicativo:
    • Nota: A caixa de seleção na parte inferior da página controla se sua configuração é lembrada por este projeto.
    • Exportar para o diretório inicial de uma Plataforma. Se você selecionar essa opção, clique em Avançar e, em seguida, conclua as etapas a seguir:
      1. Selecione o aplicativo para exportar (o campo é preenchido com a seleção atual, se aplicável).
      2. Selecione a plataforma de destino para a exportação.
      3. Se deseja substituir variáveis em seu projeto de pacote configurável do CICS com os valores no arquivo variables.properties, selecione a caixa de seleção Resolver variáveis usando o arquivo de propriedades.
      4. Clique em Avançar.
      5. Selecione a conexão do z/OS a usar para a exportação. Ao fazer uma seleção, a conexão é estabelecida e o assistente verifica os subdiretórios dos pacotes configuráveis e aplicativos do diretório inicial da plataforma usando essa conexão.
      6. Clique em Concluir.
    • Exportar para um local específico no sistema de arquivos. Se você selecionar essa opção, clique em Avançar.
  4. No campo Conexão, selecione uma conexão do z/OS adequada com o sistema de arquivos remoto. É possível clicar no ícone de conexão para usar a conexão exibida atualmente ou clicar na seta para selecionar outra ou para criar uma nova conexão. As opções suportadas são a conexão FTP do z/OS, a conexão do z/OS Remote System (RSE) e a conexão do z/OSMF.
    Nota:
  5. No campo Diretório-Pai, especifique o nome de um diretório de sistema de arquivos do z/OS UNIX como um destino para a transferência. Este pode ser um diretório novo ou existente. Ao digitar o nome de uma pasta de diretório, a árvore de diretórios é atualizada e essa pasta, se existir, é mostrada como a raiz. Se você clicar duas vezes em uma pasta, essa pasta torna-se a raiz da árvore. Como alternativa, é possível selecionar a partir da árvore e navegar até o diretório.

    O campo Diretório do Pacote Configurávelmostra o diretório de destino para o pacote configurável exportado. Por padrão, o nome de diretório de pacote configurável usa o ID e a versão do pacote configurável. Se você não tiver especificado um ID ou versão, o nome do pacote configurável será usado. É possível sobrescrever o nome do diretório para alterá-lo.

  6. Opcional: Selecione a caixa de seleção Limpar conteúdo existente do diretório Pacote Configurável para remover quaisquer pastas e arquivos no diretório de destino antes de executar a transferência de arquivos. Se a caixa de seleção não for marcada e uma pasta com esse nome já existir, a exportação não ocorrerá.
  7. Se deseja substituir variáveis em seu projeto de pacote configurável do CICS com os valores no arquivo variables.properties, selecione a caixa de seleção Resolver variáveis usando o arquivo de propriedades.
  8. Clique em Concluir.

Resultados

O projeto de pacote configurável é exportado para o diretório de destino no z/OS UNIX.

Para um projeto OSGi, se um intervalo de versão foi definido quando a referência do pacote configurável OSGi foi incluída no projeto de pacote configurável CICS, a versão mais alta nesse intervalo do projeto OSGi é incluída.

O que Fazer Depois

Defina e ative um recurso BUNDLE para o pacote configurável do CICS. É possível criar uma definição abrindo a visualização Definições de Pacote Configurável. Quando o recurso BUNDLE é ativado, o CICS lê o manifest no diretório de pacote configurável e cria dinamicamente os recursos do CICS. Ele também verifica se qualquer dependência está presente na região CICS. Para obter mais informações sobre recursos de pacote configurável, consulte Recursos BUNDLE na documentação do produto CICS TS V5.4.0.

Nota: Ao criar e implementar seu projeto de pacote configurável do CICS usando CICS Explorer, deve-se assegurar o gerenciamento adequado da origem do projeto. O pacote configurável do CICS não pode ser reconstruído a partir dos dados exportados no zFS e uma falha de sua estação de trabalho pode fazer com que os dados sejam perdidos. É possível usar a função Exportar do CICS Explorer para exportar o projeto e registrá-lo em um sistema de gerenciamento de código-fonte.