Event capture specification - EVCSPEC

The Event capture specification (EVCSPEC) displays information and statistics about a capture specification in an installed EVENTBINDING.

Supplied views

To access from the main menu, click:

CICS operations views > Application operations views > Event capture specification

Table 1. Views in the supplied Event capture specification (EVCSPEC) view set
View Notes
Event capture specification

EYUSTARTEVCSPEC.DETAILED

Detailed information about the selected event capture specification.
Event capture specification

EYUSTARTEVCSPEC.TABULAR

Tabular information about event capture specifications.

Actions

None.

Fields

Table 2. Fields in EVCSPEC views
Field Attribute name Description
Capture point CAPTUREPOINT Specifies a 25-character data area to receive the capture point associated with the capture specification. Its contents will match one of the capture point entries in the event binding tooling. Capture point entries consisting of two words or more are separated with an underscore - for example, LINK_PROGRAM or PROGRAM_INITIATION.
Capture specification name CAPTURESPEC The name of this capture specification in the EVENTBINDING. The name can be up to 32 characters in length.
Capture point type CAPTURETYPE Specifies a fullword binary data area to receive a CVDA value indentifying the type of capture point. The possible values are as follows:
  • PRECOMMAND
    • Capture point is at the start of a CICS API command.
  • POSTCOMMAND
    • Capture point is on completion of a CICS API command.
  • PROGRAMINIT
    • Capture point is at the program initiation.
  • SYSTEM
    • Capture point is a system event.
Current program filter value CURRPGM Data area to receive the value specified by the application context predicate for the current program name.
Current program filter operator CURRPGMOP Operator that is used together with the value in CURRENT when evaluating the application context predicate on the current program name. The available CVDA values are as follows:
  • ALLVALUES
    • The predicate always evaluates true, i.e no filtering based on the name of the current program name is performed.
  • DOESNOTEQUAL
    • Predicate evaluates true if the name of the current program is not equal to the value of CURRPGM.
  • DOESNOTSTART
    • Predicate evaluates true if the name of the current program does not start with the value of CURRPGM.
  • EQUALS
    • Predicate evaluates true if the name of the current program is equal to the value of CURRPGM.
  • GREATERTHAN
    • Predicate evaluates true if the name of the current program is greater than the value of CURRPGM.
  • ISNOTGREATER
    • Predicate evaluates true if the name of the current program is equal to or less than the value of CURRPGM.
  • ISNOTLESS
    • Predicate evaluates true if the name of the current program is equal to or greater than the value of CURRPGM.
  • LESSTHAN
    • Predicate evaluates true if the name of the current program is less than the value of CURRPGM.
  • STARTSWITH
    • Predicate evaluates true if the name of the current program starts with the value of CURRPGM.
Current transaction ID filter value CURRTRANID Data area to receive the value specified by the application context predicate for the current transaction name.
Current transaction ID filter operator CURRTRANIDOP Operator that is used together with the value in CURRTRANID when evaluating the application context predicate on the current transaction name. The available CVDA values are as follows:
  • ALLVALUES
    • The predicate always evaluates true, i.e. no filtering based on the name of the current transaction is performed.
  • DOESNOTEQUAL
    • Predicate evaluates true if the name of the currently executing transaction is not equal to the value of CURRTRANID.
  • DOESNOTSTART
    • Predicate evaluates true if the name of the currently executing transaction does not start with the value of CURRTRANID.
  • EQUALS
    • Predicate evaluates true if the name of the currently executing transaction is equal to the value of CURRTRANID.
  • GREATERTHAN
    • Predicate evaluates true if the name of the currently executing transaction is greater than the value of CURRTRANID.
  • ISNOTGREATER
    • Predicate evaluates true if the name of the currently executing transaction is equal to or less than the value of CURRTRANID.
  • ISNOTLESS
    • Predicate evaluates true if the name of the currently executing transaction is equal to or greater than the value of CURRTRANID.
  • LESSTHAN
    • Predicate evaluates true if the name of the currently executing transaction is less than the value of CURRRTRANID.
  • STARTSWITH
    • Predicate evaluates true if the name of the currently executing transaction starts with the value of CURRTRANID.
