ELowell at 23:02, 12 July 2016

2016-07-12T23:02:51Z

← Older revision		Revision as of 23:02, 12 July 2016
Line 1:		Line 1:
	The conventions used on this page are described in [[HLI: Function ~~call list~~#Function call notation conventions\|Function call notation conventions]].		The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions\|Function call notation conventions]].

	==Summary==		==Summary==

ELowell at 22:08, 11 July 2016

2016-07-11T22:08:19Z

← Older revision		Revision as of 22:08, 11 July 2016
Line 1:		Line 1:
			The conventions used on this page are described in [[HLI: Function call list#Function call notation conventions\|Function call notation conventions]].

	==Summary==		==Summary==

ELowell: Created page with " ==Summary==

Description

The IFGERR call (GET ERROR) returns the text of the most recent error message issued by Model 204 for the current thread.

T..."

2016-07-07T21:05:48Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFGERR call (GET ERROR) returns the text of the most recent error message issued by Model 204 for the current thread.</dd> <dt>T..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFGERR call (GET ERROR) returns the text of the most recent error message issued by Model 204 for the current thread.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>29</dd>
</dl>

==Syntax==
IFGERR(RETCODE,MSG_AREA)

<dl>
<dt>Compile-only form</dt>
<dd>Not available</dd>
<dt>Execute-only form</dt>
<dd>Not available</dd>
</dl>

Specify the parameters in the syntax order shown above.
<table>
<tr class="head">
<th>Parameter</th>
<th>Description</th>
</tr>
<tr>
<td>RETCODE</td>
<td>[O,i,r] The Model 204 return code is a required output parameter. The code is a binary integer value.</td>
</tr>
<tr>
<td>MSG_AREA</td>
<td>[O,c,r] The message area is a required output parameter which specifies the address of the user's data area. The work area contains the text of the error message that is returned by IFGERR. Specify a character string.</td>
</tr>
</table>

==Usage notes==

Use the IFGERR call to retrieve the text of the latest error message issued by Model 204 for the current thread. IFGERR returns either the latest call cancellation message or the latest counting error message.
<blockquote class="note">Notes: A counting error message is written to the audit trail as an ER line and is refreshed only when a new message is generated or when the thread is ended.

IFGERR truncates messages that are longer than 80 bytes.
</blockquote>
Using an IFAM2 or IFAM4 thread, IFGERR also returns the completion code of the previous call. 

For more information about Model 204 messages, see the Rocket Model 204 [[M204wiki main page#Messages|Messages]] pages. 

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 CALL-ARGS.
05 RETCODE PIC 9(5) COMP SYNC.
05 M204-ERROR-MESSAGE PIC X(80) VALUE SPACES.
.
.
.
01 ERROR-REPORT.
05 CONTROL-REPORT-CODE PIC X.
05 CONTROL-REPORT-DATA PIC X(132).
.
.
.
WRITE-ERROR-REPORT.
.
.
.
CALL 'IFGERR' USING RETCODE, M204-ERROR-MESSAGE.
WRITE ERROR-REPORT FROM M204-ERROR-MESSAGE.
.
.
.

[[Category: HLI functions]]

IFGERR (HLI function) - Revision history

ELowell at 23:02, 12 July 2016

ELowell at 22:08, 11 July 2016

ELowell: Created page with " ==Summary== Description The IFGERR call (GET ERROR) returns the text of the most recent error message issued by Model 204 for the current thread. T..."

ELowell: Created page with " ==Summary==

Description

The IFGERR call (GET ERROR) returns the text of the most recent error message issued by Model 204 for the current thread.

T..."