1.7.4 Windows for creating new alarm definitions and editing existing alarm definitions

(a) General settings

Product

Displays the type of PFM - Agent or PFM - RM product for which an alarm is to be created.

This setting cannot be changed.

Alarm table name

Displays the name of the alarm table for which an alarm is to be created.

This setting cannot be changed.

Alarm name

Specify the alarm name by using no more than 20 bytes of two-byte characters, single-byte alphanumeric characters, the one-byte symbols % - ( ) _ . / @ [ ], and spaces.

Alarm message

Specify the message to be displayed in the Event Monitor window if an alarm occurs, or the message to be sent for an SNMP trap by using no more than 255 bytes of single-byte or two-byte characters. This item is optional.

Note:

Do not set the alarm message to any of the following statements:

• "Alarm deactivated"

• "Alarm cleared"

• "Alarm updated/deleted"

Note that when PFM - Manager 12-00 or later is connected and the alarm message is set to any of the statements listed above, no action is executed when the alarm condition returns to normal.

Specifying variables enables you to display alarm-related information.

The following table lists and describes the variables that can be specified.

Variable	Description
%AIS	Represents the alarm name set in Alarm name.
%ANS	Represents the name of the agent to which this alarm table is bound.
%ATS	Represents the name of the alarm table for which this alarm is defined.
%CVS[n][.p]#1,#2,#3,#5	Represents the measurement value that triggered the alarm report (that satisfied the conditional expression). n#4 Specifies the position of the field as 1 or a greater numeric value when more than one conditional expression is specified in the New Alarm > Alarm Conditions window or the Edit > Alarm Conditions window. If 0 or a value greater than the number of conditional expressions is specified, the measurement value in the first field is displayed. p#4 For a field that is replaced with an integer or a decimal value Specifies the number of decimal places to be displayed (rounded). For a field whose measurement value is replaced with a string Specifies the position of a string that is to be displayed from the strings whose measurement value can be delimited by a single-byte space. If you want to specify the position, specify 1 or a larger value. If you specify 0, the measurement value is displayed as is. If you specify a value greater than the number of strings that can be delimited by the single-byte space, a 0-byte string replaces the variable. If the alarm conditions are as below and you want to evaluate Mbytes Free % by using %CVS, %CVS2 must be used: (Mbytes Free % < "5" AND File System <> "/usr") AND Available Space % < "10" In this case, the evaluation is performed in the following order: (Mbytes Free % < "5" Second AND File System <> "/usr") Third AND Available Space % < "10" First To evaluate from the top by using %CVS, change the alarm conditions to as follows: Mbytes Free % < "5" (AND File System <> "/usr" AND Available Space % < "10") In this case, the evaluation is performed in the following order: Mbytes Free % < "5" First (AND File System <> "/usr" Second AND Available Space % < "10") Third
%HNS	Represents the name of the host where the agent to which this alarm table is bound is running.
%PTS	Represents the product name set in Product.
%SCS	Represents the alarm condition that triggered output of the message. OK, WARNING, or EXCEPTION is displayed. Their meanings are as follows: OK: Normal WARNING: Warning EXCEPTION: Abnormal
%SCT	Represents the system time at the host where the agent whose alarm was evaluated is running.

#1: If the alarm status changes from Abnormal or Warning to Normal for an alarm definition that uses multiple instance records, the value stored in the %CVS variable will be as follows:

• If the function for measurement value output at alarm recovery is enabled

  The current measurement value of the instance that triggered the last issued abnormal or warning alarm is stored until the alarm status returns to normal.

• If this function is disabled

  Because the measurement value that satisfies the condition expression does not exist, the <OK> string is stored. Accordingly, if a value of 2 or more is specified for p in %CVSn.p, %CVS is replaced with a zero-byte string.

For details about the function for measurement value output at alarm recovery, see the chapter that explains operation monitoring by using alarms in the JP1/Performance Management User's Guide.

#2: The maximum length of the character string generated after the variable %CVS is substituted with its value is 79 bytes.

If multiple alarm conditions exist, the total of "the total length of replaced characters for all conditional expressions" and "the number of alarm conditions minus 1" must be no more than 79 bytes.

The following shows an example where three alarm conditions are defined:

Mbytes Free % < "5"

(AND File System <> "/usr"

AND Available Space % < "10")

In this case, %CVS for each conditional expression is replaced as follows:

Evaluation results of Mbytes Free % < "5" => %CVS1

Evaluation results of File System <> "/usr" => %CVS2

Evaluation results of AND Available Space % < "10" => %CVS3

In this example, the total length of the replaced characters for all conditional expressions can be calculated as follows:

