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.