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