Therefore, if three conditional expressions are defined, a maximum of 77 (79 minus 2) bytes can be replaced.

If the result of replacement is more than 79 bytes, only the characters in the first 79 bytes are used and the following characters are discarded.

For example, assume that as the result of replacement of the above conditional expressions, the total length of the string is more than 79 bytes while %CVS2 is replaced with its values. In this case, the total length of replaced characters for all conditional expressions becomes as follows:

All of the replacement string for %CVS1 is included, but the end of the replacement string for %CVS2 is omitted.

As for %CVS3, the total character string is 79 or more bytes before the replacement of %CVS3, so the replacement of %CVS3 is performed according to the following rule: if zero or a value greater than the number of conditional expressions is specified, the measurement value of the first field is displayed. This means that %CVS3 is replaced with %CVS1, which is the measurement value for the first field.

Therefore, the final replacement result is as follows:

#3: If the character string generated by replacing the variable %CVS contains the value |, the characters following | will be omitted.

#4: Only a maximum of five digits can be specified for the value. If you specify six or more digits, only the first five digits are used and displayed in the alarm notification message.

#5: The following are notes on %CVS for #1 to #3:

When two or more of the same field are used in a condition expression, the value of the %CVS variable is aggregated as the value specified for the first field. As a result, the number specified for %CVS becomes the position that excludes the overlapping fields.

For example, when the condition expression is A and (A and B), the value for A is %CVS1, and the value for B is %CVS2.

Similarly, when the condition expression is A and (B and A), the value for A is %CVS1, and the value for B is %CVS2.

The following are condition expression examples:

• Line 1: Free Mbytes <>"0"

• Line 2: AND (Free Mbytes % = "10.000"

• Line 3: AND (Free Mbytes % <= "20.000"

• Line 4: AND ID = "*"))

In this case, the following result is output:

• For %CVS1, the evaluation result of Free Mbytes in line 1

• For %CVS2, the evaluation results of Free Mbytes % in lines 2 and 3

• For %CVS3, the evaluation result of the ID in line 4

Note

If the length of the message text is more than 255 bytes after the values are substituted in for the variables, the Agent Collector or Remote Monitor Collector service outputs the KAVE00184-W message when the alarm is reported.

If this message is displayed, adjust the character string to be specified in the message text and the number of digits to be specified for %CVS so the message text length is no more than 255 bytes.

Alarm message preview

Displays the message you specified in Alarm message after its variable section is replaced with a string.

Monitor whether the value exists

Specifies that a given field is to be monitored for presence of a value and the alarm is to be issued when it is detected that no value exists in the field. With this function, an alarm can be issued when a critical program is not running (whether or not the processing is being executed can be monitored). This option can be used for all products. The default is that this option is not selected.

This option is can be selected only when a new alarm is being created.

(b) Advanced settings

Enable alarm

Specifies that the alarm is to become active immediately after it has been created. The default is that this box is selected.

Alarm notification

Allows you to specify the content of the alarm to be reported.

Notify when the state changed

If selected, specifies that the alarm is to be reported when the alarm or instance status changes.

By default, this item is selected.

Notification target

Specifies the target of alarm notification.

State changes for the alarm

Specifies, when selected, that the alarm is to be reported when the alarm status changes.

• For single-instance records:

  The status of the instance is treated as the alarm status.

• For multi-instance records:

  The status of the instance in the worst status is treated as the alarm status.

By default, this item is selected.

Evaluate all data

Select this item to evaluate all collected data for multi-instance records.

If this item is not selected, the alarm is reported only for the data that was evaluated first in the record in the worst status. By default, this item is selected.

State changes for each record instance

Specifies, when selected, that the alarm is to be reported when the status of an instance changes.

For multi-instance records, the alarm is reported every time the status of an instance changes. By default, this item is not selected.

This item is active only if all the following conditions are met:

• The connected PFM - Manager is version 10-10 or later.

• Monitor whether the value exists is not selected.

• The abnormal condition and warning condition of the alarm consist of a single type of record, or these conditions have not been specified.

Always notify

Specifies, when selected, that the alarm is always to be reported when a conditional expression is satisfied.

If this item is selected, whether any conditional expression is satisfied is monitored each time the alarm is evaluated. If a conditional expression specified as Abnormal condition or Warning condition is satisfied, the alarm is issued. If no conditional expressions are satisfied (that is, the conditions are all normal), the alarm is not issued.

If this item is selected, changes to the agent's status are not monitored, so that no agent events are issued.

By default, this item is not selected.

Evaluate all data

Select this item to evaluate all collected data for multi-instance records.

When this box is not selected, the alarm is issued only for the first data evaluated by the record that has the worst status. The default is that this box is not selected.

