Criando e implementando uma política em um projeto de pacote configurável do CICS

Uma política é uma definição XML que contém uma ou mais regras de política. Uma regra de política descreve a ação a ser aplicada a um sistema CICS ou a uma tarefa de usuário individual quando a condição especificada é atendida. Uma política é criada em um projeto de Pacote Configurável do CICS e é possível definir uma ou mais políticas em um projeto de Pacote Configurável do CICS. Empacotando suas políticas dessa maneira, é possível implementar políticas como uma única entidade no CICS, facilitando a atualização e o gerenciamento de políticas no CICS.

Antes de Iniciar

Para criar e implementar uma política, deve-se ter um projeto de pacote configurável do CICS existente. Para obter informações adicionais, consulte Criando um Projeto de Pacote Configurável do CICS.

Sobre Esta Tarefa

O CICS suporta regras do sistema e de tarefa. Uma regra do sistema monitora e controla o funcionamento geral de um sistema CICS e uma regra de tarefa monitora e controla uma tarefa de usuário individual. Cada regra de política define as condições que devem ser atendidas antes da execução de uma ação automatizada. Cada política pode definir uma ou mais regras, e uma ou mais políticas podem se aplicar a um sistema ou a uma tarefa do usuário individual do CICS.
Nota: Embora as regras do sistema e de tarefa possam ser definidas na mesma política, você deverá definir os dois tipos de regra em políticas separadas se desejar implementar qualquer política que defina regras de tarefa com um aplicativo CICS.
Níveis de escopo para regras de tarefa
As políticas que definem as regras de tarefa podem ser implementadas nos seguintes níveis de escopo:
Nível de região
As regras se aplicam a todas as tarefas do usuário executadas na região especificada.
Nível de plataforma
As regras aplicam-se a todas as tarefas de usuário para qualquer aplicativo CICS implementado na plataforma especificada.
Nível do aplicativo
As regras se aplicam somente às tarefas do usuário do aplicativo especificado e não a outras tarefas do usuário que podem ser executadas na mesma plataforma.

Para políticas que definem regras de tarefa implementadas na região ou no nível do aplicativo, é possível restringir ainda mais o escopo para tarefas do usuário específicas, definindo escopos de política. Para obter informações adicionais, consulte Definindo Escopos de Política.

Níveis de escopo para regras do sistema
As políticas que definem as regras do sistema podem ser implementadas nos seguintes níveis de escopo:
Nível de região
As regras aplicam-se a todas as tarefas (sistema ou usuário) na região especificada, que fazem mudanças de estado do sistema ou do recurso.
Nível de plataforma
As regras aplicam-se a todas as tarefas (sistema ou usuário) em todas as regiões da plataforma especificada que fazem mudanças de estado do sistema ou do recurso.

As políticas que definem as regras do sistema não podem ser implementadas no nível do aplicativo.

Procedimento

