Especificando Informações do Adaptador EP e do Dispatcher

Você especifica informações na ligação de evento que controlam como o CICS emite os eventos produzidos pela ligação de evento.

Sobre Esta Tarefa

Você usa as informações do dispatcher para definir o que acontece com os eventos criados por essa ligação. Você seleciona o adaptador EP para emitir eventos e, em seguida, seleciona opções relevantes para o adaptador EP.

Procedimento

  1. Clique na guia Adaptador no CICS event binding editor e selecione a opção Usar um adaptador definido aqui, para especificar a configuração de adaptador EP a ser usada para essa ligação de evento, os parâmetros para o adaptador EP e qualquer informação avançada.

    Também é possível escolher usar ou não um recurso EPADAPTER predefinido ou o recurso EPADAPTERSET. Para obter informações adicionais sobre um recurso EPADAPTER predefinido, consulte Editor de Configuração do Adaptador do Processamento de Eventos (EP) no Centro de Informações do CICS TS 5.1. Para obter informações adicionais sobre um recurso EPADAPTERSET predefinido, consulte Editor do Conjunto de Adaptadores do Processamento de Eventos (EP) no Centro de Informações do CICS TS 5.1.

    Se você especificar um recurso EPADAPTER ou EPADAPTERSET predefinido, você deverá inserir o nome no campoNome ou clicar em Escolher para escolher um recurso. Para obter mais informações sobre a escolha de recursos do adaptador, consulte Escolhendo um recurso de adaptador EP no Centro de Informações do CICS TS 5.1 e Escolhendo um recurso de conjunto de adaptadores EP no Centro de Informações do CICS TS 5.1.

  2. Opcional: É possível exportar uma ou mais especificações de eventos nesta ligação de evento.
    Para exportar uma especificação de evento, insira o nome de um recurso EPADAPTER predefinido ou selecione um adaptador de sua escolha:
    • Use o adaptador EP do TSQ EP ou o adaptador EP do WebSphere MQ e escolha o formato CFE para emitir eventos em um formato binário, para que um copybook COBOL .cpy) seja fornecido.
    • Use qualquer outro adaptador EP e formato para fornecer uma definição de esquema XML (.xsd).
    Nota: A Exportação de Especificações do Evento não é suportada se você estiver usando um adaptador Início de Transação. Para obter detalhes sobre o formato de evento baseado no contêiner doCICS, consulte Formatos de Processamento de Eventos no Centro de Informações do CICS TS 5.1.
    1. Clique em Exportar Especificações de Eventos. Se estiver usando um recurso EPADAPTER e sua usar contiver mais de um adaptador com o mesmo nome, você será solicitado a escolher um adaptador de uma lista. A janela Exportar Especificações de Eventos é exibida.
    2. Selecione as especificações de eventos que deseja exportar.
    3. Para exportar as especificações de eventos, especifique o diretório no campo Diretório de Destino.
    4. Se você usar um recurso EPADAPTER predefinido, que não esteja localizado em sua área de trabalho, você deverá selecionar um valor adequado para o campo Formato de Dados.
    5. Clique em Exportar.
    Um arquivo é criado no diretório especificado para cada especificação de evento selecionada.
    Seguem algumas especificações de exemplo:
    • Se você especificar o adaptador EP do WebSphere MQ e o formato do Common Base Event e selecionar duas especificações de eventos chamadas example1 e example2, dois arquivos de esquema XML são criados: example1_CBE.xsd e example2_CBE.xsd. É possível importar esses arquivos de esquema para o IBM® Business Monitor para ajudar a definir um evento de entrada.
    • Se você especificar o adaptador EP do WebSphere MQ e o formato do WebSphere Business Events (XML) e selecionar uma especificação de evento chamada example1, um arquivo de esquema XML é criado, example1_WBE.xsd. É possível utilizar este arquivo de esquema na ferramenta WebSphere Business Events Design Data para ajudar a definir um evento.
    • Se o adaptador HTTP EP e o formato do Common Base Event REST forem especificados, e as duas especificações de eventos chamadas example1 e example2 forem selecionadas, serão criados dois arquivos de esquema XML: example1_CBER.xsd e example2_CBER.xsd. É possível importar esses arquivos de esquema para o IBM Business Monitor para ajudar a definir um evento de entrada.
    • Se o adaptador HTTP EP e o formato WebSphere Business Events (XML) forem especificados e a especificação de evento chamada example1 for selecionada, será criado um arquivo de esquema XML, example1_WBE.xsd. É possível usar esse arquivo de esquema na ferramenta Dados de Design do WebSphere Business Events para ajudar a definir um evento de entrada.
    • Se o adaptador HTTP EP e o formato do Common Base Event forem especificados, e as duas especificações de eventos chamadas example1 e example2 forem selecionadas, serão criados dois arquivos de esquema XML: example1_CBE.xsd e example2_CBE.xsd. É possível importar esses arquivos de esquema para qualquer consumidor que aceite o formato Common Base Event para ajudar a definir um evento de entrada.
    • Se você especificar o adaptador EP da Fila TS e selecionar duas especificações de eventos denominadas example1 e example2, dois copybooks COBOL serão criados: example1.cpy e example2.cpy. É possível utilizar esses copybooks para processar dados em seus próprios programas consumidores de eventos.

    Observe que, se você exportar uma especificação de evento e, em seguida, exportar a mesma especificação de evento novamente ao mesmo diretório, o CICS event binding editor avisa-o para sobrescrever o arquivo existente ou cancelar a operação de exportação.

  3. Escolha o tipo de adaptador EP na lista Adaptador. É possível especificar os seguintes tipos de adaptadores EP:
    Fila de TS
    Emite um recurso para uma fila do CICS TS em um dos formatos XML: Common Base Event, Common Base Event REST ou WebSphere Business Events (WBE); ou em um formato não-XML (CFE). Use esse adaptador EP para validar que os eventos corretos estão sendo capturados com os dados corretos e para emitir eventos para qualquer consumidor que leia de uma fila TS.
    Para a emissão de evento garantido, os eventos síncronos transacionais precisam de uma fila de TS recuperável; os eventos síncronos não transacionais precisam de uma fila irrecuperável. Se as filas de TS são recuperáveis depende das configurações de um TSMODEL correspondente; as filas de TS são recuperáveis apenas quando há um TSMODEL correspondente. Ao utilizar o adaptador de fila TS para eventos de transação síncrona, não é possível emitir um comando DELETEQ TS para a fila TS do evento na unidade de trabalho que captura o evento.
    Início da Transação
    Emite os eventos a uma transação CICS nomeada. Os dados são passados para a transação em um formato de evento baseado em contêiner. É possível especificar o sistema CICS para executar a transação. É possível usar uma transação existente, se os dados do evento não forem necessários.
    O adaptador EP de início da transação não suporta a emissão garantida de eventos.
    Customizado (Gravado pelo Usuário)
    Emite eventos em qualquer formato necessário. Um adaptador EP customizado é um programa CICS que você escreve para fornecer uma combinação de formatação e roteamento de um evento que não é suportado pelos adaptadores EP fornecidos. O adaptador EP customizado não deve executar nenhum outro processamento, como consumo do evento.
    Para a emissão de evento garantido, o adaptador EP customizado deve estar em conformidade com os requisitos de recuperabilidade do evento. Consulte a documentação do adaptador EP customizado para ver se ele suporta eventos síncronos transacionais ou não transacionais.
    Fila de Mensagens do WebSphere
    Emite eventos para uma fila de mensagens do WebSphere em um formato XML para ser consumido pelo WebSphere Business Events, no formato Common Base Event para o IBM Business Monitor ou no formato não XML.
    Para a emissão de evento garantido, a entrega de evento é garantida quando o adaptador EP do WebSphere MQ é usado em combinação com filas de mensagens persistentes do WebSphere .
    HTTP
    Emite eventos para um servidor em conformidade com HTTP 1.1 usando HTTP POST no formato XML para consumo por produtos como WebSphere Business Events e IBM Business Monitor.
    O adaptador EP HTTP não suporta a emissão garantida de eventos transacionais.
  4. Especifique as opções para o tipo de adaptador EP escolhido:
    • Especifique as seguintes opções para o adaptador EP de Filas TS:
      • Especifique o nome da fila CICS . É necessário especificar um nome de fila.
      • Se a sua fila de destino for remota, especifique o ID do sistema.
      • Selecione Utilizar o Armazenamento Temporário Auxiliar, se necessário.
      • Especifique um formato de dados para o evento. Selecione um dos seguintes valores na lista Formato de Dados:
        CICS Flattened Event (Binário)
        Os dados do evento são apresentados no formato não XML.
        WebSphere Business Events (XML)
        Os dados do evento estão no formato XML.
        Common Base Event (XML)
        Os dados do evento estão no formato XML.
        Common Base Event REST (XML)
        Os dados do evento estão no formato XML.
    • Especifique as seguintes opções para o adaptador EP de Início da Transação:
      • Especifique o identificador de transação do aplicativo CICS que é executado como resultado dos eventos. Você deve especificar um ID de transação.
      • Especifique um ID do usuário da transação. A transação iniciada pelo adaptador EP de início de transação é executada usando-se esse ID de usuário.
      • Especifique o ID do sistema, que está disponível apenas para o adaptador EP da Transação. A transação do adaptador EP é executada no sistema CICS com esse ID do sistema.
    • Especifique as seguintes opções para o adaptador EP customizado (gravado pelo usuário):
      • Especifique um dos seguintes:
        • Se o modo de emissão for assíncrono, o ID da transação para o aplicativoCICS gravado pelo usuário formata, roteia e emite o evento. Você deve especificar um identificador de transação para emissão assíncrona pelo adaptador EP customizado.
        • Se o modo de emissão for síncrono, o nome do programa de aplicativos CICS gravado pelo usuário formata, roteia e emite o evento. Você deve especificar um identificador do programa para emissão síncrona pelo adaptador EP customizado.
      • Grave os dados a serem transmitidos ao adaptador EP customizado. Seu adaptador EP Customizado processa esses dados.
    • Especifique as seguintes opções para o adaptador EP do WebSphere MQ:
      • Especifique o nome da fila do WebSphere MQ na qual os eventos emitidos por essa ligação de evento são colocados. É necessário especificar um nome de fila.
      • Especifique se as mensagens são persistentes. Selecione um dos seguintes valores na lista Persistente.
        Não
        As mensagens colocadas na fila pelo adaptador EP do WebSphere MQ são não persistentes.
        Sim
        As mensagens colocadas na fila pelo adaptador EP do WebSphere MQ são persistentes.
        Padrão de Fila
        As mensagens colocadas na fila herdam a persistência padrão da fila nomeada.
      • Especifique uma prioridade da mensagem. É possível selecionar o campo Fila Padrão ou digitar um valor no campo Prioridade, para a prioridade da mensagem do WebSphere MQ, de 0 a 9.
      • Especifique o tempo de expiração. É possível selecionar Nunca Expirar ou digitar um valor para a expiração da mensagem do WebSphere MQ no campo Tempo de Expiração. Esse tempo é expresso em décimos de segundo. Uma mensagem torna-se elegível para descarte se não tiver sido removida da fila de destino antes de esse período decorrer.
      • Especifique um formato de dados para o evento. Selecione um dos seguintes valores na lista Formato de Dados:
        CICS Flattened Event (Binário)
        Os dados do evento são apresentados no formato não XML.
        WebSphere Business Events (XML)
        As mensagens são colocadas na fila no formato XML necessário para o WebSphere Business Events.
        Common Base Event (XML)
        As mensagens são colocadas na fila no formato Common Base Event requerido pelo IBM Business Monitor.
    • Especifique as seguintes opções para o adaptador EP HTTP:
      • Especifique um URIMAP. O nome de um recurso URIMAP que representa a conexão com o servidor compatível com HTTP 1.1.
      • Especifique um formato de dados para o evento. Selecione um dos seguintes valores na lista Formato de Dados:
        Common Base Event REST (XML)
        Os eventos são enviados para um servidor compatível com HTTP 1.1 no formato XML, necessário para o IBM Business Monitor.
        WebSphere Business Events (XML)
        Os eventos são enviados para um servidor compatível com HTTP 1.1 no formato XML, necessário para o WebSphere Business Events.
        Common Base Event (XML)
        Os eventos são enviados para um servidor compatível com HTTP 1.1 no formato Common Base Event, que pode ser consumido por qualquer produto que suporte a Common Event Infrastructure.
  5. Opcional: Especifique quaisquer opções de dispatcher avançadas. Estas opções são para usuários avançados e elas controlam como o adaptador EP é executado em um sistemaCICS.
    Nota: Em geral, é mais eficiente deixar o CICS executar o adaptador EP no encadeamento do dispatcher. No entanto, pode ser necessário que o adaptador EP seja executado como uma transação separada, por exemplo, se você precisar executá-lo com um ID de usuário específico que tenha autoridade para gravar na fila do WebSphere MQ, ou se quiser controlar o número de tarefas simultâneas do adaptador EP, usando as configurações TRANCLASS.
    1. Especifique o modo de emissão. É possível especificar ASYNC ou SYNC para especificar como os eventos serão emitidos. Especifique o modo de emissão síncrono para a emissão de evento garantido. Quando o modo de emissão for síncrono, o adaptador EP do WebSphere MQ emitirá estes eventos:
      • Eventos transacionais usando a opção MQPMO_SYNCPOINT. As mensagens do WebSphere MQ podem ser recuperadas na unidade de trabalho para a transação de captura.
      • Eventos não-transacionais usando a opção MQPMO_NO_SYNCPOINT.

      Quando o modo de emissão for assíncrono, o adaptador EP do WebSphere MQ emitirá eventos usando a opção MQPMO_NO_SYNCPOINT.

      Notas:
      • Para eventos síncronos (emissão de evento garantido), o aplicativo de captura de evento precisa da autoridade de gravação para o transporte de emissão de evento. Para eventos assíncronos, o adaptador EP precisa da autoridade de gravação.
      • Especificar SYNC NONTRANS para o adaptador EP de HTTP transforma a transação de captura em um aplicativo da web que pode precisar ser reconfigurado adequadamente.
      • Configure o atributo DTIMOUT da definição TRANSACTION para qualquer transação que possa potencialmente emitir eventos síncronos através do adaptador EP de HTTP.
    2. Especifique a prioridade de dispatch. É possível especificar a prioridade Normal ou Alta para controlar como o dispatcher de eventos processa os eventos associados com a ligação de evento. Os eventos de alta prioridade são emitidos assim que estejam disponíveis, com base na configuração Eventos são Transacionais. Os eventos de prioridade normal são emitidos assim que estejam disponíveis, com base na configuração Eventos são Transacionais, mas após qualquer evento de alta prioridade pendente.
      Nota: Essa opção não se aplica ao modo de emissão síncrono.
    3. Especifique o ID da transação e o ID do usuário. O adaptador é iniciado com o ID da transação e o ID do usuário especificados. O ID da transação não é relevante para o tipo de adaptador EP Customizado, pois ele é configurado, em vez disso, na seção Adaptador. Dependendo das configurações no ID da transação e no ID do usuário, a tarefa do dispatcher EP inicia ou vincula ao programa do adaptador EP.
      Tabela 1. O ID da Transação e o ID do Usuário para o adaptador WebSphere MQ EP, o adaptador EP da Fila TS e o adaptador EP de Início da Transação
      O ID da Transação é especificado O ID do Usuário é especificado Usar ID do Usuário do Contexto O adaptador EP é O adaptador EP executa usando O ID de transação do adaptador EP é
      x x   Anexado ID do usuário especificado ID da transação especificada
      x   x Anexado ID do Usuário do Contexto ID da transação especificada
        x   Anexado ID do usuário especificado

      CEPQ para o adaptador EP do WebSphere MQ
      CEPT para o adaptador EP da Fila TS
      CEPS para o adaptador EP de Início da Transação

          x Anexado ID do Usuário do Contexto

      CEPQ para o adaptador EP do WebSphere MQ
      CEPT para o adaptador EP da Fila TS
      CEPS para o adaptador EP de Início da Transação

      x     Anexado ID de usuário padrão do CICS ID da transação especificada
            Vinculado ID do usuário da região do CICS Não aplicável
      Se a fila doWebSphere MQ, fila TS ou a transação que deseja iniciar for remota, consulte o para obter informações sobre as configurações de segurança.
      Tabela 2. ID da Transação e ID do Usuário para o adaptador HTTP EP
      O ID da Transação é especificado O ID do Usuário é especificado Usar ID do Usuário do Contexto O adaptador EP é O adaptador EP executa usando O ID de Transação do Adaptador EP é
      x x   Anexado ID do usuário especificado ID da transação especificada
      x   x Anexado ID do Usuário do Contexto ID da transação especificada
        x   Anexado ID do usuário especificado CEPH
          x Anexado ID do Usuário do Contexto CEPH
      x     Anexado ID de usuário padrão do CICS ID da transação especificada
            Anexado ID de usuário padrão do CICS CEPH
      Para o adaptador EP Customizado (Gravado pelo Usuário), que tenha um ID de transação e um modo de emissão assíncrono, a tarefa do dispatcher EP sempre é anexada a esse adaptador, com o ID de usuário especificado ou o ID do usuário do contexto ou o ID do usuário CICS padrão.
      Nota: Essas duas opções não se aplicam ao modo de emissão síncrono.
    4. Especifique se os eventos são transacionais. Selecione a caixa de opção Eventos são Transacionais se quiser que o CICS capture eventos apenas se a unidade de trabalho (UOW) de negócios associada ao evento for concluída com êxito.
      Nota: Considere atentamente se os eventos que são capturados a partir de ações irrecuperáveis devem ser especificados como transitórios. Por exemplo, se você capturar um evento transacional de um comando WEB SEND e a unidade de trabalho for então restaurada, o evento será restaurado, mas o comando WEB SEND poderá ter causado o envio de uma mensagem HTTP.

      Limpe a caixa de opção Eventos são Transacionais se quiser que o CICS processe eventos associados a essa ligação de evento fora de uma transação. Os eventos são emitidos enquanto são produzidos.

Resultados

As informações do adaptador e do dispatcher para sua ligação de evento estão agora completas.