VMS Help
System Services, $ASCTIM

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

    Converts an absolute or delta time from 64-bit system time format
    to an ASCII string.

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

    Format

      SYS$ASCTIM  [timlen] ,timbuf ,[timadr] ,[cvtflg]

    C Prototype

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

                      struct _generic_64 *timadr, 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 $ASCTIM. 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 text string
    access:       write only
    mechanism:    by 32- or 64-bit descriptor-fixed-length string
                  descriptor (Alpha)
    mechanism:    by 32-bit descriptor (VAX)
    Buffer into which $ASCTIM 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.

 timadr

    OpenVMS usage:date_time
    type:         quadword
    access:       read only
    mechanism:    by 32- or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    Time value that $ASCTIM 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 64-bit time value. A positive time value
    represents an absolute time. A negative time value represents
    a delta time. If you specify a delta time, it must be less than
    10,000 days.

    If timadr is not specified or is specified as 0 (the default),
    $ASCTIM 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
    $ASCTIM should return. The cvtflg argument is a longword
    value, which is interpreted as Boolean. The value 1 specifies
    that $ASCTIM should return only the hour, minute, second, and
    hundredths-of-second fields. The default value 0 specifies that
    $ASCTIM 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.