The scds_timerun() function executes a specified command using hatimerun(1M). If the command does not complete within the allotted time period,which is specified by the timeout argument, scds_timerun() sends a signal, specified by the signal argument, to kill it.

The command argument does not support I/O redirection. However, you can write a script to perform redirection and then identify this script in the command argument as the command for scds_timerun() to execute.

The following parameters are supported:

handle

The handle returned from scds_initialize(3HA)

command

String containing the command to run

timeout

Time, in seconds, allotted to run the command

signal

Signal to kill the command if it is still running when the timeout expires. If signal = -1, then SIGKILL is used. See signal(3head).

cmd_exit_code

Return code from execution of the command

The scds_timerun() function returns the following:

0

The function succeeded.

non-zero

The function failed.

SCHA_ERR_NOERR

The command executed and cmd_exit_code contains the child program's exit status.

SCHA_ERR_INTERNAL

The timeout did not occur, but some other error was detected by scds_timerun() that was not an error detected by the child program. Or hatimerun(1M) caught the signal SIGTERM.

SCHA_ERR_INVAL

There was an invalid input argument.

SCHA_ERR_TIMEOUT

The timeout occurred before the command specified by the command argument finished executing.

See scha_calls(3HA) for a description of other error codes.

/usr/cluster/include/rgm/libdsdev.h

Include file

/usr/cluster/lib/libdsdev.so

Library

See attributes(5) for descriptions of the following attributes:

hatimerun(1M), scds_initialize(3HA), scha_calls(3HA), signal(3head), attributes(5)