Incluindo uma especificação de captura
Você inclui especificações de captura a uma especificação de evento para criar pontos de captura no CICS.
Sobre Esta Tarefa
O Editor de ligação de evento guia o Cliente através da criação de uma ou mais especificações de captura. Essas especificações identificam os seguintes itens:
- Qualquer ponto em um programa que é considerado um evento
- As condições sob as quais o evento é considerado válido
- Como os dados a serem capturados no ponto de captura devem ser mapeados para a estrutura de dados de resultado do evento
Por exemplo, é possível especificar que qualquer comando READQ TS (READ de armazenamento temporário) é um evento potencial. Você, então, qualifica as condições sob as quais o evento é levantado, incluindo predicados aos tipos disponíveis para o comando que você deseja interceptar. Todos os predicados devem ser verdadeiros para o evento a ser levantado.
É possível definir três tipos de predicados:- Contexto
Os predicados na especificação de captura são usados para filtragem no contexto do ponto de captura.
Cada ponto de captura possui itens de contexto aos quais é possível especificar predicados. Um exemplo é o ID de transação. Todos os predicados de contexto disponíveis são mostrados na guia Filtragem. Predicados de contexto são opcionais: no entanto, geralmente se especifica o ID de transação ou o programa atual para emitir eventos a partir de um determinado aplicativo.
A área de Contexto é usada para configurar opções de filtragem para eventos. Com base em outras informações que são fornecidas no Editor de ligação de evento, nem todos os campos se aplicam; os predicados de contexto disponíveis dependem do ponto de captura. Os predicados que você pode desejar especificar são: ID de transação, programa atual e ID do usuário.
- Opções de Eventos
Os predicados na especificação de captura são usados para filtragem nos valores de opções de evento para um comando do CICS ou evento do sistema.
Cada ponto de captura pode ter opções de evento para as quais é possível especificar predicados. Alguns comandos não possuem opções de evento. As opções de evento correspondem às opções para um determinado comando EXEC CICS ou evento do sistema. Um exemplo para o comando SEND MAP é o nome MAP. Um exemplo para o evento do status da conexão do DB2 é o status FROM_CONNECTST. Todos os valores de dados fixos disponíveis para o ponto de captura são mostrados na guia Filtragem. O formato das opções de evento são conhecidos pelo CICS.
- Dados do Aplicativo
Os predicados na especificação de captura são usados para filtragem em dados do aplicativo que são especificados em um comando CICS.
Nota: Não é possível incluir dados do aplicativo quando um ponto de captura de DELETEQ TD ou DELETEQ TS é definido para uma especificação de captura.Os pontos de captura do aplicativo podem ter valores de dados de comprimento variável para os quais é possível especificar predicados. Os dados do aplicativo correspondem às opções para um determinado comando EXEC CICS. Um exemplo para o comando SEND MAP é o campo FROM. Todos os valores de dados variáveis disponíveis para o comando EXEC CICS para esse ponto de captura são mostrados na guia Filtragem.
Os predicados de dados do aplicativo são processados pelo CICS na ordem especificada; ou seja, o primeiro predicado é processado, seguido pelo segundo predicado e assim por diante.
Os dados do aplicativo são usados para áreas de armazenamento, como COMMAREAs, ou contêineres que são transmitidos como opções em comandos CICS. O formato dessas áreas não é conhecido pelo CICS, mas é conhecido pelo programa de aplicativo. Você provavelmente possui uma descrição de idioma de origem que pode ser importada para descrever o formato.Nota: Eventos do sistema não usam dados do aplicativo.
As informações de ligação de evento básicas, inseridas pelo gerente de negócios durante a definição de alto nível da ligação de evento, incluem uma especificação de evento. Essas informações da ligação de evento identificaram dados que eram vistos como necessários para o processamento adicional, mas não deram detalhes de sua posição. Você especifica fontes de informações para fornecer esses detalhes.
O Editor de ligação de evento ajuda, apresentando na guia Fontes de informações uma tabela de informações necessárias para corresponder à especificação de negócios. A tabela mostra informações de negócios da especificação de evento. Para cada item na tabela, deve-se definir a fonte de informações para esta especificação de captura.