VMS Help
System Services, $NUMUTC
*Conan The Librarian
|
Converts an absolute 128-bit binary time into its numeric
components. The numeric components are returned in local time.
On Alpha and Integrity server systems, this service accepts 64-
bit addresses.
Format
SYS$NUMUTC timbuf ,[utcadr]
C Prototype
int sys$numutc (unsigned short int timbuf [13], unsigned int
*utcadr [4]);
timbuf
OpenVMS usage:vector_word_unsigned
type: word
access: write only
mechanism: by 32- or 64-bit reference (Alpha and Integrity
servers)
Buffer into which $NUMUTC writes the converted date and time.
The timbuf argument is the 32- or 64-bit address (on Alpha and
Integrity server systems) of a 13-word structure containing
time, inaccuracy of time, and time differential factor. The time
differential factor encoded in the 128-bit buffer is used to
convert the UTC to its numerical components. Negative values in
the inaccuracy field indicate an infinite inaccuracy.
Refer to the HP OpenVMS System Services Reference Manual to view
the diagram of the fields in this structure.
utcadr
OpenVMS usage:coordinated universal time
type: utc_date_time
access: read only
mechanism: by 32- or 64-bit reference (Alpha and Integrity
servers)
The 128-bit UTC time value to be converted.
The utcadr argument is optional; if it is not used, $NUMUTC will
use the current time.