Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

xerbla

Error handling function called by BLAS, LAPACK, Vector Math, and Vector Statistics functions.

Syntax

call xerbla( srname, info )

Include Files

  • mkl.fi

Input Parameters

Name

Type

Description

srname

CHARACTER*(*)

The name of the routine that called xerbla

info

INTEGER

The position of the invalid parameter in the parameter list of the calling function or an error code

Description

The xerbla function is an error handler for Intel® oneAPI Math Kernel Library (oneMKL) BLAS, LAPACK, Vector Math, and Vector Statistics functions. These functions call xerbla if an issue is encountered on entry or during the function execution.

xerbla operates as follows:

  1. Prints a message that depends on the value of the info parameter as explained in the following table.

    NOTE:

    A specific message can differ from the listed messages in numeric values and/or function names.

  2. Returns to the calling application.

Error Messages Printed by xerbla

Value of info

Error Message

1001

Intel MKL ERROR: Incompatible optional parameters on entry to DGEMM.

1000 or 1089

Intel MKL INTERNAL ERROR: Insufficient workspace available in function CGELSD.

< 0

Intel MKL INTERNAL ERROR: Condition 1 detected in function DLASD8.

Other

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

Note that xerbla is an internal function. You can change or disable printing of an error message by providing your own xerbla function. The following examples illustrate usage of xerbla.

Example

subroutine xerbla (srname, info)
character*(*) srname  !Name of subprogram that called xerbla
integer	info	!Position of the invalid parameter in the parameter list
return	!Return to the calling subprogram end
end

See Also