pxerbla

Error handling routine called by ScaLAPACK routines.

Syntax

call pxerbla(ictxt, srname, info)

Include Files

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.


Submit feedback on this help topic