pmUseZone — re-establish a reporting timezone

C Synopsis

#include <pcp/pmapi.h>

int pmUseZone(const int tz_handle);

cc ... -lpcp

Description

The current reporting timezone effects the timezone used by pmCtime(3) and pmLocaltime(3).

The argument tz_handle identifies a reporting timezone as previously established by a call to pmNewZone(3) or pmNewContextZone(3), and this becomes the current reporting timezone.

See Also

PMAPI(3), pmCtime(3), pmLocaltime(3), pmNewContextZone(3), pmNewZone(3) and pmWhichZone(3).

Diagnostics

A return value less than zero indicates the value of tz_handle is not legal.

Referenced By

__pmConvertTime(3), pmCtime(3), pmLocaltime(3), __pmMktime(3), pmNewContextZone(3), pmNewZone(3), __pmParseTime(3), pmParseTimeWindow(3), pmWhichZone(3).

The man page pmusezone(3) is an alias of pmUseZone(3).

PCP Performance Co-Pilot