1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<!--Converted with LaTeX2HTML 96.1-h (September 30, 1996) by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds -->
<HTML>
<HEAD>
<TITLE>BLACS Warning and Error Messages</TITLE>
<META NAME="description" CONTENT="BLACS Warning and Error Messages">
<META NAME="keywords" CONTENT="slug">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<LINK REL=STYLESHEET HREF="slug.css">
</HEAD>
<BODY LANG="EN" >
<A NAME="tex2html4162" HREF="node157.html"><IMG WIDTH=37 HEIGHT=24 ALIGN=BOTTOM ALT="next" SRC="http://www.netlib.org/utk/icons/next_motif.gif"></A> <A NAME="tex2html4160" HREF="node155.html"><IMG WIDTH=26 HEIGHT=24 ALIGN=BOTTOM ALT="up" SRC="http://www.netlib.org/utk/icons/up_motif.gif"></A> <A NAME="tex2html4156" HREF="node155.html"><IMG WIDTH=63 HEIGHT=24 ALIGN=BOTTOM ALT="previous" SRC="http://www.netlib.org/utk/icons/previous_motif.gif"></A> <A NAME="tex2html4164" HREF="node1.html"><IMG WIDTH=65 HEIGHT=24 ALIGN=BOTTOM ALT="contents" SRC="http://www.netlib.org/utk/icons/contents_motif.gif"></A> <A NAME="tex2html4165" HREF="node190.html"><IMG WIDTH=43 HEIGHT=24 ALIGN=BOTTOM ALT="index" SRC="http://www.netlib.org/utk/icons/index_motif.gif"></A> <BR>
<B> Next:</B> <A NAME="tex2html4163" HREF="node157.html">System Error Messages</A>
<B>Up:</B> <A NAME="tex2html4161" HREF="node155.html">Error Handling in the </A>
<B> Previous:</B> <A NAME="tex2html4157" HREF="node155.html">Error Handling in the </A>
<BR> <P>
<H2><A NAME="SECTION04781000000000000000">BLACS Warning and Error Messages</A></H2>
<P>
All BLACS warning messages are printed by the internal routine <TT>BlacsWarn</TT>,
and all BLACS error messages are printed by the internal routine <TT>BlacsErr</TT>.
The only real difference between <TT>BlacsWarn</TT> and <TT>BlacsErr</TT> is that
<TT>BlacsErr</TT> calls BLACS_ABORT after the message is printed.
<P>
With these central routines
handling BLACS error messages, it should be relatively easy for the programmer
to modify error handling if the default routines are not adequate for his
needs. One particularly annoying problem is that on many systems a print to
the screen takes a long time to finish. <TT>BlacsErr</TT> may then kill the
machine
before the print reaches the screen, and the error message is lost. In this
case, the user may wish to make <TT>BlacsErr</TT> wait before killing, or not
kill at all, for instance.
<P>
BLACS warning messages have the following form:
<PRE>BLACS WARNING '<explanation string>'
from {<p>,<q>}, pnum=<pnum>, Contxt=<ictxt>, on line <#> of file '<fname>'.</PRE>
<P>
BLACS error messages have the following form:
<PRE>BLACS ERROR '<explanation string>'
from {<p>,<q>}, pnum=<pnum>, Contxt=<ictxt>, on line <#> of file '<fname>'.</PRE>
<P>
The meaning of these parameters are as follows:
<UL>
<LI><TT>explanation string</TT> The message that should help the user
determine what is wrong. For example, on an incorrect call to BLACS_GRIDINIT,
the user might get: <BR> <code>Process 0 had 2 x 4 grid; correct is 1 x 4</code>.
<LI><TT>{p, q}</TT>: The row and column process grid coordinates
of the process issuing the warning/error.
<LI><TT>pnum</TT>: The process number returned in the first
argument of BLACS_PINFO.
<LI><TT>ictxt</TT>: The integer context handle. Please note that this
value is not the same across all processes. For instance, process
{0, 0} may have <TT>ictxt</TT> = 0 and process {0, 1} have <TT>ictxt</TT> = 1
for the same context. However, the <TT>pnum</TT> and <TT>ictxt</TT> together
provide an unambiguous process/context identifier.
<LI><TT>#</TT>: The line number within the file <TT>fname</TT> that issued
the warning.
<LI><TT>fname</TT>: The file name where the routine that issued the warning/error
is located.
</UL>
<P>
Not all of this information may be available at the time an error or warning
is issued. For instance, if the error occurs before the creation of the grid,
the process grid coordinates will be unavailable. For any value that the BLACS
cannot figure out, a -1 is printed to indicate that the value is unknown.
<P>
Examples of these BLACS error messages can be found on the BLACS
homepage <BR> (<TT>http://www.netlib.org/blacs/index.html</TT>) or in ``A User's
Guide to the BLACS'' [<A HREF="node189.html#lawn94">54</A>].
<P>
<HR><A NAME="tex2html4162" HREF="node157.html"><IMG WIDTH=37 HEIGHT=24 ALIGN=BOTTOM ALT="next" SRC="http://www.netlib.org/utk/icons/next_motif.gif"></A> <A NAME="tex2html4160" HREF="node155.html"><IMG WIDTH=26 HEIGHT=24 ALIGN=BOTTOM ALT="up" SRC="http://www.netlib.org/utk/icons/up_motif.gif"></A> <A NAME="tex2html4156" HREF="node155.html"><IMG WIDTH=63 HEIGHT=24 ALIGN=BOTTOM ALT="previous" SRC="http://www.netlib.org/utk/icons/previous_motif.gif"></A> <A NAME="tex2html4164" HREF="node1.html"><IMG WIDTH=65 HEIGHT=24 ALIGN=BOTTOM ALT="contents" SRC="http://www.netlib.org/utk/icons/contents_motif.gif"></A> <A NAME="tex2html4165" HREF="node190.html"><IMG WIDTH=43 HEIGHT=24 ALIGN=BOTTOM ALT="index" SRC="http://www.netlib.org/utk/icons/index_motif.gif"></A> <BR>
<B> Next:</B> <A NAME="tex2html4163" HREF="node157.html">System Error Messages</A>
<B>Up:</B> <A NAME="tex2html4161" HREF="node155.html">Error Handling in the </A>
<B> Previous:</B> <A NAME="tex2html4157" HREF="node155.html">Error Handling in the </A>
<P><ADDRESS>
<I>Susan Blackford <BR>
Tue May 13 09:21:01 EDT 1997</I>
</ADDRESS>
</BODY>
</HTML>
|
