Guia Filtragem

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.
Uma imagem da guia filtragem.

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:
  • Todos
  • É Igual a
Os valores para o operador É Igual a incluem:
  • Ok
  • Não OK

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.