c_tpgetahdr - Read an associated header file from tape for an AVHRR archive image

SYNTAX

#include "adaps.h"
#include "archio.h"

FUNCTION c_tpgetahdr (sceneid, comment, tpunit, model, drop)

    char *sceneid;
    char *comment;
    long *tpunit;
    struct MODEL *model;
    struct DROPPED *drop;

PARAMETERS

sceneid (char *, input)

16 character scene ID of the AVHRR archive image for which this function is to retrieve the header file.

comment (char *, input)

Tape mounting comment to be sent to the operator's terminal.

tpunit (long *, output)

Tape unit number returned by c_tpopen().

model (struct MODEL *, output)

The AVHRR model structure to be filled with the header information.

drop (struct DROPPED *, output)

The AVHRR dropped line structure to be filled with the information about any dropped lines within the image.

DESCRIPTION

A tape mount request is sent to the operator's terminal. Once the tape has been mounted, the tape is searched for the specified AVHRR archive image. When the header file is found, the model and dropped line structures are filled and the tape is positioned at the beginning of the archive image file.

RETURN VALUE

c_tpgetahdr() returns

    E_SUCC (0)  --> Successful completion.
    E_FAIL (-1) --> Operation failed.  The tape is dismounted.