VMS Help
System Services, $ASCUTC

 *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Converts an absolute time from 128-bit UTC format to an ASCII
    string.

    On Alpha 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 (Alpha)
    mechanism:    by 32-bit reference (VAX)
    Length (in bytes) of the ASCII string returned by $ASCUTC. The
    timlen argument is the 32-bit address (on VAX systems) or the 32-
    or 64-bit address (on Alpha systems) 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 (Alpha)
    mechanism:    by 32-bit descriptor-fixed-length string descriptor
                  (VAX)
    Buffer into which $ASCUTC writes the ASCII string. The timbuf
    argument is the 32-bit address (on VAX systems) or the 32- or 64-
    bit address (on Alpha systems) 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 (Alpha)
    mechanism:    by 32-bit reference (VAX)
    Time value that $ASCUTC is to convert. The timadr argument is the
    32-bit address (on VAX systems) or the 32- or 64-bit address (on
    Alpha systems) 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     HLB-list     TLB-list     Help  

[legal] [privacy] [GNU] [policy] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.