bstr_program_receive_request(3) — Subroutines
Name
bstr_program_receive_request − Receives a Program request (VODB only).
Syntax
bstr_t_status bstr_program_receive_request (
bstr_t_reference ∗program,
bstr_t_rcb ∗control,
bstr_t_program_request ∗request);
Description
The bstr_program_receive_request procedure allows the calling Program execution to receive a Program request. The information associated with the Program execution is returned in the data structure whose address is specified by request.
Arguments
program
access: read
The reference to the Program from which a Program request should be received.
control
access: read
The address of an optional request control block.
request
access: write
The address of a bstr_t_program_request type data structure in which the procedure returns the information associated with the received Program request.
Return Values
| BSTR_S_ABORTED | Operation aborted |
| BSTR_S_BAD_PARAMETER | Bad parameter value |
| BSTR_S_BAD_REFERENCE | Bad reference |
| BSTR_S_COMMUNICATION_ERROR | Communication error |
| BSTR_S_FINISH | Request aborted by bstr_finish |
| BSTR_S_INTERNAL_ERROR | Internal error |
| BSTR_S_INTR | Operation interrupted |
| BSTR_S_INVALID_NAME | Invalid name |
| BSTR_S_INVALID_OPERATION | Invalid operation |
| BSTR_S_INVALID_RCB | Invalid Request Control Block |
| BSTR_S_INVALID_USAGE | Invalid reference usage |
| BSTR_S_NORMAL | Normal successful completion |
| BSTR_S_NOT_INITIALIZED | BASEstar Open not initialized |
| BSTR_S_NO_MEMORY | Insufficient virtual memory |
| BSTR_S_SERVER_NOT_REACHABLE | Server not reachable |
| BSTR_S_TIMEOUT | Timeout expired |
| BSTR_S_TOO_MANY_REQUESTS | Too many pending requests |