kcalarm.1m (2012 03)

k
kcalarm(1M) kcalarm(1M)
initial sends a notification from the first polling, and each time the threshold is
exceeded (once per set of polls when the tunable exceeds the threshold).
repeat sends a notification any time the tunable is polled and its value exceeds
the specified threshold (this can lead to a large number of messages if the
polling interval is small).
return sends a notification at the first polling at which resource usage falls
below threshold after exceeding it.
The
-e option can be specified multiple times to provide combinations of initial, repeat,
and return.
If no
-e is provided with the
-a option, the alarm will be added with the initial event
type by default.
-i interval This specifies how often the tunable data will be sampled (in minutes). If no interval is
specified with the -a
option, an interval of 5 minutes will be used by default.
-c comment This is a user provided string to help identify the alarm request. This text is included in
notifications. The comment is empty by default.
-k key Unique key used to disambiguate alarms from each other. Can be used with
-s, -d and
when listing. The value of the key is displayed when listing with the
-l (long) option.
-n notification
Notification target if an alarm is triggered, where notification is a colon separated string
(in quotes if it contains any spaces) in the form: notification_target
:[data]:[port]
The
kcalarm command uses the Event Monitoring Service (EMS) infrastructure, and
therefore supports any of the notification targets supported by EMS (see ems(5)). Valid
choices are:
opcmsg:(normal|warning|minor|major|critical):
This option can be used with OpenView/IT/Operations notifications.
(tcp|udp):host:port
This option is used for any application that accepts these protocols and follows the
rules defined in the EMS Developer’s Kit.
snmp:(normal|warning|minor|major|critical):
This option can be used with any application that accepts SNMP traps, such as
OpenView NNM, or IT/O. The application must be setup to recognize the SNMP
traps generated.
email
:address :
This option causes an email to be sent to the specified address when an alarm is
triggered. If a comment is provided, it will be included in the body of the email mes-
sage.
syslog::
This option causes notifications to be written to syslog on the local system. If a
comment is provided, it will be included in the syslog entry.
textlog
:filename :
This option causes notifications to be written to the specified filename on the local
system. If a comment is provided, it will be included in the textlog entry.
console::
This option causes notifications to be written to the system console on the local sys-
tem. If a comment is provided, it will be included.
-l Long listing in machine readable format. By default output is in human readable format.
Note that output will not be localized when the -l option is specified.
-s (on|off) Set the status of an alarm for the specified tunable(s), either on or off. This option allows
temporarily disabling alarms without deleting them. If multiple alarms exist for a given
tunable, -k, -t, -e, -i, and -n options can be used to clarify the on/off request.
-m (on|off|status)
Turn kernel tunable monitoring on, off, or check the present status. This option is on by
default when the Kernel Configuration tool is installed. This option must be on in order
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: March 2012