Home > MultiValue Central > Online D3 Reference > TCL > tcl.get-list

tcl.get-list

Verb: Access/TCL, Releases: R83 and AP

Retrieves previously saved list.

Syntax

gl {{file.reference} list.name {list.name...} } {(attr.ref} {(options} get-list {{file.reference} list.name {list.name...} } {(attr.ref} {(options}

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.

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.

See Also

Command Name Type Description
tcl.copy-list Verb: Access Copies previously saved lists.
tcl.save-list Verb: Access Saves active list.
access.select Verb: Access Creates list of items meeting specific criteria.
tcl.el Verb: Access Edits saved list using Update processor.
tcl.delete-list Verb: Access Deletes previously saved lists.
access.nselect Verb: Access Performs 'not' select - only items not there.
tcl.copy Verb: Access Copies items to output devices or between files.
runoff.readnext Command Gets next item-id from active list.
op.readnext Command Reads data from active list.
tcl.qselect Verb: Access Creates active list from item(s).
access.sselect Verb: Access Creates sorted list of items meeting specific criteria.
active.list Definition A list of strings delimited by attribute marks created by one of the list-generating processes.
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.sort-list Verb: Access Retrieves, sorts and rewrites previously saved list.
tcl.gl Verb: Access Invokes 'get-list' command.
tcl.edit-list Verb: Access Edits saved list using line editor.
basic.readnext Statement Retrieves the next item-id from an active list.
ue.1195 User Exit Gets the next item from an active list
tcl.fl Verb: Access Forms single list from two lists.

User Comments

What do you think?

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

Login to leave your comments.