Handler status

Purpose: Set handler return status.

 handler-status <request status>

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


Copyright (c) 2019-2024 Gliim LLC. All contents on this web site is "AS IS" without warranties or guarantees of any kind.