OR-LISTS

Returns a list comprising one copy of any value contained in any of two or more lists, that is, the union of the lists.

Syntax

OR-LISTS list-name list-name {list-name}...  {(options}

Syntax Elements

list-name The name of a saved list.

Options

I Specifies that case should be ignored when comparing attribute values.

S Specifies that case is significant when comparing attribute values.

Comments

Only the first field (value or subvalue) is processed, all the other fields being discarded. The merged list therefore contains only the first field from each attribute.

Case Sensitivity

If neither I nor S is specified, the current data case setting (set with the DATA.CC environment option or the CASE TCL command) is used. See Case Sensitivity for more details.

If both I and S are specified an error message is displayed and no list is generated.

Examples

:OR-LISTS OVERDUE LARGEAMT

429 Items selected.

>SAVE-LIST PHONECALL

[241] 'PHONECALL' Cataloged.

All values that were in either list OVERDUE or LARGEAMT are now in list PHONECALL.

:OR-LISTS SMKR DRNK OVFF OVWT

7899 Items selected.

>SAVE-LIST ATRSK

[241] 'ATRSK' Cataloged.

The list in ATRSK contains one copy of all values that were in any list referenced in the OR-LISTS command.