Para criar uma política em um projeto de pacote configurável do CICS:

  1. Selecione a pasta pai de um projeto de pacote configurável do CICS a partir da visualização Explorador de Projetos.
  2. Abra o assistente Novo projeto de uma das seguintes maneiras:
    • No menu principal do ambiente de trabalho, clique em Arquivo > Novo > Outros. Em seguida, expanda a pasta Recursos do CICS, selecione Definição de política e clique em Avançar.
    • Clique com o botão direito no projeto de pacote configurável do CICS e, em seguida, clique em Novo > Definição de política.
  3. Crie uma política que contenha a regra de política:
    Dica: Para criar rapidamente uma regra de política de um arquivo local ou recurso de classe de transação do CICS, navegue para a visualização de recursos correspondente e clique com o botão direito do mouse no recurso para o qual deseja criar uma política. Selecione Criar política e, em seguida, o tipo de regra que deseja criar.
    1. No campo Nome do arquivo, insira o nome do arquivo de política, por exemplo, policy_rules.
    2. Clique em Concluir. Isso abre o editor de definição de política. Para obter informações adicionais, consulte O editor de definição de política.
  4. Opcional: Na seção Informações gerais na guia Visão geral, é possível inserir uma descrição no campo Descrição, uma tag de usuário no campo Tag do usuário ou ambos. Uma tag do usuário é um identificador de 1 a 8 caracteres definido pelo usuário que é incluído em qualquer evento emitido para regras definidas em uma política. Ele pode ser um número de versão, um código de departamento ou as iniciais do autor da política, ou seja, qualquer coisa que ajude a associar um evento à política que solicita o evento.
  5. Crie uma regra no editor de definição de política:
    1. Na guia Visão geral, clique em Novo.
    2. Na caixa de diálogo Nova regra, insira um nome para a regra, selecione um tipo de regra na lista e, opcionalmente, insira uma descrição para a regra.
    3. Clique em OK. Isso abre a guia Regras.
  6. Na seção Condições na guia Regras, defina as condições que acionam a ação automatizada ao serem atendidas. As regras do sistema e de tarefa suportam diferentes tipos de condições; para obter mais informações, consulte Condições de Política.
    Nota: A liberação mais antiga do CICS que suporta uma regra específica é exibida no canto inferior direito da seção Condições. Assegure-se de que ela seja igual ou menor que a liberação do CICS para a qual essa política será implementada. Para obter informações adicionais, consulte Versão do esquema de política.
  7. Selecione uma ação a ser executada quando as condições definidas forem atendidas:
    • Emitir uma mensagem. O CICS emite uma mensagem para o log do CICS quando a condição especificada é atendida. Para regras de tarefa, DFHMP3001 ou DFHMP3007 são emitidos. Para regras do sistema, DFHMP3009 ou DFHMP3010 são emitidos.
    • Emitir um evento. Especifique um adaptador de processamento de eventos (EP) ou um conjunto de adaptadores de processamento de eventos para que o CICS emita um evento para um único adaptador de processamento de eventos ou para todos os adaptadores em um conjunto de adaptadores de processamento de eventos. Os adaptadores de processamento de eventos convertem os dados do evento para um formato de saída adequado e roteiam o evento para os consumidores de eventos definidos. Para obter mais instruções, consulte Escolhendo um recurso de adaptador de EP e Escolhendo um recurso de conjunto de adaptadores de EP.
      Guia Ação na guia Regras do editor de definição de política
      Opcionalmente, para distinguir os eventos emitidos por regras de política do mesmo tipo, especifique o nome do evento da seguinte maneira. Se nenhum nome de evento for especificado, um nome padrão será usado.
      • De 1 a 32 caracteres de comprimento.
      • Os caracteres aceitáveis são: 0-9 A-Z a-z _
      • Deve começar com um caractere alfabético e não deve começar com caracteres XML em nenhum caso.
      Opcionalmente, para transferir dados imutáveis para o consumidor de eventos, associe os itens de dados estáticos ao evento clicando em Incluir. Qualquer regra pode conter, no máximo, 479 itens de dados estáticos. Defina cada item de dados estáticos como um par nome-valor da seguinte maneira:
      Para nomes de dados estáticos:
      • De 1 a 32 caracteres de comprimento.
      • Os caracteres aceitáveis são: 0-9 A-Z a-z _
      • Deve começar com um caractere alfabético e não deve começar com caracteres EPFE, MPFE ou XML em nenhum caso.
      • Deve ser exclusivo dentro de uma regra.
      Para valores de dados estáticos:
      • De 1 a 255 caracteres de comprimento.
      • Os caracteres aceitáveis são os seguintes, incluindo espaços integrados:

        0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

      Nota: Se a ação de evento for especificada para uma regra de política, será possível exportar as especificações do evento como um esquema ou um copybook para uso em outro lugar. As definições de itens de captura de dados estáticos estão incluídas no arquivo exportado e, caso um nome de evento seja especificado, ele será usado como o prefixo do nome do arquivo exportado. Para obter instruções, veja Exportando especificações de evento de uma política.
    • Somente para regras de tarefa: Encerrar tarefa de forma anormal. Se desejar que o CICS finalize uma tarefa em execução quando o limite especificado for ultrapassado, selecione a opção Encerrar tarefa de forma anormal com o código de encerramento anormal. O CICS também emite uma mensagem (DFHMP3002 ou DFHMP3008) para o log do CICS quando uma tarefa é finalizada. O código de encerramento anormal padrão é AMPB, mas é possível sobrescrevê-lo para especificar outro código para a finalização anormal de tarefa.
  8. Opcional: Inclua mais regras, seguindo as etapas 5 até 7.
  9. Para salvar a política, clique em Arquivo > Salvar.

Para implementar uma política em um projeto de pacote configurável do CICS:

As políticas que definem as regras do sistema podem ser implementadas em uma região CICS ou com uma plataforma CICS, mas não podem ser implementadas com um aplicativo CICS. Políticas que definem regras de tarefa podem ser implementadas em uma região independente do CICS, com uma plataforma CICS ou com um aplicativo CICS.

  1. Implemente a política usando um dos métodos a seguir:
    • Para implementar a política para uma região CICS independente:
      1. Exporte o projeto de pacote configurável do CICS que define a política para o zFS. Para obter mais informações sobre como implementar pacotes configuráveis CICS no zFS, consulte Implementando um pacote configurável do CICS.
      2. Defina, instale e ative um recurso BUNDLE do CICS para o pacote configurável do CICS. É possível criar e instalar uma definição BUNDLE abrindo a visualização Definições de pacote configurável. Para obter mais informações sobre recursos de pacote configurável, consulte Recursos BUNDLE na documentação do produto CICS TS V5.4.0.
    • Para implementar a política em uma plataforma, inclua o pacote configurável do CICS que contém a política em uma plataforma:
      • Se a plataforma ainda não estiver implementada, inclua o pacote configurável do CICS que define a política na definição de plataforma da seguinte forma, para que ele seja implementado durante a implementação da plataforma:
        1. Localize o projeto de pacote configurável da plataforma em sua área de trabalho, expanda a pasta META-INF para o projeto de pacote configurável e dê um clique duplo no arquivo bundles.xml ou no arquivo platform.xml. O editor do descritor de plataforma é aberto. Para obter mais instruções sobre como usar o editor do descritor de plataforma, consulte O editor do descritor de plataforma.
        2. Clique em Incluir na seção Pacotes Configuráveis do CICS, na guia Visão Geral.
        3. Na lista de pacotes configuráveis do CICS disponíveis em sua área de trabalho, selecione o pacote configurável do CICS que define a política.
      • Se a plataforma estiver ativa, siga estas etapas:
        1. Exporte o projeto de pacote configurável do CICS para o diretório inicial da plataforma no zFS. Para obter informações adicionais, consulte Implementando um pacote configurável do CICS.
        2. Inclua o pacote configurável do CICS que define a política para a plataforma ativa, usando o diálogo da operação ADDBUNDLE da visualização Cloud Explorer. Para obter informações adicionais, consulte Incluindo um pacote configurável do CICS em uma plataforma.
    • Para implementar a política com um aplicativo CICS, inclua o pacote configurável do CICS que define a política no aplicativo, da seguinte forma:
      1. Localize o projeto de pacote configurável do aplicativo em sua área de trabalho, expanda a pasta META-INF para o projeto de pacote configurável e dê um clique duplo no arquivo application.xml ou no arquivo bundles.xml. O editor do descritor de aplicativo é aberto. Para obter mais instruções sobre como usar o editor do descritor de aplicativo, consulte O editor do descritor de aplicativo.
      2. Clique em Incluir na seção Pacotes Configuráveis do CICS, na guia Visão Geral.
      3. Na lista de pacotes configuráveis do CICS disponíveis em sua área de trabalho, selecione o pacote configurável do CICS que define a política.

Resultados

Uma política é criada no projeto de pacote configurável do CICS e implementada.