For the differences in alarm evaluations due to the combination of alarm conditions, see the section that explains the differences in alarm evaluations due to the combination of alarm conditions in the JP1/Performance Management User's Guide.

Monitoring time range

Specifies the time range during which the collected data is to be monitored.

If the State changes for each record instance is selected, the resultant behavior varies depending on the status of the alarm when the time falls outside the monitoring time range.

If the alarm is in normal status when the time falls outside the monitoring time range, neither the value of Damping is cleared nor the alarm event (Alarm Expired) is issued.

If, on the other hand, the alarm is in abnormal or warning status when the time falls outside the monitoring time range, the value of Damping is cleared and the alarm event (Alarm Expired) is issued once. Afterwards, when the time falls inside the monitoring time range, an evaluation begins from the start, just as it does when the alarms are bound to agents.

If State changes for each record instance is not selected, the value of Damping is not cleared even when the time falls outside the monitoring time range. When, on the other hand, the alarm is in abnormal or warning status when the time falls outside the monitoring time range, the alarm event (Alarm Expired) is issued.

Always monitor

Specifies that alarms are always to be monitored 24 hours a day.

The default is that this box is selected.

Start

Specify an alarm monitoring start time.

This option can be specified when Always monitor is not selected.

The default is that the current time is displayed.

The permitted value range is 00:00 to 23:59.

End

Specifies an alarm monitoring end time.

This option can be specified when Always monitor is not selected.

The default is that the current time is displayed.

The permitted value range is 00:00 to 23:59.

Damping

Specifies, in relation to alarm evaluation, the number of times alarms are to be evaluated and the number of times the threshold is to be exceeded before the alarm is issued.

Evaluation is skipped if no instance can be collected and no record can be generated, even though collection was executed at the collection time. In such a case, the value set for Damping is stored. The value of Damping is cleared when one of the following occurs:

• The alarm definition is changed (by unbinding or by a definition change).

• The agent stops.

• The time exceeds the range specified for Monitoring time range.

  The value of Damping is cleared when the time exceeds the range specified for Monitoring time range only if State changes for each record instance is selected. In other monitoring methods, the value is not cleared when the time exceeds the range. For this reason, the timing to issue an alarm event after the time returns to the range specified for Monitoring time range again might be different between the monitoring method where an alarm is reported when the status of each record instance changes and other monitoring methods.

Report alarm when the following damping condition is reached.

Specifies that the alarm is to be issued when alarms occur at least as often as the specified occurrence frequency.

The default is that this box is not selected.

occurrence(s) during and interval(s)

Specify the number of times alarms are to be evaluated and the number of times the threshold is to be exceeded before the alarm is issued. Use the and buttons to set in occurrence(s) during the number of times the threshold is to be exceeded and in interval(s) the number of times alarms are to be evaluated. These items can be specified only when Report alarm when the following damping condition is reached. is selected. The default is 1 for both fields.

The permitted values are an integer in the range from 1 to 32,767.

Depending on whether or not Always notify is selected, an alarm is issued as follows:

• When Always notify is not selected

  Alarms are evaluated according to their occurrence frequency and the alarm is issued whenever the condition is satisfied. Because the result of the evaluated occurrence frequency is in the alarm state, the notified alarm state and the data threshold may differ.

• When Always notify is selected

  Data in the warning or abnormal state is reported in an alarm when the occurrence frequency meets the warning or abnormal conditions. The state according to occurrence frequency is not reflected in the alarm status. Also, if occurrence(s) during and interval(s) are set with the same value, the timing of alarm notification changes.

  The following table shows the occurrence frequency and alarm notification timing:

  Occurrence frequency	Alarm notification timing
  n/m	If during interval m the threshold is exceeded n times, the alarm is issued. Thereafter, the alarm is issued every mth time alarms are evaluated and the threshold is exceeded n times.
  n/n#	The alarm is issued every n times that the threshold is exceeded.

#: If Always notify is selected and the threshold is exceeded at the first collection since collection of data began, the alarm will be issued regardless of the interval.

The following table shows the differences between the specifications of Always notify and Evaluate all data when the occurrence frequency is specified.

