To create a statistics alert definition:
This displays the Statistics Alert Definitions panel:
File Options Help
-------------------------------------------------------------–--–--------------
Statistics Alert Definitions Row 1 to 1 of 1
Command ===> ________________________________________________ Scroll ===> PAGE
Select to edit a definition. Enter NEW command to create a new definition.
/ Name Description Changed ID
_ SAMPLE Sample alert definition 2009/02/17 09:10 AXS
******************************* Bottom of data ********************************
Alternatively, you can create a new Alert Definition modeled on an existing one. Enter line action C next to the definition you want to copy. In the pop-up window, enter the name of the new definition and destination repository. If a definition of the same name already exists in the destination repository, it will not be overwritten unless you select the option Replace Alert Definition if it exists.
An Alert Definition name consists of 1-8 characters. The first character must be an alphabetic character (A-Z) or a national character (@, #, or $). The remaining characters can be alphabetic, national, or numeric (0-9) characters.
The Alert Definition edit panel has two views: expanded and compressed. The following figure shows the expanded view. The compressed view is similar, but shows only the alert text that describes each condition. To switch between views, press Left (F10) or Right (F11).
File Edit Lists Options Help
-------------------------------------------------------------–--–-------------
EDIT Statistics Alert Definition - SAMPLE Row 1 of 197 More: >
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . Sample Alert________________________
Specify the Conditions for this Alert Definition.
_ Alert Transaction dumpcode taken________________________
Formula TDRTTKN_____________________________________________________
____________________________________________________________ +
Critical ______________ Warning >0____________ Info _____________
Resource ____________________________________________ List ________ +
APPLID ________
-----------------------------------------------------------------------------
Alert Transaction dumps requested_______________________
Formula TRANS_DUMP_TAKEN____________________________________________
____________________________________________________________ +
Critical ______________ Warning >0____________ Info _____________
Resource ____________________________________________ List ________ +
APPLID ________
-----------------------------------------------------------------------------
The details for an Alert Definition consist of a description, and a list of Conditions:
The details for each Condition are:
This expression can be:
For example, the following expression calculates peak in-use IP connection receive sessions as a percentage of the maximum limit:
ISR_PEAK_RECEIVE_SESSIONS / ISR_RECEIVE_SESSIONS * 100
All field names in an expression must be from the same statistics report. You can either type field names directly into the expression, or press Prompt (F4) to select from a list of fields; selecting a field name appends it to the expression.
If you press Prompt (F4) in a Formula field that does not yet contain any field names, CICS PA displays a hierarchical list of CICS Transaction Server and CICS Transaction Gateway statistics reports. Enter line action S next to the statistics report containing the fields you want to use; this displays the list of fields in the statistics report.
Each threshold represents a different severity level:
CICS PA reports only the highest matching severity level.
A threshold consists of a numeric value optionally preceded by one of the following comparison operators:
To specify large values, append one of the following unit symbols: K (kilo), M (mega), G (giga), T (tera), or P (peta); where, for example, 1K = 1024 and 2.5M = 2.5 * 1024 * 1024.
For example, to trigger an Alert when the Formula value is greater than or equal to 32768, specify >=32K
Specify times in seconds, even for fields stored as milliseconds:
If you specify thresholds with unit symbols, then Statistics Alert reports show actual Formula values with the same unit symbols.
For Info thresholds only: to trigger an Alert regardless of the Formula value, specify a threshold of *. This information Alert is reported only if neither the critical nor the warning threshold is triggered.
You can specify either a Resource value or a Resource List, but not both. (A Resource List is a set of Resource values that you can refer to by name.)
Masking characters % (exactly one character) and * (zero or more characters) are allowed in a Resource value.
For example, suppose the Formula contains fields from the Dispatcher TCB Modes report. To report the Condition only for TCB mode names that begin with the letter L, enter L* in the Resource field. To report the Condition for TCB mode names that begin with either the letter L or the letter J, in the List field you need to specify the name of a Resource List, that you have previously defined, that contains the values L* and J*. To define a Resource List, select Lists in the action bar. For more details, see Resource Lists.
You can specify a Resource or a Resource List only when the Formula refers to a tabular (multi-record) Statistics report, such as Dispatcher TCB Modes (one record per TCB mode). You cannot specify them for label-based (single-record) reports.
CICS PA uses this field to filter statistics records from a Statistics Alert report; it does not use this field to select which SMF files to use as input for the report. This is different to specifying an APPLID in a shared or personal CICS system definition. When you request a Statistics Alert report in a Report Set (that is, using data in SMF files), CICS PA selects SMF files based on the (personal or shared) system definitions that you have specified, including the APPLID of any CICS system definitions. Consequently, any APPLID that you specify in an Alert Definition might already have been filtered out by file selection.
An Alert Definition can contain many Conditions. To find a particular Condition in an Alert Definition, enter the command FIND string, where string is a character string that appears in one of the Condition field values. If you enter the FIND command on the compressed view of the panel, the command searches only the fields displayed on the compressed view.
Each Condition can be either active (the default state) or inactive. When you request a Statistics Alert report, CICS PA ignores any inactive Conditions. If you want to temporarily exclude a Condition from reporting, then rather than deleting it, make it inactive. This allows you to reinstate the Condition later, rather than having to enter its details again. To switch a Condition between active and inactive states, enter line action X next to the Condition.
If you request a report sorted by Alert, CICS PA sorts the Alerts in the report according to the order of the Conditions on this panel. Otherwise, the order of the Conditions on this panel is not significant. You can use line actions (described below) to move Conditions into the order that you prefer.