c_readephem - Read the ephemeris information from the appropriate file

SYNTAX

FUNCTION c_readephem (satnum, year, month, day, eline)

    long *satnum;
    long *year;
    long *month;
    long *day;
    char *eline;

PARAMETERS

satnum (long *, input)

The number of the satellite acquiring the pass (for example, 11 for NOAA-11).

year (long *, input)

The desired year of the ephemeris data (ie. 94 for 1994).

month (long *, input)

The desired month of the ephemeris data.

day (long *, input)

The desired day of the ephemeris data.

eline (char *, output)

Line of ephemeris data in ASCII format (EPEM_SIZ bytes long).

DESCRIPTION

The ephemeris files reside in ADAPSTABLES and have a "dat" suffix. The satellite number is used to determine which ephemeris file to read. Open this file and perform a binary search to locate the correct record of ephemeris data. Return a line of ephemeris data in ASCII format for the specified day.

RETURN VALUE

c_readephem() returns

    E_SUCC --> Successful completion
    E_FAIL --> Operation failed