# pxerbla

Error handling routine called by ScaLAPACK routines.

## Syntax

call pxerbla(ictxt, srname, info)

## Description

This routine is an error handler for the ScaLAPACK routines. It is called by a ScaLAPACK routine if an input parameter has an invalid value. A message is printed. Program execution is not terminated. For the ScaLAPACK driver and computational routines, a RETURN statement is issued following the call to pxerbla.

Control returns to the higher-level calling routine, and it is left to the user to determine how the program should proceed. However, in the specialized low-level ScaLAPACK routines (auxiliary routines that are Level 2 equivalents of computational routines), the call to pxerbla() is immediately followed by a call to BLACS_ABORT() to terminate program execution since recovery from an error at this level in the computation is not possible.

It is always good practice to check for a nonzero value of info on return from a ScaLAPACK routine. Installers may consider modifying this routine in order to call system-specific exception-handling facilities.

## Input Parameters

ictxt

  (global) INTEGER

  The BLACS context handle, indicating the global context of the operation. The context itself is global.

srname

  (global) CHARACTER*6

  The name of the routine which called pxerbla.

info

  (global) INTEGER.

  The position of the invalid parameter in the parameter list of the calling routine.

Parent topic: Utility Functions and Routines