OR-ITEMS

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

Syntax

OR-ITEMS file-specifier {item-list} {(options}

Syntax Elements

file-specifier Specifies a file as defined in General Conventions.

item-list A list of item-ids or an asterisk (*) for all items. Can be omitted there is an active list from a preceding list-generating command.

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-ITEMS BOOKS SHIPS PIRATES

42 Items selected.

>SAVE-LIST SPLIST

[241] 'SPLIST' Cataloged.

All values that were in either item SHIPS or PIRATES in file BOOKS are now in list SPLIST.

:OR-ITEMS POISONS CRAMPS SWEAT NUMBNESS

37 Items selected.

>SAVE-LIST MSW

[241] 'MSW' Cataloged.

The list in MSW contains all values that were in any item CRAMPS, SWEAT, or NUMBNESS in file POISONS.