Always notify	Evaluate all data	Alarm evaluation (notification)
N	N	Specifies whether or not the alarm status is to be changed when the threshold is exceeded the specified number of times while evaluating alarms for the specified number of times. The alarm is issued only when the alarm status has changed from the previously notified alarm status. The alarm status of the data satisfying the highest severity condition of the data collected when an alarm was issued is reported in an alarm. Note Because the alarm status is the status of the result of the evaluated occurrence frequency, the alarm status and the threshold of the reported data may differ.
N	Y	Specifies whether or not the alarm status is to be changed when the threshold is exceeded the specified number of times while evaluating alarms for the specified number of times. The alarm is issued only when the alarm status has changed from the previously notified alarm status. If the alarm status is Warning or Abnormal, the alarm status of all data satisfying the alarm condition at the time the alarm is issued is reported. Note Because the alarm status is the status of the result of the evaluated occurrence frequency, the alarm status and the threshold of the reported data may differ.
Y	N	Specifies whether or not the alarm is to be issued when the threshold is exceeded the specified number of times while evaluating alarms for the specified number of times. You can use this combination of settings to suppress the occurrence frequency of alarms. The data satisfying the highest severity condition of the data collected when an alarm was issued is reported in the alarm.
Y	Y	Specifies whether or not the alarm is to be issued when the threshold is exceeded the specified number of times while evaluating alarms for the specified number of times. You can use this combination of settings to suppress the occurrence frequency of alarms. All data satisfying the Warning or Abnormal conditions at the time an alarm is issued is reported in the alarm.

Legend:

Y: Selected

N: Not selected

• If State changes for each record instance is selected, the data in the warning or abnormal status is reported when an instance satisfies the warning or abnormal condition set under Damping. Also, if the same value is specified as the number of times the threshold is exceeded and the number of intervals for occurrence(s) during and interval(s), the timing of alarm report changes.

  Because the instances that are collected might vary depending on the environment, a record might not contain the same instance values that were collected the previous time. For example, in process monitoring, the instances that are collected change if the application definition changes. Then, data is not collected because no instance values are displayed for the record. Status monitoring continues, assuming that uncollected instance values are within the normal range. Note that, if you want to be informed of an abnormality when the data of a specific instance is not displayed, select Monitor whether the value exists. The following table describes the values of Damping and the timing of the alarm report:

  Damping#	Timing of the alarm report
  n/m	Assume that the value of damping is n/m (n <= m). An alarm event is issued by changing the instance status to the abnormal (or warning) status when the abnormal (or warning) status has occurred n times during the past m times of collection, including the current collection. Although the data on the past m times of collection cannot be obtained until the number of times of collection reaches m, an alarm event is issued when the number of abnormal status or warning status occurrences reaches n.
  n/n	Same as above.

  #: The value of Damping is counted as follows:

  - If the instance value is within the abnormal range, the instance is assumed to be in both the abnormal status and warning status, the occurrence of an abnormal status is counted also as an occurrence of a warning status.

  - If the instance value is within the warning range, the occurrence of a warning status is counted only as an occurrence of a warning status.

  - If the instance value is within the normal range, nothing is counted.

(a) When "Monitor whether the value exists" is selected

The window is used to set the value whose existence is to be monitored.

The following figure shows the New Alarm > Alarm Conditions window when Monitor whether the value exists is selected.

The following describes the displayed items:

Cancel button

Cancels creation of a new alarm or the editing of an alarm.

< Back button

Returns to the New Alarm > Main Information or Edit > Main Information window.

Although you return to the previous window, the settings you specified in this window are not discarded.

Next > button

Switches to the New Alarm > Action or Edit > Action window.

Finish button

Applies the settings, and ends creation of a new alarm or the editing of an alarm.

If the auto alarm bind function is enabled, you are brought to either the New Alarm > Finish window or the Edit > Finish window. The items displayed in these windows are the same as those displayed in the New Alarm Table > Finish window. For details, see 1.7.3 (1) New Alarm Table > Finish window.

Definition of conditional expression

Record

From the pull-down menu, select the target record. In the pull-down menu, only multi-instance records are displayed.

Description button (to the right of Record)

Displays the Description of Record and Fields window, which describes the record selected in Record and its fields, as a separate window.

Search Fields button

Displays the New Alarm > Alarm Conditions > Search Fields or Edit > Alarm Conditions > Search Fields window. This button is not displayed if the data model description file is not stored. If the data model description file has not been stored, see the setup procedure for PFM - Web Console for registering PFM - Agent or PFM - RM. For details, see the chapter that explains installation and setup in the JP1/Performance Management Planning and Configuration Guide.

For details about the Search Fields window, see 1.7.4(3) New Alarm > Alarm Conditions > Search Fields or Edit > Alarm Conditions > Search Fields window.

Field

From the pull-down menu, select the target field.

This item is enabled when a selection is made in Record.

The default is the first field in the record selected in Record.

Description button (on the right of Field)

Displays the Description of Record and Fields window, which describes the field selected in Field and its records, as a separate window.

Value

