Description:
Create a selection
from an array of row numbers.
The selection may be created from either a genuine catalogue or some previous selection from a
catalogue.
Invocation
CALL CAT_SLIST (NUMSEL, SELIST, CRIT, REJFLG, CI; SI, SIR, NUMREJ;
STATUS)
Arguments
NUMSEL = INTEGER (Given)
Number of rows to be selected.
SELIST(NUMSEL) = INTEGER (Given)
Array of row numbers to be selected. These row numbers
must be rows in the catalogue or selection to which CI corresponds. That is, if CI corresponds to a
catalogue they will be absolute row numbers. However, if CI is a selection they will be row numbers
in the selection, NOT the corresponding row numbers in the underlying catalogue.
CRIT =
CHARACTER()
(Given)
Character string summarising the selection criteria.
REJFLG = LOGICAL (Given)
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.
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.
SI = INTEGER (Returned)
Selection identifier to the set of selected rows.
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