FUNCTION c_getsat(key, satnum, satnam, satno, satid, satcode)
char *key; long *satnum; char *satnam; char *satno; char *satid; char *satcode;
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"
The integer number of the satellite (e.g., 11).
The full name of the satellite (e.g., "NOAA-11").
The satellite number, an abbreviated form of the satellite name (e.g., "N11").
A character string representing the NOAA satellite identification number (e.g., "19531").
A character string containing the NOAA letter code for the satellite (e.g., "I").
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.
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