Especificando informações do adaptador de EP e do dispatcher
São especificadas informações na ligação de evento que controlam como o CICS emite os eventos produzidos pela ligação de evento.
Sobre Esta Tarefa
Procedimento
- Clique na guia Adaptador no
Editor de ligação de evento e
selecione a opção Usar um adaptador definido
aqui para especificar a configuração do adaptador de EP a
ser usada para essa ligação de evento, os parâmetros para o adaptador de EP e qualquer informação avançada.
Como alternativa, é possível escolher se deseja usar um recurso EPADAPTER ou EPADAPTERSET predefinido. Para obter mais informações sobre um recurso EPADAPTER predefinido, consulte Editor de configuração do adaptador de processamento de eventos (EP). Para obter mais informações sobre um recurso EPADAPTERSET predefinido, consulte Editor do conjunto adaptador de processamento de eventos (EP)..
Se você especificar um recurso EPADAPTER ou EPADAPTERSET predefinido, insira o nome no campo Nome ou clique em Escolher para escolher um recurso. Para obter mais informações sobre como escolher os recursos do adaptador, consulte Escolhendo um recurso de adaptador de EP e Escolhendo um recurso de conjunto de adaptadores de EP.
- Opcional: É possível exportar uma ou mais especificações de evento nesta ligação de evento.
- Escolha o tipo de adaptador de EP na lista
Adaptador. É possível especificar os seguintes tipos de adaptadores de EP:
- IBM® MQ Fila
- Emite eventos para uma fila de mensagens do IBM MQ em um formato XML para consumo pelo IBM Operational Decision Manager ou IBM Business Monitor ou em formato binário do CICS Flattened Event (CFE) para consumo diretamente do IBM MQ.
- Para a emissão de evento garantido, a entrega de evento será garantida quando o adaptador de processamento de eventos do IBM MQ Queue for usado em combinação com filas de mensagens do IBM MQ persistentes.
- Transaction Start
- 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 de EP de início de transação não suporta a emissão garantida de eventos.
- TS Queue
- Emite eventos para uma fila do CICS TS nomeada em um dos formatos XML: Common Base Event, Common Base Event REST, Decision Server Insights Event ou WebSphere Business Events; ou em um formato não XML (CFE). Use esse adaptador de EP para validar que os eventos corretos estão sendo capturados com os dados corretos e para emitir eventos para qualquer consumidor que leia a partir de uma fila de 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, isso depende das configurações de um TSMODEL correspondente; as filas de TS são recuperáveis apenas quando há um TSMODEL correspondente. Ao usar o adaptador de fila de TS para eventos síncronos de transação, não é possível emitir um comando DELETEQ TS para a fila de TS do evento na unidade de trabalho que captura o evento.
- TD Queue
- Emite eventos para uma determinada fila de dados temporários do CICS em um dos seguintes formatos: evento de base comum, REST de evento de base comum, evento simplificado do CICS (CFE), Decision Server Insights Event e WebSphere Business Event. Use esse adaptador de processamento de eventos ao desenvolver e testar especificações de evento para validar se os eventos corretos estão sendo capturados com os dados corretos e para emitir eventos para qualquer consumidor que leia a partir de uma fila de TD.
- Para a emissão de eventos síncrona, a fila de TD deve ser uma fila intrapartição recuperável para eventos transacionais e uma fila intrapartição irrecuperável ou uma fila de partição extra para eventos não transacionais. O adaptador de processamento de eventos do TDQ pode ser usado para teste, depuração e produção.
- Customizado (Gravado pelo usuário)
- Emite eventos em qualquer formato necessário. Um adaptador de EP customizado é um programa CICS que é escrito para fornecer uma combinação de formatação e roteamento de um evento que não é suportado pelos adaptadores de EP fornecidos. O adaptador de EP customizado não deve executar nenhum outro processamento, como o consumo do evento.
- Para a emissão de evento garantido, o adaptador de EP customizado deve estar em conformidade com os requisitos de recuperabilidade do evento. Consulte a documentação do adaptador de EP customizado para ver se ele suporta eventos síncronos transacionais ou não transacionais.
- HTTP
- Emite eventos para um servidor em conformidade com HTTP 1.1 usando HTTP POST no formato XML para ser consumido por produtos como IBM Operational Decision Manager ou IBM Business Monitor. O adaptador de EP HTTP não suporta a emissão garantida de eventos transacionais.
- Especifique as opções para o tipo de adaptador de EP escolhido:
- Especifique as opções a seguir para o adaptador de processamento de eventos de Fila de IBM MQ:
- Especifique o nome da fila da fila do IBM MQ na qual os eventos emitidos por essa ligação de evento são colocados. Deve-se especificar um nome de fila.
- Especifique se as mensagens são persistentes. Selecione um dos
seguintes valores na lista Persistente.
- Não
- Mensagens colocadas na fila pelo adaptador de processamento de eventos do IBM MQ Queue como não persistentes.
- Sim
- Mensagens colocadas na fila pelo adaptador de processamento de eventos do IBM MQ Queue são persistentes.
- Fila Padrão
- As mensagens colocadas na fila herdam a persistência padrão da fila nomeada.
- Especifique a prioridade da mensagem. É possível selecionar Padrão de fila ou digitar um valor no campo Prioridade, para a prioridade da mensagem do IBM MQ, de 0 a 9.
- Especifique o tempo de validade. É possível selecionar Nunca expirar ou digitar um valor para a expiração da mensagem do IBM MQ no campo Tempo de validade. 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:
- Evento Sequencial do CICS (Binário)
- Os dados do evento são apresentados no formato não XML.
- Common Base Event (XML)
- As mensagens são colocadas na fila no formato de evento de base comum requerido pelo IBM Business Monitor.
- WebSphere Business Events (XML)
- As mensagens são colocadas na fila no formato XML, requerido pelo Componente Decision Server Events do IBM Operational Decision Manager.
- Decision Server Insights Event (XML)
- As mensagens são colocadas na fila no formato XML requerido pelo Componente Decision Server Insights do IBM Operational Decision Manager. Os dados do evento estão no formato XML.
- Especifique as seguintes opções para o adaptador de EP de Início da
Transação:
- Especifique o ID de transação do aplicativo CICS que é executado como resultado dos eventos. Deve-se especificar um ID de transação.
- Especifique um ID do usuário da transação. A transação iniciada pelo adaptador de EP de início de transação é executada usando esse ID de usuário.
- Especifique o ID do sistema, que está disponível apenas para o adaptador de EP da Transação. A transação do adaptador de EP é executada no sistema CICS com esse ID do sistema.
- Especifique as seguintes opções para o adaptador de EP de Filas TS:
- Especifique o nome da fila do CICS. Deve-se especificar um nome de fila.
- Se a sua fila de destino for remota, especifique o ID do sistema.
- Selecione Usar 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:
- Evento Sequencial do CICS (Binário)
- Os dados do evento são apresentados no formato não 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.
- WebSphere Business Events (XML)
- Os dados do evento estão no formato XML.
- Decision Server Insights Event (XML)
- Os dados do evento estão no formato XML.
- Especifique as seguintes opções para o adaptador de processamento de eventos da Fila de TD:
- Especifique o nome da fila do CICS. Deve-se especificar um nome de fila.
- Se a sua fila de destino for remota, especifique o ID do sistema.
- Especifique um formato de dados para o evento. Selecione um dos
seguintes valores na lista Formato de dados:
- Evento Sequencial do CICS (Binário)
- Os dados do evento são apresentados no formato não 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.
- WebSphere Business Events (XML)
- Os dados do evento estão no formato XML.
- Decision Server Insights Event (XML)
- Os dados do evento estão no formato XML.
- Especifique as seguintes opções para o adaptador de EP customizado
(gravado pelo usuário):
- Especifique uma das seguintes:
- Se o modo de emissão for assíncrono, o ID da transação para o aplicativo CICS gravado pelo usuário formata, roteia e emite o evento. Deve-se especificar um ID de transação para emissão assíncrona pelo adaptador de 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. Deve-se especificar um ID do programa para emissão síncrona pelo adaptador de EP customizado.
- Grave os dados a serem transmitidos ao adaptador de EP customizado. Seu adaptador de EP customizado processa esses dados.
- Especifique uma das seguintes:
- Especifique as seguintes opções para o adaptador de 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 (XML)
- Os eventos são enviados para um servidor compatível com HTTP 1.1 no formato de evento de base comum, que pode ser consumido por qualquer produto que suporte a Common Event Infrastructure.
- 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 Componente Decision Server Events do IBM Operational Decision Manager.
- Decision Server Insights Event (XML)
- Os eventos serão enviados para um servidor HTTP 1.1 compatível no formato XML requirido pelo Componente Decision Server Insights do IBM Operational Decision Manager.
- Especifique as opções a seguir para o adaptador de processamento de eventos de Fila de IBM MQ:
- Opcional: Especifique quaisquer opções de dispatcher avançadas necessárias. Estas opções são para usuários avançados e elas controlam como
o adaptador de EP é executado em um
sistema CICS.
Nota: Em geral, é mais eficiente deixar o CICS executar o adaptador de EP no encadeamento do dispatcher. No entanto, pode ser necessário que o adaptador de processamento de eventos seja executado como uma transação separada; por exemplo, se for necessário executá-lo sob um determinado ID do usuário que tenha autoridade para gravar na fila do IBM MQ ou se você desejar controlar o número de tarefas de adaptador de processamento de eventos simultâneas usando as configurações TRANCLASS.
- 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 de processamento de eventos do
IBM MQ
Queue emitirá estes eventos:
- Eventos transacionais usando a opção MQPMO_SYNCPOINT. As mensagens do IBM 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 de processamento de eventos do IBM MQ Queue 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 de EP precisa da autoridade de gravação.
- Especificar SYNC NONTRANS para o adaptador de 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 por meio do adaptador de EP HTTP.
- Especifique a prioridade de despacho. É possível especificar a prioridade Normal ou
Alta para controlar como o dispatcher de evento processa
os eventos associados com a ligação de evento. Os eventos de alta prioridade são emitidos assim que estão
disponíveis, com base na configuração Eventos são
transacionais.
Os eventos de prioridade normal são
emitidos assim que estão 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.
- 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 de 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 de EP.
Se a fila do IBM MQ, a fila do TD, a fila do TS ou a transação que você deseja iniciar for remota, veja Segurança para intercomunicação para obter informações sobre as configurações de segurança.
Tabela 1. Identificador de transação e ID do usuário para o adaptador de processamento de eventos do IBM MQ Queue, o adaptador de processamento de eventos do TD Queue, o adaptador de processamento de eventos do TS Queue e o adaptador de processamento de eventos do Transaction Start O ID da Transação é especificado O ID do Usuário é especificado Usar ID do usuário do Contexto O adaptador de EP é O adaptador de EP é executado usando O ID de transação do adaptador de 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 de processamento de eventos do
IBM MQ
Queue CEPR para o adaptador de processamento de eventos do TD Queue
CEPT para o adaptador de EP da Fila de TS
CEPS para o adaptador de EP de Início da Transaçãox Anexado ID do usuário do Contexto CEPQ para o adaptador de processamento de eventos IBM MQ CEPR para o adaptador de processamento de eventos de Fila de TD
CEPT para o adaptador de EP da Fila de TS
CEPS para o adaptador de EP de Início da Transaçãox Anexado ID de usuário padrão do CICS ID da transação especificada Vinculado ID do usuário da região CICS Não aplicável Tabela 2. ID da Transação e ID do Usuário para o adaptador de EP HTTP O ID da Transação é especificado O ID do Usuário é especificado Usar ID do usuário do Contexto O adaptador de EP é O adaptador de EP é executado usando O ID de Transação do Adaptador de 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 de 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, o ID do usuário do contexto ou o ID do usuário padrão do CICS.Nota: Essas duas opções não se aplicam ao modo de emissão síncrono. - Especifique se os eventos são transacionais. Marque a caixa de seleção Eventos
são transacionais se quiser que o
CICS capture eventos apenas se
a unidade de trabalho de negócios (UOW) associada ao evento
for concluída com sucesso.
Nota: Considere atentamente se os eventos que são capturados a partir de ações irrecuperáveis devem ser especificados como transacionais. 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 seleçã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.
- 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 de processamento de eventos do
IBM MQ
Queue emitirá estes eventos: