c_getsat - Return satellite identification information given a specified key.

SYNTAX

FUNCTION c_getsat(key, satnum, satnam, satno, satid, satcode)

     char	*key;  
     long	*satnum;
     char	*satnam; 
     char	*satno;
     char	*satid; 
     char	*satcode;

PARAMETERS

key (char *, input)

The name of the parameter which is specified on input to use as the key in finding the other fields about the satellite. Valid values, corresponding to the names of other parameters, are:

     "SATNUM"
     "SATNAM"
     "SATNO"
     "SATID"
     "SATCODE"

satnum (long *, input/output)

The integer number of the satellite (e.g., 11).

satnam (char *, input/output)

The full name of the satellite (e.g., "NOAA-11").

satno (char *, input/output)

The satellite number, an abbreviated form of the satellite name (e.g., "N11").

satid (char *, input/output)

A character string representing the NOAA satellite identification number (e.g., "19531").

satcode (char *, input/output)

A character string containing the NOAA letter code for the satellite (e.g., "I").

DESCRIPTION

The c_getsat() routine is used to find additional information about a satellite given one of the key values. The satellite;ids file in ADAPSTABLES is scanned for the value specified in the key parameter. Once a matching key is found, the other fields are returned.

RETURN VALUE

c_getsat() returns

     E_SUCC (0)  --> Successfully found satellite information
     E_FAIL (-1) --> Error accessing or reading satellite;ids file or 
	             key value not found