pmiSetTimezone - Man Page
set the source timezone for a LOGIMPORT archive
C Synopsis
#include <pcp/pmapi.h>
#include <pcp/import.h>
int pmiSetTimezone(const char *value);
int pmiSetZoneinfo(const char *value);
cc ... -lpcp_import -lpcp
Perl SYNOPSIS
use PCP::LogImport;
pmiSetTimezone($value);
Python SYNOPSIS
from pcp import pmi
log.pmiSetTimezone(value)
Description
As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiSetTimezone sets the POSIX timezone string in the current context to value, which is stored in the archive label. In the absence of a call to pmiSetTimezone the source timezone defaults to the timezone of the localhost.
pmiSetZoneinfo sets the Olson (tzdata) timezone name for the archive, providing higher-fidelity timezone information than the POSIX string alone. If value is NULL, pmiSetZoneinfo auto-detects the Olson name for the current local timezone from the system timezone database; if no Olson name can be determined the call is a silent no-op. Passing an explicit Olson name such as America/New_York stores it directly without any lookup. The zoneinfo string is written into v3 archives alongside the POSIX timezone string.
Diagnostics
Both functions return zero on success, or a negative value that can be turned into an error message by calling pmiErrStr(3).
See Also
LOGIMPORT(3), pmiErrStr(3), pmiSetHostname(3), pmiSetVersion(3) and pmiStart(3).
Referenced By
LOGIMPORT(3), pmiPutResult(3), pmiSetHostname(3), pmiSetVersion(3), pmiStart(3), pmiWrite(3).
The man page pmiSetZoneinfo(3) is an alias of pmiSetTimezone(3).