mmcr_read Subroutine

Purpose

Reads the monitor mode control registers MMCR0, MMCR2, and MMCRA in problem state.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>
int mmcr_read (void * buffer)

Description

The mmcr_read subroutine reads the registers MMCR0, MMCR2, and MMCRA in the same order into the address of the buffer that is passed as a parameter to the function.

The three 64-bit MMCR registers MMCR0, MMCR2, and MMCRA are read into the buffer.

Return Values

If unsuccessful, a value of other than zero is returned and positive error code is set. If successful, a value of zero is returned and no errors are detected.

Files

The pmapi.h file defines standard macros, data types, and subroutines.