ECSC gate, SYSTEM_EVENT_THRESHOLD function
SYSTEM_EVENT_THRESHOLD returns information about the scalar value changes compared to installed event capture specifications. This function can also capture and queue events for emission.
Input Parameters
- ABSTIME
- Optional parameter
- The current absolute time and date.
- APPLID
- Optional parameter
- The APPLID of the system.
- CAPTURE_POINT
- The type of scalar value change that can be captured:
- TASK_THRESHOLD
- TRANCLASS_TASK_THRESHOLD
- DEFERRED_FILTER_ID
- Optional parameter
- An ID assigned when the initial filter request is deferred. The same ID is specified when the request is reissued by the deferred filtering task CEPF.
- EVENT_POINT_TOKEN
- A token representing the capture point. This token is obtained from the GET_EVENT_POINT_TOKEN function.
- MAX_VALUE
- The maximum for the scalar value.
- NETQUAL
- Optional parameter
- The network qualifier ID of the system.
- SUSPEND
- Defines whether the function can suspend. Values for the parameter are as follows:
- YES
- NO
- THRESHOLD
- The threshold value not to be crossed. This value can be specified in a threshold event filter predicate.
- TRANSID
- Optional parameter
- The current transaction ID.
- USERID
- Optional parameter
- The current user ID.
- VALUE_FROM
- The value the scalar value has changed from.
- VALUE_TO
- The value the scalar value has changed to.
Output Parameters
- EVENTS
- The number of events captured.
- REASON
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- The following values are returned when RESPONSE is DISASTER:
- INSUFFICIENT_STORAGE
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.