Current user ID filter value CURRUSERID Data area for the user id associated with the current transaction.
Current user ID filter operator CURRUSERIDOP Operator that is used together with the value in CURRUSERID when evaluating the application context predicate on the user id. The available CVDA values are as follows:
  • ALLVALUES
    • The predicate always evaluates true, i.e no filtering based on the name of the current user id is performed.
  • DOESNOTEQUAL
    • Predicate evaluates true if the user id of the current user is not equal to the value of CURRUSERID.
  • DOESNOTSTART
    • Predicate evaluates true if the user id of the current user does not start with the value of CURRUSERID.
  • EQUALS
    • Predicate evaluates true if the user id of the current user is equal to the value of CURRUSERID.
  • GREATERTHAN
    • Predicate evaluates true if the user id of the current user is greater than the value of CURRUSERID.
  • ISNOTGREATER
    • Predicate evaluates true if the user id of the current user is equal to or less than the value of CURRUSERID.
  • ISNOTLESS
    • Predicate evaluates true if the user id of the current user is equal to or greater than the value of CURRUSERID.
  • LESSTHAN
    • Predicate evaluates true if the user id of the current user is less than the value of CURRUSERID.
  • STARTSWITH
    • Predicate evaluates true if the user id of the current user starts with the value of CURRUSERID.
Event binding name EVENTBINDING Specifies the name (1-32 characters) of the associated event binding.
Event name EVENTNAME Specifies a 32-character data area to receive the associated business event name.
Capture failures EVNTCAPFAIL The number of capture failures recorded by capture specification.
Events captured EVNTCAPTURED The number of events captured
Data predicate count NUMDATAPRED The number of data predicates related to this capture specification.
Information source count NUMINFOSRCE The number of infomation sources related to this capture specification.
Option predicate count NUMOPTPRED The number of option predicates related to this capture specification.
Primary predicate filter value PRIMPRED Data area for the primary predicate for the capture specification.
Primary predicate filter operator PRIMPREDOP Operator that is used together with the value in PRIMPRED when evaluating the primary predicate. The available CVDA values are as follows:
  • ALLVALUES
    • The predicate always evaluates true, i.e no filtering based on the name of the commands resource name is performed.
  • DOESNOTEQUAL
    • Predicate evaluates true if the resource specified by the EXEC CICS command is not equal to the value of PRIMPRED.
  • DOESNOTSTART
    • Predicate evaluates true if the resource specified by the EXEC CICS command does not start with the value of PRIMPRED.
  • EQUALS
    • Predicate evaluates true if the resource specified by the EXEC CICS command equals the value of PRIMPRED.
  • GREATERTHAN
    • Predicate evaluates true if the resource specified by the EXEC CICS command is greater than the value of PRIMPRED.
  • ISNOTGREATER
    • Predicate evaluates if the resource specified bythe EXEC CICS command is equal to or less than the value of PRIMPRED.
  • ISNOTLESS
    • Predicate evaluates true if the resource specified by the EXEC CICS command is equal to or greater than the value of PRIMPRED.
  • LESSTHAN
    • Predicate evaluates true if the resource specified by the EXEC CICS command is less than the value of PRIMPRED.
  • STARTSWITH
    • Predicate evaluates true if the resource specified by the EXEC CICS command starts with the value of PRIMPRED.
Primary predicate type PRIMPREDTYPE The type of primary predicate for this capture specification. The available CVDA values are as follows:
  • CONTAINER
    • The primary predicate is a CICS container.
  • CURRENTPGM
    • The primary predicate is the current program name.
  • EVENT
    • The primary predicate is a CICS event.
  • FILE
    • The primary predicate is a CICS FILE.
  • MAP
    • The primary predicate is a CICS BMS map.
  • MESSAGEID
    • The primary predicate is a CICS or CPSM message identifier.
  • NONE
    • The capture specification has no primary predicate.
  • PROGRAM
    • The primary predicate is a CICS program name.
  • SERVICE
    • The primary predicate is a CICS service or a WEBSERVICE resource.
  • TDQUEUE
    • The primary predicate is a CICS transient data queue.
  • TRANCLASS
    • The primary predicate is a CICS transaction class name.
  • TRANSACTION
    • The primary predicate is a CICS transaction identifier.
  • TSQUEUE
    • The primary predicate is a CICS temporary storage queue.


eyua3_evcspec.html | Timestamp icon Last updated: Sunday, 4 June 2017