NIPO ODIN Version 5.17
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.
|