Specify the value whose existence you want to monitor by using an integer value, a decimal value, or a character string consisting of no more than 127 bytes of two-byte or single-byte characters. This value is case sensitive. However, you cannot use the following characters: ( ) [ ] < > = ". To specify these characters, use a wildcard character to specify the conditional expression.

If a program name is specified, the extension is not needed.

The values that can be specified depend on the field. For details about the values that can be specified, see the chapter that explains records (list of fields for each record) in the PFM - Agent or PFM - RM manuals.

(b) When "Monitor whether the value exists" is not selected

This window is used to set conditional expressions for the alarm to be monitored.

The following figure shows the New Alarm > Alarm Conditions window when Monitor whether the value exists is not selected.

The following describes the displayed items:

Cancel button

Discards the settings and cancels alarm creation or editing.

< Back button

Returns to the New Alarm > Main Information window or the Edit > Main Information window.

The settings specified in this window remain intact when you return to the previous window.

Next > button

Displays the New Alarm > Action window or the Edit > Action window.

Finish button

Applies the settings and finishes alarm creation or editing.

If the auto alarm bind function is enabled, you are brought to either the New Alarm > Finish window or the Edit > Finish window. The items displayed in these windows are the same as those displayed in the New Alarm Table > Finish window. For details, see 1.7.3 (1) New Alarm Table > Finish window.

Record

From the pull-down menu, select the target record for which the conditional expressions are specified.

Description button (to the right of Record)

Displays the Description of Record and Fields window, which describes the record selected in Record and its fields, as a separate window.

Search Fields button

Displays the New Alarm > Alarm Conditions > Search Fields or Edit > Alarm Conditions > Search Fields window. This button is not displayed if the data model description file is not stored. If the data model description file has not been stored, see the setup procedure for PFM - Web Console for registering PFM - Agent or PFM - RM. For details, see the chapter that explains installation and setup in the JP1/Performance Management Planning and Configuration Guide.

For details about the Search Fields window, see 1.7.4(3) New Alarm > Alarm Conditions > Search Fields or Edit > Alarm Conditions > Search Fields window.

Field

From the pull-down menu, select the target field for which the conditional expressions are specified. This item is enabled when a selection is made in Record.

The fields whose data type is time_t, timeval, or utime are not displayed in the pull-down menu because they cannot be specified for the alarm conditions.

The default is the first field in the record selected in Record.

Description button (to the right of Field)

Displays the Description of Record and Fields window, which describes the fields selected in Field and the record to which the fields belong, as a separate window.

Condition

From the pull-down menu, select an operator you want to use for specifying the conditional expression.

This item is enabled when a selection is made in Record.

The following table lists and describes the operands that can be selected:

Operand	Description
=	The value in Field is equal to the value in Value.
<	The value in Field is smaller than the value in Value. For a character string field, comparisons are made in ascending order of the ASCII codes.
<=	The value in Field is smaller than or equal to the value in Value. For a character string field, comparisons are made in ascending order of the ASCII codes.
>	The value in Field is greater than the value in Value. For a character string field, comparisons are made in ascending order of the ASCII codes.
>=	The value in Field is greater than or equal to the value in Value. For a character string field, comparisons are made in ascending order of the ASCII codes.
<>	The value in Field is any value other than the value in Value.

The default is =.

Abnormal value

Specify the threshold value that is to be used as the reference for determining an Abnormal-condition alarm during alarm evaluation by using an integer value, a decimal value, or a character string consisting of no more than 750 bytes of single-byte or two-byte characters. However, you cannot use the following characters: ( ) [ ] < > = ". To specify these characters, use a wildcard character to specify the conditional expression. This is the value in the abnormal conditional expression. The values that can be specified depend on the field. For details about the values that can be specified, see the chapter that explains records (list of fields for each record) in the PFM - Agent or PFM - RM manuals.

You can specify the wildcard character in a character string. For example, if you specify item-name="*AAA*", monitoring would be of all character strings that contain internally AAA.

Warning value

Specify the threshold value that is to be used as the reference for determining a Warning-condition alarm during alarm evaluation by using an integer value, a decimal value, or a character string consisting of no more than 750 bytes of single-byte or two-byte characters. However, you cannot use the following characters: ( ) [ ] < > = ". To specify these characters, use a wildcard character to specify the conditional expression. This is the value in the warning conditional expression. The values that can be specified depend on the field. For details about the values that can be specified, see the chapter that explains records (list of fields for each record) in the PFM - Agent or PFM - RM manuals.

You can specify the wildcard character in a character string. For example, if you specify item-name="*AAA*", monitoring would be for all character strings that contain internally AAA.

Add button

Adds the conditional expression specified in Record, Field, Condition, and Abnormal value and Warning value to Abnormal condition and Warning condition.

