SIMPLE SOLUTIONS

PMNEWZONE(3) - man page online | library functions

Establish a reporting timezone.

Chapter
PCP
PMNEWZONE(3)                         Library Functions Manual                        PMNEWZONE(3)

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(7). pmNewZone sets the current reporting timezone, and returns a value that may be used in a subsequent call to pmUseZone(3) to restore this reporting timezone.

SEE ALSO

PMAPI(3), pmCtime(3), pmGetConfig(3), pmLocaltime(3), pmNewContextZone(3), pmUseZone(3), pmWhichZone(3), pcp.conf(5), pcp.env(5) and environ(7).

DIAGNOSTICS

A return value less than zero indicates a fatal error from a system call, most likely mal‐ loc(3C).
Performance Co-Pilot PCP PMNEWZONE(3)
This manual Reference Other manuals
pmNewZone(3) referred by __pmConvertTime(3) | pmCtime(3) | pmLocaltime(3) | __pmMktime(3) | __pmParseTime(3) | pmParseTimeWindow(3) | pmUseZone(3) | pmWhichZone(3)
refer to environ(7) | pcp.conf(5) | pcp.env(5) | PMAPI(3) | pmCtime(3) | pmGetConfig(3) | pmLocaltime(3) | pmNewContextZone(3) | pmUseZone(3) | pmWhichZone(3)