PMISETTIMEZONE(3)          Library Functions Manual          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).

Performance Co-Pilot                                         PMISETTIMEZONE(3)