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.