PMISETTIMEZONE(3)

NAME
pmiSetTimezone, pmiSetZoneinfo - 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).