NAME

   utc_getusertime - Returns the time and process-specific TDF, rather
                     than the system-specific TDF

 SYNOPSIS

   #include <dce/utc.h>

   int utc_getusertime( utc_t *utc );

 PARAMETERS

   Input

   None.

   Output

   utc
       System time as a binary timestamp.

 DESCRIPTION

   The utc_getusertime() 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 (details are system
   dependent).

   If the user environment does not specify a TDF, the system's TDF is
   used.  The system's time zone rule is applied (details of the rule are
   system dependent). For example, on OpenVMS systems, the rule pointed
   to by the filename in SYS$SYSTEM:SYS$TIMEZONE_SRC.DAT applies.

 RETURN VALUES

    0    Indicates that the routine executed successfully.

   -1    Generic error that indicates the time service cannot be
 	accessed.

 EXAMPLES

   See the sample program in the utc_boundtime reference page.

 RELATED INFORMATION

   Functions: utc_gettime