IRQ_RBIT

Reserve a bit number for a given quality name

Description:

If the supplied quality name already has a bit number associated with it, the bit number is returned. Otherwise, the next available plane in the quality array is asigned to the quality name, and its bit number is returned.

Note, write or update access must be available for the NDF (as set up by routine LPG_ASSOC for instance).

Invocation

CALL IRQ_RBIT( LOCS, QNAME, BIT, STATUS )

Arguments

LOCS(5) = CHARACTER ( ) (Given)
An array of five HDS locators. These locators identify the NDF and the associated quality name information. They should have been obtained using routine IRQ_FIND or routine IRQ_NEW.
QNAME = CHARACTER ( ) (Given)
The quality name. This quality name must be defined in the NDF specified by LOCS. Name definitions can be added to the NDF using routine IRQ_ADDQN.
BIT = INTEGER (Returned)
The bit number used by the quality name within the quality array. Note, the least-significant bit is Bit 1, not Bit 0.
STATUS = INTEGER (Given and Returned)
The global status.