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 CICS event binding editor guia-o através da criação de uma ou mais especificações de captura. Essas especificações identificam os seguintes itens:

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.

É 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 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.

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.

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.

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 CICS event binding editor 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 você deve 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. O painel direito 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 _. Os caracteres de orientação e em branco integrados 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 no painel direito do editor: Ponto de Captura, Filtragem e Fontes de Informações. Utilize 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 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 (*). Você deve selecionar É Igual a como o Operador e especificar um valor para o predicado primário para 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 de 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 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 da estrutura de linguagem importada e seguir as instruções em Selecionando Variáveis do Código Fonte 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 a um item de dados disponível. A tabela pode conter nenhuma fonte de informações, se nenhum dado de negócios for capturado no evento.

    Não é necessário capturar dados se não for obrigatório.

    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 da estrutura de linguagem importada e seguir as instruções em Selecionando Variáveis do Código Fonte 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.