VMS Help
System Services, $ASCUTC
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
Converts an absolute time from 128-bit UTC format to an ASCII
string.
On Alpha 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 (Alpha)
mechanism: by 32-bit reference (VAX)
Length (in bytes) of the ASCII string returned by $ASCUTC. 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 string text
access: write only
mechanism: by 32- or 64-bit descriptor-fixed-length string
descriptor (Alpha)
mechanism: by 32-bit descriptor-fixed-length string descriptor
(VAX)
Buffer into which $ASCUTC 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.
utcadr
OpenVMS usage:coordinated universal time
type: utc_date_time
access: read only
mechanism: by 32- or 64-bit reference (Alpha)
mechanism: by 32-bit reference (VAX)
Time value that $ASCUTC 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 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.
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.