Both Abnormal value and Warning value must be specified for the specified conditional expression to be added. If a conditional expression already exists in Abnormal condition and Warning condition, the conditional expressions are linked with AND.

Update button

If an existing conditional expression was edited, clicking this button updates the conditional expression selected in Abnormal condition or Warning condition with the conditional expression set in Record, Field, Condition, and Abnormal value and Warning value.

Both Abnormal value and Warning value must be specified for the updating to take place.

Abnormal condition

Lists the abnormal conditional expressions that have been set. To add conditional expressions here, set Record, Field, Condition, Abnormal value, and Warning value and then click the Add button. To change a conditional expression, select it and then click the Update button.

If you select an existing condition expression and then click the Add button, the selected condition expression and the added condition expression are enclosed in parentheses ( ( and ) ).

A maximum of five abnormal conditional expressions with a maximum length of 749 bytes each can be stored.

Warning condition

Lists the warning conditional expressions that have been set. To add conditional expressions here, set Record, Field, Condition, Abnormal value, and Warning value and then click the Add button. To change a conditional expression, select it and then click the Update button.

If you select an existing condition expression and then click the Add button, the selected condition expression and the added condition expression are enclosed in parentheses ( ( and ) ).

A maximum of five warning conditional expressions can be stored if the number of specified characters for each warning conditional expression is no more than 749 bytes.

Edit button

Displays the conditional expression selected in Abnormal condition and Warning condition in Record, Field, Condition, Abnormal value, and Warning value for editing. You cannot select multiple conditional expressions at the same time. This button is enabled only when at least one conditional expression is set in Abnormal condition and Warning condition.

Delete button

Deletes selected conditional expressions from Abnormal condition and Warning condition.

Delete All button

Deletes all conditional expressions from Abnormal condition and Warning condition.

Note:

If you want to generate an alarm that contains <, <=, >=, or > in the alarm condition expression, specify the abnormal condition so that it is within a more abnormal range as a system than the warning condition specification (the warning condition is contained within the abnormal condition).

The following are specification examples:

Example 1:

When the value of CPU% (CPU usage) is greater than 0 and less than 100

(A larger value is the abnormal value for a system.)

• Alarm condition expression that is evaluated correctly

  Abnormal > 90

  Warning > 80

• Alarm condition expression that is not evaluated correctly

  Abnormal > 50

  Warning > 80

Note: If you want to issue an alarm only for an abnormal status, use the same condition for abnormal and warning:

- Abnormal > 90

- Warning > 90

Example 2:

When the value of % Free Space (available disk space) is greater than 0 and less than 100

(A smaller value is the abnormal value for a system.)

• Alarm condition expression that is evaluated correctly

  Abnormal < 10

  Warning < 30

• Alarm condition expression that is not evaluated correctly

  Abnormal < 60

  Warning < 30

Note: If you want to issue an alarm only for an abnormal status, use the same condition for abnormal and warning:

- Abnormal < 10

- Warning < 10

(a) Search results: number-of-records record(s) window

This window displays the number of fields found by a search for each record when --All records-- was selected in Records to search in the New Alarm > Alarm Conditions > Search Fields or the Edit > Alarm Conditions > Search Fields window. In the search results, the record names are displayed in alphabetical order.

Cancel button

Returns to the New Alarm > Alarm Conditions or Edit > Alarm Conditions window.

Keywords to find

Enter search keywords. For details, see 1.7.4(3) New Alarm > Alarm Conditions > Search Fields or Edit > Alarm Conditions > Search Fields window.

Search button

Performs a search.

Records to search

From the pull-down menu, select the records you want to search. For details, see 1.7.4(3) New Alarm > Alarm Conditions > Search Fields or Edit > Alarm Conditions > Search Fields window.

Record name

A record name is followed by the following information:

• Number of fields that correspond to the search result

• Description of the record

  If there is no description, (No explanation provided) is displayed.

• Instance type

  (This record is a single-instance record.) or (This record is a multi-instance record.) is displayed.

Clicking the menu of a record name lists the corresponding fields of the selected record in the "Search results: List of number-of-fields field(s) found in record record-name" window.

(b) Search results: List of number-of-fields field(s) found in record record-name window

A list of fields is displayed as a search result.

Keywords to find

Enter search keywords. For details, see 1.7.4(3) New Alarm > Alarm Conditions > Search Fields or Edit > Alarm Conditions > Search Fields window.

Search button

Performs a search.

Records to search

From the pull-down menu, select the records you want to search. For details, see 1.7.4(3) New Alarm > Alarm Conditions > Search Fields or Edit > Alarm Conditions > Search Fields window.

Go to Record List button

