NAME
pmWhichZone - return current reporting timezone
C SYNOPSIS
#include <pcp/pmapi.h>
int pmWhichZone(char **tz)
cc ... -lpcp
DESCRIPTION
The current reporting timezone effects the timezone used by pmCtime(3)
and pmLocaltime(3).
pmWhichZone returns the handle of the current timezone, as previously
established by a call to pmNewZone(3) or pmNewContextZone(3). If the
call is successful (i.e. there exists a current reporting timezone)
then a non-negative integer is returned and tz is set to point to a
static buffer containing the timezone string itself.
SEE ALSO
PMAPI(3), pmCtime(3), pmLocaltime(3), pmNewContextZone(3), pmNewZone(3)
and pmUseZone(3).
DIAGNOSTICS
A return value less than zero indicates there is no current reporting
timezone.