GetUnivDiscrepancy

Returns system-generated discrepancy information, if there is any, for the response. Use this function to query specific system-generated discrepancies.

Syntax

short int GetUnivDiscrepancy(ResponseId *response_identifier,

    DiscInfo *return_discrepancy_info);

Parameters

response_identifier (in) The ResponseId definition containing the unique identifier for this response.

return_discrepancy_info (out) The DiscInfo containing the discrepancy information for this response.

Return Value

SUCCESS or FAILURE.

Comments

The response_identifier uniquely identifies the response that is being proceeded by the external system. Upon calling this function Oracle Clinical locates the response in its internal structure and gets the discrepancy information for this response into the input variables. The input variables, which are provided for holding the discrepancy information, should be allocated by the calling routine.

For existing documents, if a discrepancy has been previously added for this response, that information would be returned. The function returns FAILURE otherwise.

For new documents, if SetResponseData and/or SetUnivDiscrepancy has never been called for this response, the function returns FAILURE because no discrepancies exist. Otherwise, the discrepancy information created by the last SetResponseData and/or SetUnivDiscrepancy call would be returned. This applies also in the case of existing documents.

Error Messages

Table 7-23 Error Messages for GetUnivDiscrepancy

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.
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.

Related Functions

InitializeRdcmResponses, SetResponseData, SetUnivDiscrepancy