Unlike
B_ReadRequest, this call returns as soon the BIS Request Handler accepts the
output file. This function call does not block waiting for a response from BIS.
After writing a response, the service program will normally either call
B_ReadRequest or terminate.
The BIS Service Engine starts the service timer when this function returns. The program has 30 seconds to perform one of these
actions:
Call
B_ReadRequest.
Call
B_SetServiceTimeout. A parameter of
0 restarts the service timer.
Terminate.
If the service program processes for more than 30 seconds without performing one of the above functions, the BIS Service Engine
assumes the service program is lost and begins termination processing (as if a
StopService tag had been rendered).
Other codes may also be returned, but that normally indicates a serious problem has occurred.
By default, the response is sent back to the client with the HTTP status of
OK, which is the value 200. However, the function
B_SetResponseStatus may be used to alter the HTTP status returned.