next up previous 216
Next: PSX_ISATTY - Determine if a file is a terminal
Up: Routine Descriptions
Previous: PSX_GETUID - Gets the real user ID


PSX_GMTIME - Convert the value returned by PSX_TIME to individual GMT values

Description:
Convert the value returned by PSX_TIME into a set of usable numbers expressed in GMT, and a pointer to the corresponding C structure. If GMT is not available, STATUS will be set to PSX__NOGMT and an error is reported.

Invocation:
CALL PSX_GMTIME( NTICKS, SECS, MINS, HOURS, DAY, MONTH, YEAR,
: WDAY, YDAY, TSTRCT, STATUS )

Arguments:

NTICKS = INTEGER (Given)
The number of ticks since the start of the calendar.
SECS = INTEGER (Returned)
The number of seconds in the current time.
MINS = INTEGER (Returned)
The number of minutes in the current time.
HOURS = INTEGER (Returned)
The number of hours in the current time.
DAY = INTEGER (Returned)
The number of the day of the month.
MONTH = INTEGER (Returned)
The number of the month in the year.
YEAR = INTEGER (Returned)
The number of the years since 1900.
WDAY = INTEGER (Returned)
The number of the day in the week.
YDAY = INTEGER (Returned)
The number of the day in the year.
TSTRCT = POINTER (Returned)
A pointer to the C time structure.
STATUS = INTEGER (Given)
The global status.

Notes:

External Routines Used
cnf: cnfFptr, cnfMalloc

References

Copyright
Copyright (C) 2000 Council for the Central Laboratory of the Research Councils


next up previous 216
Next: PSX_ISATTY - Determine if a file is a terminal
Up: Routine Descriptions
Previous: PSX_GETUID - Gets the real user ID

PSX POSIX interface routines
Starlink User Note 121
P M Allan
A J Chipperfield
10 April 2003
E-mail:ussc@star.rl.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils