Exportando especificações de evento de uma política

Se uma ação de regra de política precisar emitir um evento, será possível exportar as especificações desse evento como um esquema ou um copybook a ser usado em outro local.

Antes de Iniciar

Uma política do CICS com ação de regra definida como Emitir um evento é necessária. Para obter instruções, veja Criando e implementando uma política em um projeto de pacote configurável do CICS.

Sobre Esta Tarefa

Os arquivos exportados contêm o formato dos dados de evento, úteis para processar dados capturados com seus programas ou mecanismos de processamento de dados.

O formato de dados especificado pelo seu adaptador de EP escolhido ou pelo adaptador de EP em seu conjunto de adaptadores de EP escolhido determina se o arquivo exportado é um esquema ou um copybook:
  • Para um formato XML, como evento de base comum, REST de evento de base comum, Decision Server Insights Event ou WebSphere Business Events, o arquivo exportado é um arquivo .xsd de definição de esquema XML. Os adaptadores a seguir podem emitir eventos em formatos de caracteres XML:
    • Adaptador de HTTP
    • O adaptador da Fila de TD
    • Adaptador da Fila de TS
    • Adaptador do IBM® MQ Queue
  • Para um formato não XML, isto é, formato de evento simplificado do CICS, o arquivo exportado será um arquivo de copybook COBOL .cpy. Os adaptadores a seguir podem emitir eventos no formato de evento simplificado do CICS:
    • O adaptador da Fila de TD
    • Adaptador da Fila de TS
    • Adaptador do IBM MQ Queue
Nota: Não é possível exportar especificações de evento para um adaptador de início de transação ou para um adaptador customizado.

Procedimento

  1. Na guia Regras do editor de definição de política, navegue até a seção Ação.
    Guia Ação na guia Regras do editor de definição de política
  2. Certifique-se de que a ação Emitir um evento esteja selecionada com um adaptador de processamento de eventos ou um conjunto de adaptadores de processamento de eventos especificado.
  3. Clique em Exportar especificações de eventos.
  4. Será solicitado que você escolha um adaptador ou um conjunto de adaptadores em qualquer um dos seguintes casos:
    • Em sua área de trabalho, mais de um adaptador de processamento de eventos possui o mesmo nome que o adaptador especificado ou que um adaptador no conjunto de adaptadores de processamento de eventos especificado.
      Escolha a janela Adaptador de Processamento de Eventos
    • Em sua área de trabalho, mais de um conjunto de adaptadores de processamento de eventos têm o nome do conjunto adaptador especificado.
      Escolha a janela Conjunto de Adaptadores de Processamento de Eventos
  5. Na janela Exportar Especificações de Evento para Regra, certifique-se de especificar as informações corretas nos campos correspondentes: A janela Exportar Especificações de Evento para Regra
    Exportar
    A regra de política para a qual deseja exportar especificações de evento.
    Para Diretório
    O diretório local no qual deseja salvar as especificações do evento exportado.
    Formato dos Dados

    O formato de dados especificado em seu adaptador de EP ou em um adaptador de EP em seu conjunto de adaptadores de EP.

    Este campo é exibido quando o CICS Explorer não é capaz de determinar o formato de dados, pois o adaptador de EP, o conjunto de adaptadores de EP ou um adaptador de EP em um conjunto de adaptadores de EP não está em sua área de trabalho.

    Nota: Certifique-se de que as informações de formato de dados correspondem àquelas especificadas em seus adaptadores EP, caso contrário, falhas podem ocorrer ao usar os arquivos exportados para o processamento de dados.
    Versão

    A versão da região CICS que emitirá o evento, ou seja, a região na qual a política será implementada.

    Este campo é exibido quando a regra de política se aplica ao CICS TS 5.3 e anterior.

  6. Clique em OK.
  7. Se uma especificação de evento exportado com o mesmo nome já existir no diretório especificado, você será perguntado se deseja sobrescrever o arquivo existente ou cancelar a exportação.

Resultados

Um ou mais arquivos são criados no diretório especificado para a regra de política. Os exemplos na seguinte tabela mostram arquivos criados para eventos diferentes nos quais nenhum nome de evento é especificado.

Se um nome de evento for especificado, ele será usado como prefixo do nome do arquivo exportado. Por exemplo, se um nome de evento de event_name for especificado no primeiro exemplo, o arquivo de saída será nomeado event_name_dsie_CICS_54.xsd. Para obter instruções sobre como definir nomes de eventos, consulte Criando e implementando uma política em um projeto de pacote configurável do CICS.
Tabela 1. Arquivos de especificações de evento exportados para eventos diferentes
Adaptadores ou conjuntos de adaptadores de processamento de eventos Regra de política Versão formato de Dados Especificações de evento exportadas
Adaptador do IBM MQ Queue Uma regra de sistema de status aberto de arquivo V54 Formato de evento do Decision Server Insights (XML) Um arquivo de esquema XML chamado fileEnable_rule_dsie_CICS_54.xsd, que pode ser usado na ferramenta IBM Operational Decision Manager Insight Designer para ajudar a definir um evento.
Adaptador de fila TD ou TS Uma regra de tarefa de solicitações de armazenamento V51 - 53 Formato REST de evento de base comum (XML) Um arquivo de esquema XML chamado cics_policy_event_payload_cbe_CICS_51-53.xsd, que pode ser importado no IBM Business Monitor para definir um evento de entrada.
V54 Um arquivo de esquema XML chamado task_rules_payload_cbe_CICS_54.xsd, que você pode importar no IBM Business Monitor para definir um evento de entrada.
Adaptador do IBM MQ Queue Uma regra de sistema de status aberto de arquivo V54 Formato CICS Flattened Event Um copybook COBOL chamado DFHMPFEO_CICS_54.cpy, que você pode usar para processar dados em seus próprios programas consumidores de eventos.
Um conjunto de adaptadores de processamento de eventos que possui:
  • um adaptador de fila TD ou TS (formato CICS Flattened Event)
  • Um adaptador de fila do IBM MQ (Formato do WebSphere Business Events (XML))
Uma regra de sistema de status aberto de arquivo V54

Formato CICS
Flattened Event Formato do WebSphere Business Events (XML)

Dois arquivos denominados DFHMPFEO_CICS_54.cpy e fileEnable_rule_wbe_CICS_54.xsd, que você pode usar em seus programas e na ferramenta IBM Operational Decision Manager Event Designer.