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);
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.
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.