Guardian Procedure Calls Reference Manual

Structure Definitions for dstentry
The dstentry parameter specifies the attributes of the new process.
In the TAL ZSYSTAL file, the structure for the dstentry parameter is defined as:
STRUCT ZSYS^DDL^DST^ENTRY^DEF (*)
?IF PTAL
FIELDALIGN (SHARED2)
?ENDIF PTAL
BEGIN
FIXED Z^LOWGMT;
FIXED Z^HIGHGMT;
INT Z^OFFSET;
INT Z^VERSION;
INT(32) Z^FILLER; END;
Z^LOWGMT
identifies the lower limit of the interval in Greenwich Mean Time (GMT).
Z^HIGHGMT
identifies the higher limit of the interval in GMT.
Z^OFFSET
identifies the offset value of a transition.
Z^VERSION
identifies the version of the ZSYS^DDL^DST^ENTRY^DEF structure.
Z^FILLER
is provided for future use.
DST_... Procedure Errors
Table 13 summarizes the possible values for error for the DST_... procedures. It is recommended
that the literal values be used instead of the numeric values when coding (for example,
ZSYS^VAL^DST^OK, not 0).
Table 13 Error Summary for DST_... Procedures
DescriptionLiteralError
The operation is successful.ZSYS^VAL^DST^OK0
The caller is not a super-group user (255,n).ZSYS^VAL^DST^SECURITY^ERROR1
The version number passed in ZSYS^DDL^DST^ENTRY^DEF is
not valid. The only valid version is
ZSYS^VAL^DST^VERSION^SEP1997.
ZSYS^VAL^DST^BAD^VERSION2
One of the specified parameters is not valid.ZSYS^VAL^DST^BAD^PARAMETER3
Invalid interval operation. An attempt was made to add, delete,
or modify a DST entry that causes a collision with an existing DST
entry.
ZSYS^VAL^DST^INTERVAL^ERROR4
An attempt was made to delete a required DST entry. This error
is returned when the DST entry that the user attempted to delete
ZSYS^VAL^DST^DELETE^NOW^ERROR5
is in effect at the time the delete operation was attempted and the
offset of the entry is nonzero.
The DAYLIGHT_SAVING_TIME option in the system is not
configured to use the TABLE option.
ZSYS^VAL^DST^TYPE^ERROR6
The DST table has no entries. This error is returned by the
DST_GETINFO_ procedure.
ZSYS^VAL^DST^TABLE^EMPTY7
330 Guardian Procedure Calls (D-E)