VMS Help
System Services, $ASCUTC
*Conan The Librarian
|
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);
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.