DeleteRepeat

Deletes a question group repeat from the API responses buffer.

Syntax

short int DeleteRepeat(RepeatId*repeat_identifier );

Parameters

repeat_identifier (in) A parameter of type RepeatId, which contains the unique identifier for the question group repeat and the AuditInfo structure for this repeat.

Return Value

SUCCESS or FAILURE.

Comments

This function re-sequences all repeats following the one that was deleted, if any, by subtracting 1 from the repeat sequence number for all questions in the group in those repeats.

Error Messages

Table 7-5 Error Messages for DeleteRepeat

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.

297100

ERR

DCM question group does not exist in the DCM.

287800

ERR

Cannot delete repeats in browse mode.

287900

ERR

Cannot delete repeat for a non-repeating question group.

288000

ERR

Repeat sn does not exist for DCM question group.

288100

ERR

Cannot delete for repeating defaults when repeat is less than the maximum repeats for DCM question group.

297000

ERR

Null or invalid input pointers provided.

302600

ERR

No existing manual discrepancy for this question.

306800

ERR

Invalid audit reason.

313600

WRN

You have privileged update and have deleted repeating default when repeat sn is less than the maximum repeats for DCM question group.

659700

ERR

No default audit reason.

659800

ERR

More than one default audit reason found.

660000

ERR

Cannot use system-generated audit reason.

685900

ERR

Audit comment for Deletion of Repeat cannot have more than 158 bytes.