tcl.get-list Verb: Access/TCL

tcl.get-list

Command tcl.get-list Verb: Access/TCL
Applicable release versions: R83, AP
Category TCL (746)
Description activates an item-list from a file. The default file is the "pointer-file".

Multiple list.names may be specified to create longer lists. If the optional "file.reference" is used the specified file is used to retrieve the item. "list.name" is the list that contains attributes to place in the active list. If more than one "list.name" is specified, the lists are concatenated into a single list.

If no "list.name" is specified, the default name, "%user.name", is used.

"attr.ref" indicates an attribute name or number. This creates a list from the specified attribute. Note that temporary attribute-defining items may also be used.
Syntax gl {{file.reference} list.name {list.name...} } {(attr.ref} {(options}
get-list {{file.reference} list.name {list.name...} } {(attr.ref} {(options}
Options s Creates a "secondary" list.
u Inhibits selection of duplicated items within multiple lists.
Example
gl xx yy
[404] 358 items selected out of 2 items.
>

get-list duplicates
[404] 67 items selected out of 1 items.
>     

get-list old.invoices new.invoices (u
[404] 405 items selected out of 2 items.
This combines the two lists, "old.invoices" and 
"new.invoices" into one list. The "u" option eliminates 
redundant references within the list.
Purpose
Related tcl.copy-list
tcl.save-list
access.select
tcl.el
tcl.delete-list
access.nselect
tcl.copy
runoff.readnext
op.readnext
tcl.qselect
access.sselect
active.list
secondary.list
filename.pointer-file
tcl.sort-list
tcl.gl
tcl.edit-list
basic.readnext
ue.1195
tcl.fl
tcl.compare-list