Description:
A search is made
through the extensions contained within the supplied NDF for an HDS structure containing quality
name information. Such information is held in an HDS object named QUALITY_NAMES (these
objects can be created using IRQ_NEW). If no such object is found, an error is reported and the
status IRQ__NOQNI is returned (if more than one such object is found, an error is reported
and the status IRQ__MULT is returned). The name of the NDF extension in which the
object was found is returned in XNAME. An array of five HDS locators is returned which is
needed when calling other IRQ routines. The first locator points to a temporary object
which holds a cloned identifier for the NDF, the other four point to components of the
QUALITY_NAMES structure contained in the NDF. IRQ_RLSE should be called to annul these
locators (and the NDF identifier) when no further access to the NDFs quality names information is
required.
The LOCS argument returned by this routine specifies the NDF which will be operated on by
subsequent IRQ routines. Specifically, LOCS determines the bounds of the NDF. Care should therefore
be taken that subsequent calls to IRQ routines refer to the NDF specified by the INDF
argument to this routine, and not for instance to a section of the NDF which will in general
have different bounds.
Invocation
CALL IRQ_FIND( INDF, LOCS, XNAME, STATUS )
Arguments
INDF = INTEGER (Given)
The input NDF.
LOCS(5) = CHARACTER
(
) (Returned)
A set of HDS locators as described above. The character variables
supplied for this argument should have a declared length equal to symbolic constant
DAT__SZLOC. These locator are annuled by calling IRQ_RLSE.
XNAME = CHARACTER
(
)
(Returned)
The name of the NDF extension in which the quality name information was found. The
character variable supplied for this argument should have a declared length equal to symbolic
constant DAT__SZNAM.
STATUS = INTEGER (Given and Returned)
The global status.
Copyright © 2009 Science and Technology Facilities Council.