---
name: "pmiUseContext"
section: "3"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmiUseContext"
---

# pmiUseContext(3)

change LOGIMPORT context

## NAME

**pmiUseContext** - change LOGIMPORT context

## C SYNOPSIS

**#include \<pcp/pmapi.h\>**\
 **#include \<pcp/import.h\>**

**int pmiUseContext(int** *context***);**

**cc ... -lpcp\_import -lpcp**

## Perl SYNOPSIS

**use PCP::LogImport;**

**pmiUseContext($***context***);**

## DESCRIPTION

As part of the Performance Co-Pilot Log Import API (see [**LOGIMPORT**(3)](/LOGIMPORT/3.md)), **pmiUseContext** may be used by applications wishing to generate more than one PCP archive concurrently.

The *context* argument is a value returned from a previous call to [**pmiStart**(3)](/pmiStart/3.md) and on successful return from **pmiUseContext**, the current context will have been changed to the one identified by *context*.

## DIAGNOSTICS

**pmiUseContext** returns zero on success else a negative value that can be turned into an error message by calling [**pmiErrStr**(3)](/pmiErrStr/3.md).

## SEE ALSO

[**LOGIMPORT**(3)](/LOGIMPORT/3.md), [**pmiErrStr**(3)](/pmiErrStr/3.md) and [**pmiStart**(3)](/pmiStart/3.md).