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