A. Run Time Error Messages

These are the errors that Bunao modules can generate at runtime, that usually represent a problem in the Bunao script. They are not the error messages produced by the Bunao program while creating the script (those are Bunao bugs that need to be fixed!)

Note that all errors are writen to standard error. Without shell redirection, they just go to the screen.

Counter Balance number_subjects must agree with Subject Loop.
CounterBal subjs=subjs, Subject Loop subjs=TOTALSUBJS.

Module: LM::CounterBalance The number of subjects given in the Counterbalance module must agree with the number of subjects in the enclosing Subject Loop.

Counter Balance error: number of subjects must equal number of groups
CounterBal subjs=$subjs, number of groups=[llength $ranges]

Module: LM::CounterBalance The number of groups of item ranges (eg, `1-5, 6-10, 11-15' is Three ranges) must equal the the number of subjects.

Counter Balance syntax error: group range must be specified as <beg>-<end>
Entry given: $e

Module: LM::CounterBalance Item range in a group must be given as two integers separated by dash (`-').

Counter Balance warning: group ranges not contiguous
Last group ended at $i, this one starts at $beg

Module: LM::CounterBalance Group ranges must be contiguous. For example the ranges `1-5, 7-10' have a gap at index 6.

Counter Balance warning: last group doesn't end at number of items
Last group range: [lindex $ranges end]; number of items: $numitems

Module: LM::CounterBalance Group ranges must include all items. For example, if the number of items is 30, the ranges `1-10, 11-20, 21-25' doesn't end at the number of items.

Counter Balance: number of source and dest arrays must be equal
Src List: sourcelist
Dest List: destlist

Module: LM::CounterBalance Equal number of arrays must be specified in the source and destination boxes in the AME.

invalid rantype : rantype

Module: LM::Randomize The randomization type must be either `pointers' or `elements'. Scripts generated by the Bunao graphical interface will never have this error.

Set srcName exhuasted

Module: LM::Assign Overdraw attempted on set srcName. Most commonly, this means a set needs to be re-randomized before drawing more elements from it.

No free location meets restrictions.
Unable to find location for line data

Module: LM::BlockItem Not a fatal error. Bunao couldn't fit the line data in the block it was trying to generate. Unless it has reached the maximum number of tries, it will attempt again (with different randomizations).

Expression out of bounds.
Unable to find location for line data

Module: LM::BlockItem The location for line data was given explicitly but it was invalid (either less than 1 or greater than the number of items in the block).

Mandatory assignment to filled slot.
Unable to find location for line data

Module: LM::BlockItem Not a fatal error. The location for line data was given explicitly there was already an element assigned to that slot in the block. Unless it has reached the maximum number of tries, it will attempt again (with different randomizations).

BlockArray ERROR: array arr1 size (X) is not the same as arr2 size (Y)

Module: LM::BlockArray Fatal error. In the Data field of LM::BlockArray, all arrays used must be the same size. If a variable and not an array appears in the Data field, this message will also be produced.

BlockArray ERROR: location array arr1 size (X) is not the same as arr2 size (Y)

Module: LM::BlockArray Fatal error. If the Specific field has an array, it must be the same size as all arrays in the Data field of LM::BlockArray. If a variable and not an array appears in the Specific field, this message will also be produced.

Abandoning hope of ever succeeding after blockTries attempts.

Module: LM::Block Bunao can not generate the block with the restrictions specified. Either the restrictions are mutually incompatible, or the odds of being able to generate the block by Bunao's algorithms is too low.

Scrapping list and attempting try # blockTries

Module: LM::Block Bunao couldn't generate the block with the restrictions specified, but it will try again.

Read Formatted File: groups-of-fields list must be same size as recs-per-field list

Module: STD::ReadForm The Grps of Flds;Recs per Fld field takes two comma separated lists, themselves separated by a semicolon. These two lists, the number of groups of fields and the number of records per field, must have the same number of items (which is the number of groups).

Read Formatted File: sum of groups-of-fields list must be equal to number of arrays given

Module: STD::ReadForm The sum of the groups-of-fields lists is the total number of fields in the file, which must be equal to th number of array fields actually listed in the STD::ReadForm listcontrol.

ReadForm: if not blank, Index list must be same size as groups-of-fields list

Module: STD::ReadForm If the Index field is blank, then all arrays are loaded from position 1. If not blank, it must have an element for each group, and so must be the same size as the groups-of-fields (and the recs-per-field) lists.

Unexpected EOF. STD::ReadForm wanted limit records, but only read recnum.

Module: STD::ReadForm A limit was specified to STD::ReadForm but there were not enough fields.

warning: destination array not big enough

Module: STD::ArrAssign Non fatal erorr. This warning means ranges were specified on the destination array for an array assignment (mapping), but they weren't big enough for all the source items specified. The remaining source items were skipped.

warning: source array not big enough

Module: STD::ArrAssign Non fatal error. This warning means ranges were specified on the destination array for an array assignment (mapping), but there weren't enough source elements. The remaining destination elements are untouched.

Unexpected EOF.

Module: STD::ReadRaw The STD::ReadRaw module saw a premature end of file on the stream it was reading from.

Bunao program terminating with call to STD::End.

Module: STD::End Not an error. The STD::End module prematurely terminates the list.

Unexpected end of input parsing S

Module: All modules Bunao expected another character in the expression. This error could happen, for example, when a backslash (escape characters) isn't followed by anything to escape.

Expected an opening quote.

Module: All modules Bunao thought it was going to read a string, but didn't see an opening quote. Scripts generated by the Bunao graphical interface will never have this error.