An active list is a list of strings for use in a subsequent process that handles items one at a time. Typically, a list contains item-IDs for subsequent processing, but a list can actually contain anything. For example, the statement, select entity creates a list of item-IDs, while the statement, select entity name creates a list from the contents of each entity item’s name attribute.
A list can be created by any of the list-generating commands, such as get-list, select, sselect, and so on, or by a FlashBASIC program.
The end command can be used to deactivate an active list.
Once a list is active, the next command issued at TCL must be a valid list-processing command, otherwise the list is deactivated. For example:
The active list has been released.
:sselect entity by name  2718281 items selected out of 2718281 items. >time 06:44:22 19 Jan 2002 Saturday
When this process returns to the TCL prompt, a list is active. The list can be used by any subsequent process that processes items.
:sselect entity by name  18281 items selected out of 18281 items. >
This example creates an active list, which is immediately saved. Once a list is saved, it can be used repeatedly, until it is manually deleted.
:sselect entity by name  18281 items selected out of 18281 items. >save-list entity.by.name List ’entity.by.name’ in file ’pointer-file’ saved.
A list can also be generated from an active list.
:sselect entity by name  18281 items selected out of 18281 items. >save-list entity.by.name List ’entity.by.name’ in file ’pointer-file’ saved. :get-list entity.by.name  18281 items selected out of 1 items. >select entity with city "newport beach"  287 items selected out of 2718281 items.
.readnext command (Runoff), .readnext null command, compare-list command, copy-list command, Data representation, delete-list command, edit-list command, end command (TCL commands), execute statement (UNIX), fdk command, fi command, fl command, get-list command, indexer command, iselect command, loop statement, nselect command, Primary list, readnext statement, rmbi command, run-list command, save command, save-list command, Secondary list, nselect command, clearselect statement, sreformat command, sselect command, system() function, tcl statement, u1195 user exit, verify-system command