Nagios Core External Commands

< Back to external commands list

SCHEDULE_HOST_CHECK

Command Format:
SCHEDULE_HOST_CHECK;<host_name>;<check_time>
Description:

Schedules the next active check of a particular host at "check_time". The "check_time" argument is specified in time_t format (seconds since the UNIX epoch). Note that the host may not actually be checked at the time you specify. This could occur for a number of reasons: active checks are disabled on a program-wide or service-specific basis, the host is already scheduled to be checked at an earlier time, etc. If you want to force the host check to occur at the time you specify, look at the SCHEDULE_FORCED_HOST_CHECK command.

Shell Script Usage Example:
#!/bin/sh
# This is a sample shell script showing how you can submit the SCHEDULE_HOST_CHECK command
# to Nagios. Adjust variables to fit your environment as necessary.

now=`date +%s`
commandfile='/usr/local/nagios/var/rw/nagios.cmd'

/bin/printf "[%lu] SCHEDULE_HOST_CHECK;host1;1110741500\n" $now > $commandfile    
Command Categories:

Hosts
Service and Host Checks

Nagios Version(s):

2.x, 3.x, 4.x

Nagios, Nagios Core, NRPE, NSCA, and the Nagios logo are trademarks, servicemarks, registered servicemarks or registered trademarks of Nagios Enterprises. All other trademarks, servicemarks, registered trademarks, and registered servicemarks mentioned herein may be the property of their respective owner(s). The information contained herein is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.