pxerbla
pxerbla
Error handling routine called by ScaLAPACK routines.
Syntax
void
pxerbla
(
MKL_INT*
ictxt
,
char*
srname
,
MKL_INT*
info
,
MKL_INT
srname_len
);
Include Files
- mkl_scalapack.h
Input Parameters
- ictxt
- (local)MKL_INT*The BLACS context handle, indicating the global context of the operation. The context itself is global.
- srname
- (global)char*The name of the routine that calledpxerbla.
- info
- (global)MKL_INT*The position of the invalid parameter in the parameter list of the calling routine.
- srname_len
- (global)MKL_INTThe length of the calling routine name.
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.