IRQ_FIND

Find quality name information within an NDF

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.