Library /sys$common/syshlp/helplib.hlb  —  DECdts  utc_getusertime
    Returns the time and process-specific TDF, rather than the
    system-specific TDF.

    Format

      #include <utc.h>

      int utc_getusertime(*utc)

         utc_t *utc;

1  –  Parameters

    Input

    None.

    Output

 utc

    System time as a binary timestamp.

2  –  Description

    The Get User Time routine returns the system time and inaccuracy
    in a binary timestamp. The routine takes the TDF from the
    user's environment, which determines the time zone rule.
    OpenVMS systems do not have a default time zone rule. You
    select a time zone by defining sys$timezone_rule during the
    sys$manager:net$configure.com procedure, or by explicitly
    defining sys$timezone_rule.

3  –  Returns

     0   Indicates that the routine executed successfully.
    -1   Generic error that indicates the time service cannot be
         accessed.

4  –  Example

    See the sample program for the utc_boundtime routine.

5  –  Related Functions

    utc_gettime
Close Help