Returns to the Search Results: number-of-records record(s) window. This button is displayed only when you have switched to this window from the Search Results: number-of-records record(s) window.

OK button

Returns to the New Alarm > Alarm Conditions or Edit > Alarm Conditions window. The selected field is in the status selected in the Field pull-down menu.

Radio buttons

Select a field. You cannot select multiple fields.

Selecting this item and clicking the OK button returns to the New Alarm > Alarm Conditions or Edit > Alarm Conditions window, and Field is updated to the selected field.

Note that when you return to the "Search results: number-of-records record(s)" window by clicking the Go to Record List button, the selection of the radio button is cleared.

Field name

Displays field names in alphabetical order. Bold characters indicate the characters that match with the search keyword.

Format

Displays the attribute of the corresponding field by using the following icons:

• : Numeric attribute

• : String attribute

Description

Displays a description of the field. Bold characters indicate the characters that match with the search keyword.

(a) Email Settings

Sets information needed for email notification. The settings in Email Settings are displayed only when email notification is set as an action in the New Alarm > Action window or the Edit > Action window.

Email address

Specify the email addresses of the parties to be notified by using no more than 127 bytes of alphanumeric characters.

If you specify multiple e-mail addresses, separate them with the comma (,).

Action handler

Text box

Use this text box to filter action handlers by keywords. Specify a character string of 1 to 1,024 characters to filter the action handlers that will be displayed. To use multiple conditions for an AND search, delimit keywords by using a single-byte space, a two-byte space, or a tab. A delimiter is counted as one word. The maximum number of words that can be entered as filtering keywords is 100.

Filter button

Filters action handlers by using the string specified in the text box.

Clear button

Clears the filtering status and the filtering condition.

Pull-down menu

From the pull-down menu, select the Action Handler service that sends an email. The Action Handler service name (service ID) that is displayed is the default.

If the Action Handler to be used is not included in the drop-down list, display the desired Action Handler's properties in the Services window, and in Capabilities set the property value for Email to Yes.

Variables

Displays variables that you can select to be set in the message text of the notification email. Select the desired variables from the displayed list, and then click the Add Variable button to add the selected variables to Email body as the message text for the email.

The following table lists and describes the variables that are displayed in Variables:

Item name	Variable name	Description
Date/Time	%SCT	Sets the system time at the host where the agent whose alarm was evaluated is running.
Agent name	%ANS	Sets the name of the agent to which the alarm table is bound.
Host name	%HNS	Sets the name of the host where the agent to which the alarm table is bound is running.
Status	%SCS	Sets the alarm condition that triggered output of the message.
Alarm name	%AIS	Sets the alarm name that was set in Alarm name in the New Alarm > Main Information window or the Edit > Main Information window.
Alarm table name	%ATS	Sets the alarm table name that was set in Alarm table name in the New Alarm > Main Information window or the Edit > Main Information window.
Message	%MTS#1	Sets the message text that was set in Message in the New Alarm > Main Information window or the Edit > Main Information window.
Product	%PTS	Sets the product name that was set in Product in the New Alarm > Main Information window or the Edit > Main Information window.
Measurement value	%CVS[n][.p]#2,#3,#4	Sets the measurement value that triggered the alarm issuance (that satisfied a conditional expression). n#5 Specifies as an integer the position of the field when more than one conditional expression is specified in the New Alarm > Alarm Conditions window or the Edit > Alarm Conditions window. 1 is specified for the first field. If 0 or a value greater than the number of conditional expressions is specified, the measurement value of the first field is displayed. p#5 For a field that is replaced with an integer or a decimal value Specifies the number of decimal places to be displayed (rounding). For a field whose measurement value is replaced with a string Specifies the position of a string that is to be displayed from the strings whose measurement value can be delimited by a single-byte space. If you want to specify the position, specify 1 or a larger value. If you specify 0, the measurement value is displayed as is. If you specify a value greater than the number of strings that are delimited by the single-byte space, a 0-byte string replaces the variable.

#1: If the alarm status changes from Abnormal or Warning to Normal for an alarm definition that uses multiple instance records, the value stored in the %MTS variable will be as follows:

• If the function for measurement value output at alarm recovery is enabled

  The alarm message text of the instance that triggered the last issued abnormal or warning alarm is stored until the alarm status returns to normal.

• If this function is disabled

  Because the value that triggered issuance of the event cannot be determined, the value is blank.

For details about the function for measurement value output at alarm recovery, see the chapter that explains operation monitoring by using alarms in the JP1/Performance Management User's Guide.

#2: If the alarm status changes from Abnormal or Warning to Normal for an alarm definition that uses multiple instance records, the value stored in the %CVS variable will be as follows:

