Open System Services Programmer's Guide

Table 16 OSS Time-Management Functions (continued)
Guardian NotesOSS NotesOSS Function
Converts a broken-down time into time
since the Epoch (00:00:00 UTC
January 1, 1970 A.D.). Refer to
ctime().
strftime()
Converts a date and time to a string.
strptime()
Converts a character string to a time
value.
time()
Obtains the time in seconds since the
Epoch (00:00:00 UTC January 1,
1970 A.D.).
When called from a Guardian process,
the following restrictions apply:
Time values are approximate.
Times are not calculated for a process
if it costs more to compute the running
time than to run the process itself.
times()
Obtains process and child process
elapsed times.
• Child times are not maintained.
• All processor time is accumulated as
user time.
There is no overflow limit for the fields
in the tms structure.
• Elapsed time might not be correct if
the processor's internal clock has
been reset.
Can return extended errors.
tzset()
Sets the time-zone conversion
information. Refer to ctime().
FDM set.The file access time is not
updated by the FILE_OPEN_ procedure.
Can return extended errors.utime()
Sets file access and modification times.
wcsftime()
Converts a date and time to a wide
character string. Refer to
strftime().
Guardian Time-Management Procedures
Table 17 displays information about each Guardian procedure that you can use to manage time.
Measure procedures and procedures that have been superseded by other procedures are not
shown. The columns of the table contain the following:
Guardian Procedure
The name of the procedure and a brief description.
OSS Notes
Additional considerations or restrictions when the Guardian procedure is called from an OSS
process.
For details about a procedure, refer to the Guardian Procedure Calls Reference Manual.
Guardian Time-Management Procedures 171