Description:
This
function creates a new FITS file with a path obtained from the environment, and returns a logical unit
number that can be used to access it using CVG and FITSIO functions.
Invocation
CALL
CVG_CREAT( PARAM, BLOCKF, OVRWRT, FUNIT, STATUS )
Arguments
PARAM = CHARACTER
(
)
(Given)
The name of the environemt parameter to use.
BLOCKF = INTEGER (Given)
The blocking
factor for the new file. It must be a positive integer between 1 and 10.
OVRWRT = LOGICAL
(Returned)
If .TRUE., any existing file with the given name is silently over-written. Otherwise, an
error is reported if the file already exists.
FUNIT = INTEGER (Returned)
The logical unit number of
the FITS file. Returned equal to CVG_NOLUN if an error occurs.
STATUS = INTEGER (Given and
Returned)
The global status.