Converts an absolute or delta time from 64-bit system time format
to an ASCII string.
On Alpha and Integrity server 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
Length (in bytes) of the ASCII string returned by $ASCTIM.
The timlen argument is the the 32- or 64-bit address 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
Buffer into which $ASCTIM 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.
timadr
OpenVMS usage:date_time
type: quadword
access: read only
mechanism: by 32- or 64-bit reference
Time value that $ASCTIM is to convert. The timadr argument is
the 32- or 64-bit address 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.