NAME

   utc_ascgmtime - Converts a binary timestamp to an ASCII string that
                   expresses a GMT time

 SYNOPSIS

   #include <dce/utc.h>

   int utc_ascgmtime( char *cp,
                      size_t stringlen,
                      utc_t *utc );

 PARAMETERS

   Input

   stringlen
       Length of the cp buffer.

   utc
       Binary timestamp.

   Output

   cp  ASCII string that represents the time.

 DESCRIPTION

   The utc_ascgmtime() routine converts a binary timestamp to an ASCII
   string that expresses a time in GMT.

 RETURN VALUES

    0    Indicates that the routine executed successfully.

   -1    Indicates an invalid time parameter or invalid results.

 EXAMPLES

   The following example converts the current time to GMT format.

        char   gmTime[UTC_MAX_STR_LEN];

        /*   Convert the current time to ASCII in the following format:
         *          1991-04-01-12:27:38.37I2.00
         */
        utc_ascgmtime(gmTime,            /* Out: Converted time      */
                      UTC_MAX_STR_LEN,   /* In:  Length of string    */
                      (utc_t*) NULL);    /* In:  Time to convert     */
                                         /* Default is current time  */

 RELATED INFORMATION

   Functions: utc_ascanytime
              utc_asclocaltime