Guardian Procedure Calls Reference Manual

DST_TRANSITION_MODIFY_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The DST_TRANSITION_MODIFY_ procedure, for G05.00 and later G-series RVUs, allows a
super-group user (255,n) to modify an entry in 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_MODIFY_)>
short DST_TRANSITION_MODIFY_ ( short *olddst
,short *newdst );
Syntax for TAL Programmers
error:= DST_TRANSITION_MODIFY_ ( olddst ! i
,newdst ); ! i
Parameters
olddst
input
INT .EXT
specifies the address of an existing entry with a nonzero offset.
newdst
input
INT .EXT
specifies the address of a new entry that is to take the place of olddst.
Returned Value
INT
Outcome of the operation. DST_... Procedure Errors (page 330) summarizes the possible values for
error.
Considerations
• Transitions with nonzero offsets that already exist can be modified if the new values do not
overlap other transitions with nonzero offsets that also exist.
• If you specify an offset value of zero for newdst, the olddst entry is deleted.
334 Guardian Procedure Calls (D-E)