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.

Procedimento

  1. Na guia Especificação, clique em uma especificação de evento. A área de janela direita mostra os detalhes da especificação de evento destacada.
  2. Clique em Incluir uma especificação de captura. A janela Incluir uma especificação de captura é exibida.
  3. Insira um nome para sua nova especificação de captura. Os caracteres aceitáveis são A-Z, a-z, 0-9 e _. Caracteres em branco à esquerda e incorporados não são permitidos. A sequência não deve iniciar com 0-9, _ ou a sequência "xml", independente de ser em minúsculas, maiúsculas ou mista; por exemplo, "Xml" ou "xMl".
  4. Opcional: Insira uma descrição para sua nova especificação de captura.
  5. Clique em OK. Uma nova especificação de captura é criada. Três guias abrem na área de janela direita do editor: Ponto de captura, Filtragem e Fontes de informações. Use cada guia para fornecer informações descrevendo a nova especificação de captura.
  6. Clique na guia Ponto de captura. Execute as seguintes etapas para incluir as informações do ponto de captura:
    1. Selecione o comando EXEC CICS para o qual você deseja incluir um ponto de captura ou Inicialização do programa na lista Ponto de captura. Inicialização do programa é o ponto de captura associado ao início de um programa CICS.
    2. Clique em Capturar antes ou Capturar depois. É possível especificar o ponto de captura a utilizar, antes ou após alguns comandos EXEC CICS. Esta opção é desativada para um subconjunto desses comandos EXEC CICS.
  7. Clique na guia Filtragem. Execute as etapas a seguir se desejar incluir informações do predicado de captura:
    1. Opcional: Defina o contexto de aplicativo para sua especificação de captura. Os predicados de contexto de aplicativo disponíveis para o ponto de captura escolhido são exibidos. Selecione uma opção para Operador e forneça um valor para especificar os predicados. Um operador Todos especifica que não há filtragem no predicado associado. Você insere valores para ID de Transação, Programa Atual e ID do Usuário em maiúsculas.
    2. Opcional: Defina opções de aplicativo para sua especificação de captura. As opções de aplicativo que estão disponíveis para o ponto de captura escolhido são exibidas. Selecione uma opção para Operador e forneça um valor para especificar os predicados. Um operador de Todos especifica que não há filtragem no predicado associado.

      As opções de aplicativo que podem ser predicados primários estão marcadas com um asterisco (*). Deve-se selecionar É igual a como o Operador e especificar um valor para o predicado primário a fim de manter o desempenho do CICS. Por exemplo, para um ponto de captura PUT CONTAINER, especifique um valor para a opção de aplicativo CONTAINER* disponível.

    3. Opcional: Defina dados do aplicativo para sua especificação de captura. Para incluir um predicado de dados do aplicativo, clique em Incluir. A janela Predicado de dados do aplicativo é exibida.

      Selecione uma opção para Operador e insira um valor para seu predicado. Um operador de Todos especifica que não há filtragem no predicado associado.

      Defina a variável que você deseja testar com o predicado. É possível clicar em Selecionar a partir da estrutura de linguagem importada e seguir as instruções em Selecionando variáveis a partir do código de origem importado, ou selecionar opções para Local e Tipo e definir adicionalmente a variável, usando os campos ativos no painel. Apenas esses campos são necessários para que o tipo selecionado seja ativado. Por exemplo, se você selecionar o tipo Caractere, somente os campos Deslocamento, Comprimento e Página de códigos estarão ativos.

  8. Clique na guia Fontes de informações. Execute as seguintes etapas em cada fonte de informações na tabela para mapear a fonte de informações para um item de dados disponível. A tabela pode não conter fonte de informações alguma se nenhum dado de negócios for capturado no evento.

    Não é necessário capturar dados se eles não forem necessários.

    1. Clique duas vezes em uma fonte de informações ou selecione-a e clique em Editar. A janela Fonte de informações do evento é exibida.
    2. Selecione um item de dados disponível em Contexto, Valores de dados ou Dados de comprimento variável. Se você selecionar um item de dados de comprimento variável, você possível clicar em Selecionar a partir da estrutura de linguagem importada e seguir as instruções em Selecionando variáveis a partir do código de origem importado, ou selecionar opções para Local e Tipo e definir adicionalmente a variável, usando os campos ativos no painel. Apenas esses campos são necessários para que o tipo selecionado seja ativado. Por exemplo, se você selecionar o tipo Caractere, somente os campos Deslocamento, Comprimento e Página de códigos estarão ativos.

      A fonte de informações não precisa ser do mesmo comprimento do item de informações de negócios emitido. O CICS preenche ou trunca o valor conforme necessário.

Resultados

Você criou uma especificação de captura. É possível também remover as especificações de captura clicando em Remover especificação de captura na guia Ponto de captura e clicando em Sim para confirmar.