• If the function for measurement value output at alarm recovery is enabled

  The current measurement value of the instance that triggered the last issued abnormal or warning alarm is stored until the alarm status returns to normal.

• If this function is disabled

  Because the measurement value that satisfies the condition expression does not exist, the <OK> string is stored. Accordingly, if a value of two or more is specified for p in %CVSn.p, %CVS is replaced with a zero-byte string.

For details about the function for measurement value output at alarm recovery, see the chapter that explains operation monitoring by using alarms in the JP1/Performance Management User's Guide.

#3: The maximum length of the character string generated by replacing the variable %CVS is 79 bytes.

#4: If the character string generated by replacing the variable %CVS contains |, the strings following the | will be omitted.

#5: Only a maximum of five digits can be specified for the value. If you specify six or more digits, only the first five digits are used and displayed in the message of the alarm notification.

Add Variable button

Adds the variables selected from Variables to Email body.

Email body

Specify the reply email message text by using no more than 1,000 bytes of single-byte or two-byte alphanumeric characters. The following text is already set as a standard in Email body:

Date/Time:%SCT
Host name:%HNS
 
Product:%PTS
Agent name:%ANS
 
Alarm name:%AIS(%ATS)
Status:%SCS
 
Message:%MTS

Note:

If the length of the message text that replaces the variable is more than 1,000 bytes, the Agent Collector or Remote Monitor Collector service outputs the KAVE00184-W message when the alarm is reported.

If this message appears, adjust the character string to be specified in the message string and the number of digits specified for %CVS so the message text length is no more than 1,000 bytes.

(b) Command Definition

Sets information needed for command execution. The settings in Command Definition are displayed only when command execution is set as an action in the New Alarm > Action window or the Edit > Action window.

Command name

Specify the name of the command (script) to be executed by using no more than 511 bytes of alphanumeric characters. For commands (scripts) other than the ones in the following directories, specify the absolute path or the relative path of the current directory of the service:

• Action Handler service installation directory

• Path set in the PATH environment variable

To specify a relative path, use the Services window to check the current directory of the Action Handler service.

Reference note:

In the Command name field, you can specify a command name that includes arguments. If the command path or command name to be specified includes at least one single-byte space character, enclose the command path or command name in double quotation marks (" ").

JP1 Event Settings button

Specifies that an event issuance command is to be specified.

Clicking this button displays the New Alarm > Action Definitions > JP1 Event Settings window or the Edit > Action Definitions > JP1 Event Settings window.

Action handler

Text box

Use this text box to filter action handlers by keywords. Specify a character string of 1 to 1,024 characters to filter the action handlers that will be displayed. To use multiple conditions for an AND search, delimit keywords by using a single-byte space, a two-byte space, or a tab. A delimiter is counted as one word. The maximum number of words that can be entered as filtering keywords is 100.

Filter button

Filters action handlers by using the string specified in the text box.

Clear button

Clears the filtering status and the filtering condition.

Pull-down menu

From the pull-down menu, select the Action Handler service that executes commands (scripts). LOCAL is displayed as the default, and it represents the host at which the agent to which the alarm table is bound is running.

To issue JP1 events for Performance Management monitoring by JP1/IM Central Scope, select the Action Handler service that is installed on the same host as the PFM - Manager. To issue JP1 events, note that JP1/Base is required on the same host as the Action Handler that issues the events. For details about Performance Management monitoring by JP1/IM, see the chapter that explains operation monitoring linking with the integrated management product (JP1/IM) in the JP1/Performance Management User's Guide.

If the service name (service ID) of the Action Handler to be used is not included in the drop-down list, use the Services window to display the properties of the desired Action Handler service, and then set Yes in Script under Capabilities.

Variables

Displays the variables that you can select to be set as command arguments.

Select desired variables from the displayed list of variables and then click the Add Variable button to add the variables to Command arguments as the command arguments.

The variables that can be set are the same ones that are described in Variables under Email Settings.

Add Variable

Adds the variables selected from Variables to Command arguments.

Command arguments

Specify no more than 2,047 bytes of single-byte alphanumeric characters or two-byte characters for a parameter to be passed to the command (script) that is to be executed.

To issue JP1 events to a logical host in a logical host environment, add the -r logical-host-name option. If the -r option is omitted, JP1 events will be registered in the physical host.

Note:

If the length of the command argument that replaces the variable is more than 2,047 bytes, the Agent Collector or Remote Monitor Collector service outputs the KAVE00184-W message when the alarm is reported.

If this message appears, adjust the character string to be specified in the command argument and the number of digits specified for %CVS so the command argument length is no more than 2,047 bytes.