active.list Definition/General

active.list

Command active.list Definition/General
Applicable release versions: AP, R83
Category General (155)
Description a list of strings to be used in a subsequent process that handles items one at a time. Generally, but not always, a list contains item-ids for subsequent processing, but a list may 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" may be created by any of the list-generating verbs, such as "get-list", "select", "sselect", etc., or by a Pick/BASIC program.

The "end" command may be used to "deactivate" an active list. See "end" for more information on the "double whammy" effect.
Syntax
Options
Example
sselect entity by name
[404] 18281 items selected out of 18281 items.
>

When this process returns to the TCL prompt, a list is "active". The 
list may be used by any subsequent process that processes items.

sselect entity by name
[404] 18281 items selected out of 18281 items.
>save-list entity.by.name

List 'entity.by.name' in file 'pointer-file' saved.

This example creates an active list, which is immediately "saved". 
Once a list is saved, it may be used repeatedly, until it is manually deleted.

sselect entity by name
[404] 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
[404] 18281 items selected out of 1 items.
>select entity with city "newport beach"
[404] 287 items selected out of 2718281 items.

A list may also be generated from an "active" list.
Purpose
Related access.select
access.sselect
tcl.iselect
tcl.save-list
tcl.delete-list
tcl.el
secondary.list
tcl.run-list
up.p
access.sreformat
basic.execute
tcl.verify-system
data.representation
basic.select
tcl.save
tcl.rmbi
up.x
tcl.edit-list
basic.readnext
tcl.get-list
tcl.ppcp
tcl.itemlist*
tcl.verb.classes
editor.fi
basic.tcl
tcl.indexer
runoff.readnext
access.nselect
tcl.copy-list
primary.list
op.readnext
basic.loop
op.readnext.null
editor.fdk
ue.1195
basic.system
up.xk
tcl.end
tcl.fl
tcl.compare-list
tcl.export.r83