Obtain the service@host pairs whose status is of the specified type. Addressed will match all those acknowledged or inhibited, error will match all those not MODEXEC_OK, escalated will match all those escalated, whether automatically or manually, stalled will match any pair that has not been checked within a reasonable time of its next scheduled check.

While this command is executing, ^C will terminate the current Check and ^Z will terminate the entire command.

The Alert Plan keywords do not clear state and clear state honors can be used to adjust which return codes cause acknowledgements to be cleared.

If result text significant is defined for the check, a comment change will also clear the acknowledgement.

Retrieve the alert history records, optionally limited by fromtime and untiltime. If the reverse flag is provided, retrieve most recent history first.

Retrieve the check history records, optionally limited by fromtime and untiltime. If the reverse flag is provided, retrieve most recent history first.

Retrieve the command history records, optionally limited by fromtime and untiltime. If the reverse flag is provided, retrieve most recent history first.

Retrieve the fix history records, optionally limited by fromtime and untiltime. If the reverse flag is provided, retrieve most recent history first.

Execute the report module module for the data type specified. The report will be generated for each of the specified services on each of the specified hosts for the time period specified by the -f and -u flags, or for all available history if neither flag is specified. If the reverse flag is provided, the most recent history will be processed first.

At least one service and at least one host must be provided.

Set service@host to have the specified returncode, as if the check failed or exited with that value. If a comment was provided via -c, the human readable comment will be set to it. This command is intended primarily for debugging.

Obtain the calendar for the specified calllist, showing who is on call, including any substitutions. Note that Broadcast Call Lists do not have calendars.

If person is provided, only information for that Person will be displayed. If no begin time is provided with -f, the current time will be used. If no end time is provided with -u, the calendar will continue until the Call List cycles.

Add a substitution, having substitutor replace substitutee. The beginning and end times of the substitution must be specified using the -f and -u flags.

The substitutor must be defined as a member of the Call List. The substitutee need not be on call during the exact time of the substitution. The replacement will only take effect while the substitutee is on call.

To remove all past substitutions, use clprune.

Set person to be the currently on call Person for the Call List. For Simple Call Lists, person will be considered the last Person notified.

When the all flag is used, all history is archived. For active history, the time period specified by -f and -u applies. If either is omitted, then archiving begins at the beginning or ends at the end, respectively. If both are omitted, all available history is archived. The all flag also implies the stale flag.

When the stale flag is used, all history for services or hosts that are no longer actively defined in the configuration files (hosts must be in a HostClass, services must be defined as Checks, and the hosts must be a member of the Group with the same name as the service in order to be considered actively defined) are archived. Time period specification via -f and -u does not apply.

Note that there is a minor race condition when archiving stale history. If the configuration files are updated while archiving, what was stale could become valid again, and what was valid could become stale. For this reason, it is recommended that configuration files not be updated while archiving stale history.

Note also that when archiving stale history, the old history files will be removed. The old directories in which these files resided will only be removed if the archivehistory command is run by the survivor user or by root.

When history is archived, all entries within the requested time range are transferred from the history files to the specified destination. If the destination given is directory, a new tree is created under the path named. If the destination given is file, all records are appended to that file, prefixed with the type of history record, the service, and the host.

Note that when history is archived to a file, archiving is subject to operating system imposed file size limits. Ordinarily, this limit is 2GB. (If the package is built using a 64-bit compiler, this limit would not apply. This is not the default and has not been tested.) When large amounts of history are to be archived, using a directory tree is recommended. The system should detect when the file size limit has been reached, and fail gracefully.

Any history records not archived remain in their existing history files.

By default, this command is disabled. To enable it, edit instance.cf.

Archive the history for the specified services and/or hosts. The period archived is specified by -f and -u. If either is omitted, then archiving begins at the beginning or ends at the end, respectively. If both are omitted, all available history is archived.

When history is archived, all entries within the requested time range are transferred from the history files to the specified destination. If the destination given is directory, a new tree is created under the path named. If the destination given is file, all records are appended to that file, prefixed with the type of history record, the service, and the host.

Note that when history is archived to a file, archiving is subject to operating system imposed file size limits. Ordinarily, this limit is 2GB. (If the package is built using a 64-bit compiler, this limit would not apply. This is not the default and has not been tested.) When large amounts of history are to be archived, using a directory tree is recommended. The system should detect when the file size limit has been reached, and fail gracefully.

Any history records not archived remain in their existing history files.

By default, this command is disabled. To enable it, edit instance.cf.