Use a guia Filtragem
no CICS event binding editor para
definir critérios, chamados predicados, para capturar eventos.
Se você não fornecer nenhum predicado, os eventos são emitidos sempre que o ponto de
captura escolhido for executado no sistema CICS de destino.
Cada predicado consiste de informações identificando o predicado, um operador e um valor. É possível especificar tantos predicados quando se desejar para identificar a situação na qual você deseja que esse ponto
de captura emita um evento. Os três tipos de predicados que são possíveis de ser
especificados são Contexto, Opções do Evento
e Dados do Aplicativo.
Alguns pontos de captura possuem um predicado primário. Um predicado primário é um
predicado para o qual você seleciona >É Igual a como a configuração do Operador
e fornece um valor para evitar um impacto no desempenho conforme você inclui mais
especificações de captura em um ponto de captura.
Nota: Os nomes de módulos do CICS podem mudar; portanto, não inclua filtros que contenham nomes de módulos DFH* em suas especificações
de captura. O editor da ligação de evento do CICS valida a entrada dos usuários ao
codificar os nomes da maioria dos módulos DFH* no filtro do programa atual. Os usuários somente podem codificar DFH£*, DFH0*, DFHW2FI, DFHW2TS, DFHMQBP0
ou DFHECID. Além disso, o DFHMIRR e o DFHMIRS podem ser codificados para o evento de aplicativo LINK PROGRAM.
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 identificador 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 identificador de transação ou o programa atual para emitir eventos a partir de um determinado
aplicativo.
A área Contexto é usada para configurar
opções de filtragem para eventos. Com base em outras informações que são
fornecidas no CICS event binding editor, 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: identificador de transação,
programa atual e ID do usuário.
- ID da Transação
- Opções do operador para todos os pontos de captura:
- Todos
- É Igual a
- Não É Igual
- Não Inicia com
- Inicia com
Opções adicionais para pontos de captura do aplicativo:
- Menor Que
- Não Menos Que
- Maior Que
- Não Maior Que
- Programa Atual
- Opções do operador para todos os pontos de captura:
- Todos
- É Igual a
- Não É Igual
- Não Inicia com
- Inicia com
- Menor Que
- Não Menos Que
- Maior Que
- Não Maior Que
- ID do usuário
- Opções do operador para todos os pontos de captura:
- Todos
- É Igual a
- Não É Igual
- Não Inicia com
- Inicia com
Opções adicionais para pontos de captura do aplicativo:
- Menor Que
- Não Menos Que
- Maior Que
- Não Maior Que
- Código de resposta
- Opções do operador:
- Os valores para o operador É Igual a incluem:
Opções de Evento
Os predicados na especificação de captura são usados para filtragem nos valores de opções de evento para um comando ou evento
do sistema CICS.
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 de status da conexão
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.
- Nome
- O nome da especificação de captura.
- Operador
- Opções do operador para todos os pontos de captura:
- Todos
- É Igual a
- Não É Igual
- Não Inicia com
- Inicia com
Opções adicionais para pontos de captura do aplicativo:
- Todos
- É Igual a
- Não É Igual
- Não Inicia com
- Inicia com
Opções adicionais para pontos de captura do sistema:
- Vai Mais Alto que
- Vai Mais Baixo que
- Valor
- O valor especificado para o predicado.
- Os limites de predicados da opção de comando do aplicativo variam dependendo
da API do CICS. Por exemplo, TRANSID é 4 caracteres; CHANNEL é
16 caracteres. O CICS event binding editor se ajusta
dinamicamente para cada tipo e exibe uma mensagem se o valor do predicado for muito
longo ou muito curto.
Para obter informações adicionais sobre opções de evento para
chamadas de API do CICS, consulte Eventos de Aplicativos no Centro de Informações do CICS TS 5.1.
Para
obter informações adicionais sobre opções de evento para eventos do sistema, consulte Eventos do Sistema no Centro de Informações do CICS TS 5.1 e Guia de Recursos de Informações no Centro de Informações do CICS TS 5.1.
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 comando particular
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 tais 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.
- Localização
- O valor do campo Localização depende da chamada da API do CICS.
- Exemplos:
- Para o comando EXEC CICS WRITE FILE(EXMPCAT),
as opções para o campo Localização são FROM e RIDFLD.
- para o comando EXEC CICS INVOKE SERVICE(nome),
as opções para o campo Localização são CHANNEL e SCOPE.
- Contêiner
- Especifica um contêiner de canal CICS. O campo de contêiner somente pode ser
selecionado quando os dados do aplicativo possuem um canal especificado. Em todas
as outras situações, o campo é desativado.
- Deslocamento
- Especifica a distância do início, na qual os dados começam.
O deslocamento 0 é o início do campo.
- Comprimento
- O comprimento do campo em bytes. Um comprimento de 0 significa filtrar na
área ou contêiner de dados inteiro. Isso é útil ao filtrar,
por exemplo, no conteúdo de um contêiner independente de seu comprimento.
- Operador
- Opções do operador:
- Todos
- Existe
- É Igual a
- Não É Igual
- Não Existe
- Inicia com
- Não Inicia com
- Menor Que
- Não Menos Que
- Maior Que
- Não Maior Que
- Valor
- O valor especificado para o predicado.
- O comprimento depende do tipo de dados; por exemplo, o comprimento máximo
para o tipo caractere é de 255 caracteres, enquanto o
comprimento máximo para o tipo meia-palavra não sinalizada é
de 5 caracteres com um valor de intervalo de 0 até 65535.