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.