PMWHICHZONE

Section: C Library Functions (3)
Index Return to Main Contents

NAME

pmWhichZone - return current reporting timezone

C SYNOPSIS

#include < pcp/pmapi.h >

int pmWhichZone(char ** tz );

cc ... -lpcp

DESCRIPTION

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

pmWhichZone returns the handle of the current timezone, as previously established by a call to pmNewZone (3) or pmNewContextZone (3). If the call is successful (i.e. there exists a current reporting timezone) then a non-negative integer is returned and tz is set to point to a static buffer containing the timezone string itself.

SEE ALSO

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

DIAGNOSTICS

A return value less than zero indicates there is no current reporting timezone.


Index

NAME
C SYNOPSIS
DESCRIPTION
SEE ALSO
DIAGNOSTICS