WriteResponses
This function reviews the response data in the buffers, verifies that they are clean, and then sends it to the Oracle Clinical database. If this function detects an incomplete flag (used, for example, if the operator has not finished the work and will complete it after lunch), the response data remains in the buffers. Otherwise the function writes the data to the database and commits. Then it either preserves the lock on the API RDCI record or releases it based on the value of the parameter preserve_lock.
Syntax
short int WriteResponses(DCIAPIFlagincomplete,
DCIAPIFlagpreserve_lock,ResponseId*response_identifier);
Parameters
incomplete (in) – Specify whether responses should be saved in incomplete mode. Value is TRUE or FALSE.
preserve_lock (in) – A flag indicating whether the lock on the API RDCI record should be preserved or released. If the value is TRUE, the lock will be kept and if it is FALSE, it will be released.
response_identifier (out) – A ResponseId structure containing the unique identifier of the failed response.
Return Value
SUCCESS or FAILURE or WARNING.
Comments
None.
Error Messages
Table 7-40 Error Messages for WriteResponses
| Number | Severity | Message |
|---|---|---|
|
284900 |
ERR |
User does not have the privilege to call function in the current mode. |
|
285000 |
ERR |
Function called out of sequence. |
|
285900 |
ERR |
No current OCL database connection open. Use ConnectOCL to connect to OCL database. |
|
286600 |
ERR |
Audit reason required and not provided. |
|
288300 |
ERR |
The API RDCI record is not locked. |
|
288400 |
ERR |
The completion flag is not compatible with the data entry mode. |
|
288500 |
WRN |
Write responses called but no changes are pending. |
|
288600 |
ERR |
Blank repeats exist. |
|
288700 |
ERR |
Mandatory field missing. |
|
293800 |
WRN |
You are working with a data locked record and have privileged update. |
|
294200 |
ERR |
An error occurred while processing the Received DCI structure and updating the PATIENT_DM_TRACKING table. |
|
294300 |
ERR |
An error occurred while processing the Received DCM structure and updating the Received DCI. |
|
300700 |
WRN |
Patient is frozen. The RDCI record will behave as if it were fetched in non-locking mode. |
|
303500 |
ERR |
Document contains empty repeats. |
|
304600 |
ERR |
Function does not exist. |
|
304700 |
ERR |
Privilege does not exist. |
|
306400 |
ERR |
Too many current actual events. |
|
306500 |
ERR |
Unable to release lock. |
|
308600 |
ERR |
Record changed by another user. |
Related Functions
Parent topic: Data Capture API Functions