NIPO ODIN Version 5.17

Previous Topic

Next Topic

Return Codes for *NEXTRECORD

If the execution of the *NEXTRECORD fails, the variable will contain a (negative) return code value.

The Fieldwork Manager is alerted with a message. No run-time error is produced, the interview can continue as normal. However, the NIPO ODIN script writer may use this return code to display a warning to the interviewer, if required, or choose an alternate routing through the script.

Return Code Values for *NEXTRECORD

Return Code   Description

-1

Sample record is claimed by the system. Either the NIPO FMS or the NIPO CATI / Web Master has claimed this record for use. In either case, it cannot currently be accessed for interviewing.

The related error message is "Error in *NEXTRECORD: sample record <interview number> is not valid for interviewing. Error in survey <survey>".

-2

Sample record contains a definitive response code (refusal, completed successfully, et cetera).

An existing record may only contain non-definitive response codes. The related error message is "Error in *NEXTRECORD: sample record <interview number> is not valid for interviewing. Error in survey <survey> "

-3

There is no Sample table present for the survey. This is a blocking error - the survey will halt in an error status. The related error message is "Error in *NEXTRECORD: no sample table present. Error in survey <survey>".

-4

The configured InterviewNumber value is not correct. For example he interview number entered is negative. It must be an integer with value 0 to 99999999. The related error message is "Error in *NEXTRECORD: sample record <interview number> is not valid for interviewing. Error in survey <survey>"

-5

Workstation could not contact NIPO CATI / Web Master. A connection with the NIPO CATI / Web Master is required for this command to execute correctly. The interview halts at the end of the contact.

-6

System error. The sample record could not be created or accessed. This usually indicates an MS SQL Database problem. The related error message is "Database error in <database>. Error in *NEXTRECORD: sample record <interview number> is not valid for interviewing. Error in survey <survey>"

-7 / unchanged

Command is not executed in the correct channel: *NEXTRECORD is only supported for NIPO CATI.

Note that the *NEXTRECORD command has no effect on the Sample table if any of the errors occurred.

See Also