Guardian Procedure Calls Reference Manual

DST_GETINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The DST_GETINFO_ procedure, for G05.00 and later G-series RVUs, provides the information
about the DST entry that is in effect at time keygmt.
Syntax for C Programmers
#include <cextdecs(DST_GETINFO_)>
short DST_GETINFO_ ( long long keygmt
,short *dstentry );
Syntax for TAL Programmers
error := DST_GETINFO_ ( keygmt ! i
,dstentry ); ! o
Parameters
keygmt
input
FIXED:value
specifies time in GMT for required DST information. If keygmt is set to 0, it returns the entry
currently in effect. If keygmt is set to -1, it returns the first entry in the table. If keygmt is set
to 1, it returns the last entry in the table.
dstentry
output
INT .EXT:ref:*
specifies the address of the ZSYS^DDL^DST^ENTRY^DEF structure that will be filled in with
the required information.
Returned Value
INT
Outcome of the call. DST_... Procedure Errors (page 330) summarizes the possible values for error.
Considerations
• If the keygmt value is less the than the lowgmt value of the first entry in the table with nonzero
offset, ZSYS^VAL^DST^RANGE^LOW (9) is returned.
• If the keygmt value is greater than or equal to the highgmt value of the last entry in the
table with nonzero offset, ZSYS^VAL^DST^RANGE^HIGH (10) is returned.
DST_GETINFO_ Procedure 327