Guardian Procedure Calls Reference Manual

Table 13 Error Summary for DST_... Procedures (continued)
DescriptionLiteralError
An attempt was made to use time values outside the supported
range. The supported range is 1/ 1/ 1 0:00:00.000000 through
10000/12/31 23:59:59.999999 GMT.
ZSYS^VAL^DST^BOUNDS^ERROR8
The specified keygmt value was less than the lowgmt value of
the first DST interval with nonzero offset. This error is returned by
the DST_GETINFO_ procedure.
ZSYS^VAL^DST^RANGE^LOW9
The specified keygmt value is greater than the highgmt of the
last DST interval with nonzero offset. This error is returned by the
DST_GETINFO_ procedure.
ZSYS^VAL^DST^RANGE^HIGH19
An attempt was made to add too many entries to the table. Delete
some of the entries and try again.
ZSYS^VAL^DST^COUNT^OVERFLOW11
Considerations
• All time intervals that do not have explicit nonzero offset transition added are assumed to
have a zero offset. Furthermore, all intervals that have a zero offset transition do not need to
be explicitly added.
• All intervals that have nonzero offset transition must be explicitly added.
• Transitions can be added only if the interval that is to be added is completely covered by a
zero offset interval in the table.
Example
#include <cextdecs (DST_TRANSITION_ADD_)>
zsys_ddl_dst_entry_def dstentry;
short error;
long long timeStampLow, timeStampHigh;
dstentry.z_lowgmt = timeStampLow;
dstentry.z_highgmt = timeStampHigh;
dstentry.z_offset = 3600; /* seconds */
dstentry.z_version = ZSYS_VAL_DST_VERSION_SEP1997;
error = DST_TRANSITION_ADD_ ((short*)&dstentry););
DST_TRANSITION_ADD_ Procedure 331