SetDataComment
Use this function to modify a comment. This function updates the investigator comment, if any, for the response in the Oracle Clinical internal structure.
Syntax
short int SetDataComment(ResponseId*response_identifier;
DataComment*data_comm);
Parameters
response_identifier (in) The ResponseId definition containing the unique identifier for this response.
data_comm (in) A DataComment structure containing the data (investigator) comment for this response.
Return Value
SUCCESS or FAILURE.
Comments
The response_identifier uniquely identifies the response that is being processed by the external system. Upon calling SetDataComment, Oracle Clinical locates the response in its internal structure and updates the data (investigator) comment information for this response from the input variables provided for holding this information. These input variables should be allocated and initialized before calling the routine.
Error Messages
Table 7-29 Error Messages for SetDataComment
| Number | Severity | Message |
|---|---|---|
|
284800 |
ERR |
Function not available in this mode. |
|
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. |
|
286700 |
ERR |
Cannot locate the corresponding DCM question in the internal OCL buffers for the DCM question ID passed. |
|
286800 |
ERR |
No response in the internal buffers for the question. |
|
286900 |
ERR |
No existing univariate discrepancy for the question. |
|
287000 |
ERR |
DCM question and DCM question group combination does not exist in DCM. |
|
287100 |
ERR |
DCM question group does not exist in DCM. |
|
288000 |
ERR |
Repeat sn does not exist for DCM question group. |
|
304600 |
ERR |
Function does not exist. |
|
304700 |
ERR |
Privilege does not exist. |
|
306800 |
ERR |
Invalid audit reason. |
|
659700 |
ERR |
No default audit reason. |
|
659800 |
ERR |
More than one default audit reason found. |
|
660000 |
ERR |
Cannot use system-generated audit reason. |
Related Functions
Parent topic: Data Capture API Functions