HELPLIB.HLB  —  System Services, $NUMUTC
    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]);

1  –  Arguments

 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 VSI 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.
Close Help