Laserfiche WebLink
DBReadTS(3CRDSS) UNIX System V (Read TS) DBReadTS(3CRDSS) <br /> NAME <br /> DBReadTS - read a TS file and store in TS data structure <br /> SYNOPSIS <br /> #include "DB.h" <br /> int DBReadTS ( char *tsid, int *m1, int *y1, int *m2, int <br /> *y2, TimeSeries *ts ) <br /> DESCRIPTION <br /> Given the identifier for a time series (TS), the DBReadTS <br /> function initializes a TS and fills its data structure with <br /> values read from the database. Other TS data are also <br /> initialized at this time. The conventions used to define <br /> the TS identifier are discussed in TimeSeries(3). All months <br /> and years are calendar values and not water year values <br /> (1=January, 12=December). <br /> The following table summarizes function arguments: <br /> Input/ <br /> Variable Output Type Description <br /> tsid I char * TS identifier. <br /> m1 I/O int * Pointer to first month to be read. <br /> If zero, the returned value is <br /> the first available month. <br /> y1 I/O int * Pointer to first year to be read. <br /> If zero, the returned value is <br /> the first available year. <br /> m2 I/O int * Pointer to last month to be read. <br /> If zero, the returned value is <br /> the last available month. <br /> y2 I/O int * Pointer to last year to be read. <br /> If zero, the returned value is <br /> the last available year. <br /> ts O TimeSeries * Pointer to TS data structure. <br /> LIMITATIONS <br /> The only TS that the routine knows how to retrieve are <br /> streamflows, temperatures, precipitations, and demands. <br /> DIAGNOSTICS <br /> This routine returns STATUS_SUCCESS if successful, <br /> STATUS_BAD_ID if the TS identifier cannot be resolved, and <br /> STATUS_FAILURE if there are other errors. <br /> SEE ALSO <br /> TimeSeries(3CRDSS) <br /> AUTHOR <br /> Steven A. Malers, Riverside Technology, inc., Fort Collins, CO <br />Figure 4. Typical library routine man page (compiled) <br />16 <br />A275 06.29.94 1.05-12 Malers <br />