KPG1_WREAD

Reads an AST Object from an HDS object

Description:

This routine reads an AST Object from a component of the supplied HDS object. The component name is specified by the caller. The component must have a type of WCS, must be scalar, and must contain a single one-dimensional array component with name DATA and type _CHAR. AST__NULL is returned in IAST, and no error is reported if the named component does not exist.

Invocation

CALL KPG1_WREAD( LOC, NAME, IAST, STATUS )

Arguments

LOC = CHARACTER ∗ ( ∗ ) (Given)
The locator to the HDS object.
NAME = CHARACTER ∗ ( ∗ ) (Given)
The name of the component within the HDS object to read. If a blank name is supplied, the object itself is used.
IAST = INTEGER (Returned)
Pointer to the AST Object returned. Returned equal to AST__NULL if no Object can be read.
STATUS = INTEGER (Given and Returned)
The global status.