ELowell at 22:50, 12 July 2016

2016-07-12T22:50:41Z

← Older revision		Revision as of 22:50, 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:02, 11 July 2016

2016-07-11T22:02:00Z

← Older revision		Revision as of 22:02, 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 IFERLC call (EXAMINE RECORD LOCKING CONFLICT) returns a file name, record number, and user name after a record locking conflict..."

2016-07-06T23:26:37Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd> The IFERLC call (EXAMINE RECORD LOCKING CONFLICT) returns a file name, record number, and user name after a record locking conflict..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>
The IFERLC call (EXAMINE RECORD LOCKING CONFLICT) returns a file name, record number, and user name after a record locking conflict occurs in an HLI program that issued IFFIND, IFUPDT, or any other call that requires locking a record.
For information about which calls lock records and record sets, see [[HLI: Locking behavior of HLI calls]].
IFERLC is similar to the [[On_statement#On_units_2|ON RLC]] statement in SOUL.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT </dd>
<dt>IFCALL function number</dt>
<dd>138</dd>
</dl>

==Syntax==
IFERLC(RETCODE,RECNUM,USERNUM,FILENAME)
<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 the required output parameter. The code is a binary integer value.</td>
</tr>
<tr>
<td>RECNUM</td>
<td>[O,c,o] The record number is an optional output parameter that returns the internal record number for which the record locking conflict occurred. This parameter is a character string.</td>
</tr>
<tr>
<td>USERNUM</td>
<td>[O,c,o] The user number is an optional output parameter that returns the user number of the user with which the IFAM program conflicted. The parameter is a character string.</td>
</tr>
<tr>
<td>FILENAME</td>
<td>[O,c,o] The file name is an optional output parameter that returns the name of the file in which the record locking conflict occurred. The name is a character string.</td>
</tr>
</table>

==Usage notes==

Use the IFERLC call after a record locking conflict (return code 3) is returned by Model 204 to an HLI program that issued a call that locks a record (such as IFFIND, IFSTOR or IFUPDT). For more information about record locking conflicts, see [[Record level locking and concurrency control]].

==Completion return code (RETCODE)==

If no record locking conflict is found, IFERLC returns an error code of 15.

For more information, see: 
[[$RlcFile|$RlcFile function]] 
[[$RlcRec|$RlcRec function]] 
[[$RlcUsr|$RlcUsr function]]

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 CALL-ARGS.
05 RETCODE PIC 9(5) COMP SYNC.
05 RECNUM PIC X(11).
05 USERNUM PIC X(5).
05 FILENAME PIC X(8) VALUE "FN1;".
.
.
.
PROCEDURE DIVISION.
.
.
.
CALL "IFERLC" USING RETCODE, RECNUM, USERNUM, FILENAME.

[[Category: HLI functions]]

IFERLC (HLI function) - Revision history

ELowell at 22:50, 12 July 2016

ELowell at 22:02, 11 July 2016

ELowell: Created page with " ==Summary== Description The IFERLC call (EXAMINE RECORD LOCKING CONFLICT) returns a file name, record number, and user name after a record locking conflict..."

ELowell: Created page with " ==Summary==

Description

The IFERLC call (EXAMINE RECORD LOCKING CONFLICT) returns a file name, record number, and user name after a record locking conflict..."