batch element

Attributes

<batch name>
/ file = path
/ groupAssignment = assignment
/ groups = (integer, integer, integer, ... of modulus)
/ onScriptBegin = { script }
/ onScriptEnd = { script }
/ requiredPermissions = (permission, permission, ...)
/ selectionMode = selectionmode
/ selectionMode = value
/ sessions = (integer, integer, integer, ... of modulus)
/ subjects = (integer, integer, integer, ... of modulus)
</batch>

Properties

batch.name.currentGroupNumber
batch.name.currentScript
batch.name.file
batch.name.groupCount
batch.name.selectionMode
batch.name.name
batch.name.typeName

Functions

None.

Remarks

The batch element should be defined in a separate script file. The batch element may not include own script file in its list of files.

Examples

The following batch runs three scripts files in sequence. The files are located in the same directory as the batch file.

<batch>
/ file="script1.iqx"
/ file="script2.iqx"
/ file="script3.iqx"
</batch>

The following batch runs three scripts files in different orders for even and odd numbered group ids. The files are located in the same directory as the batch file.

<batch>
/ groups=(1 of 2)
/ file="script1.iqx"
/ file="script2.iqx"
/ file="script3.iqx"
</batch>

<batch>
/ groups=(2 of 2)
/ file="script3.iqx"
/ file="script2.iqx"
/ file="script1.iqx"
</batch>

The following batch runs one of three depending on the session number. The files are located in the same directory as the batch file.

<batch>
/ sessions=(1 of 3)
/ file="phase1.iqx"
</batch>

<batch>
/ sessions=(2 of 3)
/ file="phase2.iqx"
</batch>

<batch>
/ sessions=(3 of 3)
/ file="phase3.iqx"
</batch>