Eventos de aplicativo

Um evento de aplicativo é um tipo de evento de negócio que resulta de atividade do programa de aplicativo e contém dados do aplicativo.

É possível especificar que um evento seja emitido quando o aplicativo emitir qualquer dos comandos da API EXEC CICS habilitados para eventos ou quando um programa de aplicativo for iniciado. Os comandos EXEC ativados por evento CICS são mostrados no Pontos de Captura. Um conjunto limitado de módulos do CICS também foi ativado de forma que seja possível capturar eventos, por exemplo: comandos de arquivo e de armazenamento temporário vindos do suporte de Atom; Comandos de LINK EXEC do CICS emitidos pelos programas de ponte do CICS WebSphere MQ; comandos a partir de amostras do CICS e a transação CECI.

A especificação de captura define os critérios para emissão de evento usando filtros, tais como o identificador de transação, o nome do programa ou o valor da opção do comando EXEC CICS. Essa especificação de captura pode ser refinada adicionalmente pela filtragem nos dados do aplicativo associados ao comando. Por exemplo, é possível especificar que o campo COMMAREA contendo um valor de ordem deve ser maior que 10.000. A especificação de captura também define a localização dos dados a serem capturados.

O local do evento na lógica de aplicativo depende de como ele é especificado. Se um aplicativo CICS contém dois ou mais instâncias do mesmo comando EXEC CICS API, e a especificação de filtro não distinguir entre os dois comandos, um evento é emitido quando ambos os comandos são emitidos. Se o mesmo comando da API EXEC CICS ocorrer em dois aplicativos e não houver um filtro no identificador de transação ou nome do programa, um evento será emitido quando ambos os aplicativo forem executados.

Pontos de Captura

É possível capturar eventos na inicialização do programa (PGMINIT) e os seguintes comandos EXEC da API do CICS. Pontos de captura que podem ser especificados são mostrados na seguinte tabela:

Tabela 1. Pontos de Captura de Eventos do Aplicativo
Ponto de Captura Predicado Primário Predicado de Filtro Dados de Captura
Contexto Opção de Evento Opção de evento Dados do Aplicativo
CONVERSE Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta
EIBAID
EIBPOSN

Nenhuma

FROM
INTO-SET

Nenhuma
DELETE FILE FILE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

FILE FILE RIDFLD
DELETEQ TD QUEUE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

QUEUE QUEUE Nenhum
DELETEQ TS QNAME

ID da Transação
Programa Atual
ID do usuário
Código de resposta

QNAME QNAME Nenhum
INVOKE SERVICE SERVICE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

SERVICE
OPERATION
URI
CHANNEL
URIMAP

SERVICE
OPERATION
URI
CHANNEL
URIMAP

CHANNEL
SCOPE

LINK PROGRAM PROGRAM

ID da Transação
Programa Atual
ID do usuário
Código de resposta

PROGRAM
CHANNEL

PROGRAM
CHANNEL

COMMAREA
CHANNEL

PROGRAM INIT PROGRAM

ID da Transação
ID do usuário
Código de resposta

PROGRAM
CHANNEL

Nenhuma

COMMAREA
CHANNEL

PUT CONTAINER CONTAINER

ID da Transação
Programa Atual
ID do usuário
Código de resposta

CONTAINER
CHANNEL

CONTAINER
CHANNEL

FROM
READ FILE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

FILE
UPDATE

FILE

RIDFLD
INTO-SET

READNEXT FILE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

FILE
UPDATE

FILE

RIDFLD
INTO-SET

READPREV FILE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

FILE
UPDATE

FILE

RIDFLD
INTO-SET

READQ TD QUEUE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

QUEUE QUEUE INTO-SET
READQ TS QNAME

ID da Transação
Programa Atual
ID do usuário
Código de resposta

QNAME QNAME INTO-SET
RECEIVE Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta
EIBAID
EIBPOSN

NONE NONE INTO-SET
RECEIVE MAP MAP

ID da Transação
Programa Atual
ID do usuário
Código de resposta
EIBAID
EIBPOSN

MAP
MAPSET

MAP
MAPSET

INTO-SET
RETRIEVE Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta

NONE NONE INTO-SET
RETURN Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta

TRANSID
CHANNEL

TRANSID
CHANNEL

COMMAREA
CHANNEL

REWRITE FILE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

FILE FILE FROM
SEND Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta

NONE NONE FROM
SEND MAP MAP

ID da Transação
Programa Atual
ID do usuário
Código de resposta

MAP
MAPSET
ALARM

MAP
MAPSET

FROM
SEND TEXT Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta

ALARM NONE FROM
SIGNAL EVENT 1 EVENT

ID da Transação
Programa Atual
ID do usuário
Código de resposta

EVENT
FROMCHANNEL

EVENT
FROMCHANNEL

FROM
FROMCHANNEL

START TRANSID

ID da Transação
Programa Atual
ID do usuário
Código de resposta

TRANSID
CHANNEL

TRANSID
CHANNEL

FROM
CHANNEL

WEB READ

FORMFIELD
HTTPHEADER
QUERYPARM

Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta

NONE NONE

FORMFIELD
INTO-SET
VALUE

WEB READNEXT

FORMFIELD
HTTPHEADER
QUERYPARM

Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta

NONE NONE

FORMFIELD
VALUE

WRITE FILE FILE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

FILE FILE RIDFLD FROM
WRITE OPERATOR Nenhuma

ID da Transação
Programa Atual
ID do usuário
Código de resposta

NONE NONE TEXT 2
WRITEQ TD QUEUE

ID da Transação
Programa Atual
ID do usuário
Código de resposta

QUEUE QUEUE FROM
WRITEQ TS QNAME

ID da Transação
Programa Atual
ID do usuário
Código de resposta

QNAME QNAME FROM
XCTL PROGRAM

ID da Transação
Programa Atual
ID do usuário
Código de resposta

PROGRAM
CHANNEL

PROGRAM
CHANNEL

COMMAREA
CHANNEL

Todos os pontos de captura definem os mesmos itens de captura de contexto, PROGRAM, TRANSID e USERID.

Nota: 1 O propósito exclusivo do comando da API SIGNAL EVENT é fornecer dados para um evento. Um evento só é emitido se houver uma especificação de captura correspondente ativada no sistema CICS.
Nota: 2 Um comprimento 0 ao especificar dados do aplicativo na guia de origens de informações significa captura até o final da área ou captura de dados. Esse valor é útil quando você deseja emitir o conteúdo de um EXEC CICS WRITE OPERATOR. Para obter informações adicionais, consulte Guia de Origens de Informações.
Para obter informações adicionais sobre os pontos de captura, consulte Guia de Ponto de Captura e Information Guia de Origens no editor de ligação de evento do CICS.