mmcr_write Subroutine

Purpose

Writes the specified monitor mode control register in problem state.

Library

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>
int mmcr_write (int reg_num, void *buffer)

Description

The mmcr_write subroutine writes a specified monitor mode control register (MMCR) in problem state.

The function takes two parameters namely the Special Purpose Register (SPR) number of the MMCR into which the value is written, and the address from where the value is written to the MMCR. The mmcr_write subroutine writes the value of the address specified in the second argument into the register specified in the first argument.

Return Values

If unsuccessful, a value 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.