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(5).
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
24       reporting timezone.
25

SEE ALSO

27       PMAPI(3),   pmCtime(3),   pmGetConfig(3),   pmLocaltime(3),   pmNewCon‐
28       textZone(3), pmUseZone(3), pmWhichZone(3), pcp.conf(4), pcp.env(4)  and
29       environ(5).
30

DIAGNOSTICS

32       A  return  value  less  than zero indicates a fatal error from a system
33       call, most likely malloc(3C).
34
35
36
37Performance Co-Pilot                  SGI                         PMNEWZONE(3)