tcl.save-list

Verb: Access/TCL, Releases: AP and R83

Saves active list.

Syntax

save-list {{file.reference} {listname}}

Description

writes the list of item-ids generated by a 'select', 'sselect', 'qselect' or 'get-list'.

If no file is specified, the pointer-file is used.

'save-list' must be invoked immediately after the verb that created the list.

'file.reference' is the file in which to save the list. If no file.reference is given, the list is saved in the pointer-file.

'listname' is the name of the list-item. If there is already an item with the specified item-id, it automatically overwritten by the new list. If no listname is specified, the default name, '%user.name', is used.

Example

sselect entity with area.code '714' by name
[404] 16782 items selected out of 272876 items.
save-list orange.county
List 'orange.county' in 'pointer-file' saved.

See Also

Command Name Type Description
tcl.el Verb: Access Edits saved list using Update processor.
tcl.sl Verb: Access
tcl.delete-list Verb: Access Deletes previously saved lists.
secondary.list Definition A list of item-id's generated by one of the list-generating processes while an active list is present.
filename.pointer-file File Contains saved lists.
tcl.get-list Verb: Access Retrieves previously saved list.
tcl.sort-list Verb: Access Retrieves, sorts and rewrites previously saved list.
tcl.qselect Verb: Access Creates active list from item(s).
active.list Definition A list of strings delimited by attribute marks created by one of the list-generating processes.
tcl.edit-list Verb: Access Edits saved list using line editor.
tcl.copy-list Verb: Access Copies previously saved lists.
UE.0195 User Exit Saves a select list
access.select Verb: Access Creates list of items meeting specific criteria.
tcl.fl Verb: Access Forms single list from two lists.
tcl.list-lists Verb: Access Sorts saved-lists in 'pointer-file'.
tcl.compare-list Verb: Access Compares two lists for intersections.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.