NAME¶

handler-status - (program-execution)

PURPOSE¶

Set handler return status.

SYNTAX¶

handler-status <request status>

DESCRIPTION¶

handler-status specifies <request status>, which must be a number.

<request status> can be obtained with "handler-status" clause in read-remote in the service caller.

When the program runs as command-line, <request status> is program's exit code.

handler-status can be specified anywhere in the code, and does not mean exiting the request's processing; to do that, either use exit-handler or simply allow the handler to reach its end.

When handler-status is not used, the default exit code is 0. When multiple handler-status statements run in a sequence, the request status is that of the last one that executes.

If you want to specify request status and exit request processing at the same time, use exit-handler.

EXAMPLES¶

When the program exits, its exit code will be 12:

handler-status 12
...
exit-handler

SEE ALSO¶

Program execution

exec-program handler-status See all documentation