NAME
pmNewZone - establish a reporting timezone
C SYNOPSIS
#include <pcp/pmapi.h>
int pmNewZone(const char *tz)
cc ... -lpcp
DESCRIPTION
The current reporting timezone affects the timezone used
by pmCtime(3) and pmLocaltime(3).
The argument tz defines a timezone string, in the format
described for the TZ environment variable, see environ(5).
pmNewZone sets the current reporting timezone, and returns
a value that may be used in a subsequent call to pmUse
Zone(3) to restore this reporting timezone.
SEE ALSO
PMAPI(3), pmCtime(3), pmGetConfig(3), pmLocaltime(3),
pmNewContextZone(3), pmUseZone(3), pmWhichZone(3),
pcp.conf(4), pcp.env(4) and environ(5).
DIAGNOSTICS
A return value less than zero indicates a fatal error from
a system call, most likely malloc(3C).
Man(1) output converted with
man2html