c_arcopnwrt - Open a new AVHRR archive image for writing

SYNTAX

FUNCTION c_arcopnwrt (image, dtype, arcdesc)

    char *image;
    long *dtype;
    long *arcdesc;

PARAMETERS

image (char *, input)

Host file name of the AVHRR archive image to be created.

dtype (long *, input)

Data type of the image (GAC, LAC, HRPT).

arcdesc (long *, output)

The AVHRR archive file descriptor. This record is then passed to c_arcseek(), c_arcwrite(), and c_arclose() as needed.

DESCRIPTION

Open a new AVHRR archive image for writing. The specified image must not exist.

RETURN VALUE

c_arcopnwrt() returns

    E_SUCC (0)  --> Successful completion.
    E_FAIL (-1) --> Operation failed.  The specified file already exists, an
		    error occurred opening the file, or the function was unable
		    to allocate memory.