CAT_SELCT - Create a selection of rows satisfying some expression

Description:

Create a selection of rows satisfying some expression.

The selection may be created from either a genuine catalogue or some previous selection from a catalogue.

The expression can involve both indexed and unindexed columns. If indexed columns are involved, they are NOT used to optimise the selection.

Invocation:

CALL CAT_SELCT (CI, EI, REJFLG; SI, NUMSEL, SIR, NUMREJ; STATUS)

Arguments:

CI = INTEGER (Given)

Input catalogue or selection from which the new selection is to be generated. Note that CI may be either a catalogue or a selection identifier.

EI = INTEGER (Given)

Identifier to the logical expression defining the selection criteria.

REJFLG = LOGICAL (Returned)

Flag indicating whether or not a second selection of the rejected rows is to be created: .TRUE. - create the catalogue of rejected rows, .FALSE. - do not create the catalogue of rejected rows.

SI = INTEGER (Returned)

Selection identifier to the set of selected rows.

NUMSEL = INTEGER (Returned)

Number of rows selected.

SIR = INTEGER (Returned)

Optional selection identifier to the set of rejected rows. If the rejected rows are not being retained then SIR is set to the null identifier.

NUMREJ = INTEGER (Returned)

Number of rows rejected.

STATUS = INTEGER (Given and Returned)

The global status.

Copyright

Copyright (C) 1999 Central Laboratory of the Research Councils

Bugs:

None known