Visible to Intel only — GUID: GUID-E523C816-D553-4D4E-8458-5404828CC07B
Visible to Intel only — GUID: GUID-E523C816-D553-4D4E-8458-5404828CC07B
pxerbla
Error handling routine called by ScaLAPACK routines.
Syntax
call pxerbla (ictxt, srname, info)
Include Files
Input Parameters
- ictxt
-
(local)
INTEGER
The BLACS context handle, indicating the global context of the operation. The context itself is global.
- srname
-
(global)
CHARACTER*(*)
The name of the routine that called pxerbla.
- info
-
(global)
INTEGER
The position of the invalid parameter in the parameter list of the calling routine.
Description
This routine is an error handler for the ScaLAPACK routines. It is called if an input parameter has an invalid value. A message is printed and program execution continues. For ScaLAPACK driver and computational routines, a RETURN statement is issued following the call to pxerbla.
Control returns to the higher-level calling routine, and you can 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 non-zero value of info on return from a ScaLAPACK routine. Installers may consider modifying this routine in order to call system-specific exception-handling facilities.