HELPLIB.HLB  —  System Services, $ASCUTC
    Converts an absolute time from 128-bit UTC format to an ASCII
    string.

    On Alpha and Integrity server systems, this service accepts 64-
    bit addresses.

    Format

      SYS$ASCUTC  [timlen] ,timbuf ,[utcadr] ,[cvtflg]

    C Prototype

      int sys$ascutc  (unsigned short int *timlen, void *timbuf,

                      unsigned int *utcadr [4], char cvtflg);

1  –  Arguments

 timlen

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       write only
    mechanism:    by 32- or 64-bit reference
    Length (in bytes) of the ASCII string returned by $ASCUTC. The
    timlen argument is the 32- or 64-bit address of a word containing
    this length.

 timbuf

    OpenVMS usage:time_name
    type:         character-coded string text
    access:       write only
    mechanism:    by 32- or 64-bit descriptor-fixed-length string
                  descriptor
    Buffer into which $ASCUTC writes the ASCII string. The timbuf
    argument is the 32- or 64-bit address of a character string
    descriptor pointing to the buffer. The buffer length specified in
    the timbuf argument, together with the cvtflg argument, controls
    what information is returned.

 utcadr

    OpenVMS usage:coordinated universal time
    type:         utc_date_time
    access:       read only
    mechanism:    by 32- or 64-bit reference
    Time value that $ASCUTC is to convert. The timadr argument is the
    32- or 64-bit address of this 128-bit time value. Relative times
    are not permitted. If the timadr argument is not specified, it
    defaults to 0 and $ASCUTC returns the current date and time.

 cvtflg

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Conversion indicator specifying which date and time fields
    $ASCUTC should return. The cvtflg argument is a longword value
    that is interpreted as Boolean. The value 1 specifies that
    $ASCUTC should return only the time, including hour, minute,
    second, and hundredths-of-second fields. The default value 0
    specifies that $ASCUTC should return the full date and time.
Close Help