1PMNEWZONE(3)               Library Functions Manual               PMNEWZONE(3)
2
3
4

NAME

6       pmNewZone - establish a reporting timezone
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10
11       int pmNewZone(const char *tz);
12
13       cc ... -lpcp
14

DESCRIPTION

16       The  current reporting timezone affects the timezone used by pmCtime(3)
17       and pmLocaltime(3).
18
19       The argument tz defines a timezone string, in the format described  for
20       the TZ environment variable, see environ(7).
21
22       pmNewZone sets the current reporting timezone, and returns a value that
23       may be used in a subsequent call to pmUseZone(3) to  restore  this  re‐
24       porting timezone.
25

DIAGNOSTICS

27       A  return  value  less  than zero indicates a fatal error from a system
28       call, most likely malloc(3).
29

SEE ALSO

31       PMAPI(3),   pmCtime(3),   pmGetConfig(3),   pmLocaltime(3),   pmNewCon‐
32       textZone(3),  pmUseZone(3), pmWhichZone(3), pcp.conf(5), pcp.env(5) and
33       environ(7).
34
35
36
37Performance Co-Pilot                  PCP                         PMNEWZONE(3)