Guardian Procedure Calls Reference Manual

DST_TRANSITION_DELETE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Example
Summary
The DST_TRANSITION_DELETE_ procedure, for G05.00 and later G-series RVUs, allows a
super-group user (255,n) to delete an existing entry from the daylight saving time (DST) transition
table. This operation is allowed only when the DAYLIGHT_SAVING_TIME option in the system is
configured to the TABLE option.
Syntax for C Programmers
#include <cextdecs(DST_TRANSITION_DELETE_)>
short DST_TRANSITION_DELETE_ ( short *dstentry );
Syntax for TAL Programmers
error:= DST_TRANSITION_DELETE_ ( dstentry ); ! i
Parameter
dstentry
input
INT .EXT:ref:*
specifies the address of the ZSYS^DDL^DSTENTRY^DEF structure that contains all of the input
fields for this procedure. For more information on how to assign field values to the structure,
see Structure Definitions for dstentry (page 330).
Returned Value
INT
Outcome of the call. DST_... Procedure Errors (page 330) summarizes the possible values for error.
Considerations
• Only transition entries that already exist can be deleted. If an interval with nonzero offset
covers the time at which the delete operation is attempted,
ZSYS^VAL^DST^DELETE^NOW^ERROR (5) is returned.
332 Guardian Procedure Calls (D-E)