KPG1_WCATW

Writes an AST Object to a catalogue

Description:

This routine stores a textual representation of the supplied AST Object within the supplied catalogue. The information is stored within COMMENT strings which are appended to the supplied catalogue s textual information. Lines of AST information which are too long to fit in a single COMMENT are split into several lines. Continuation lines are marked by having a " +" in the first column. Each line of AST information is preceeded with the string " !!" , which is used to mark the end of any leading blanks etc. added by AST when the string is read back.

Note, at the moment CAT reports errors if textual information is added to a catalogue which contains no rows of data. For this reason, this routine should normally be called just before closing the catalogue, since this will normally ensure that the catalogue contains some data.

Invocation

RESULT = KPG1_WCATW( IAST, CI, STATUS )

Arguments

IAST = INTEGER (Given)
An AST pointer to the Object.
CI = INTEGER (Given)
A CAT identifier for the catalogue.
STATUS = INTEGER (Given and Returned)
The global status.

Function Value

KPG1_WCATW = INTEGER Returned equal to 1 if an Object was written to the catalogue, and zero otherwise.