ELowell at 19:36, 13 July 2016

2016-07-13T19:36:46Z

← Older revision		Revision as of 19:36, 13 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:55, 11 July 2016

2016-07-11T22:55:23Z

← Older revision		Revision as of 22:55, 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 IFRRFL call (REMOVE RECORD FROM LIST) removes the current record from the specified list.

Thread type

multiple..."

2016-07-08T20:39:23Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFRRFL call (REMOVE RECORD FROM LIST) removes the current record from the specified list.</dd> <dt>Thread type</dt> <dd>multiple..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFRRFL call (REMOVE RECORD FROM LIST) removes the current record from the specified list.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>34</dd>
</dl>

==Syntax==
IFRRFL(RETCODE,LIST_NAME,CURSOR_NAME)

<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>
<th>

Parameter
</th>
<th>

Description
</th>
</tr>
<tr>
<td>RETCODE</td>
<td>[O,i,r] The Model 204 return code is the required first parameter. The code is a binary integer value.</td>
</tr>
<tr>
<td>LIST_NAME</td>
<td>[I,c,r] The list name is a required input parameter that specifies the name of the list to be used. Specify a character string variable that is the name of an existing list.</td>
</tr>
<tr>
<td>CURSOR_NAME</td>
<td>[I,s,r] The name of the cursor is an input parameter that is available only for use with a multiple cursor IFSTRT thread and is required for specifying the current record to be removed. Specify the cursor name as a short character string, using the name previously assigned to the cursor in a corresponding IFOCUR call. See the description of [[IFOCUR (HLI function)#CURSOR_NAME|CURSOR_NAME for the IFOCUR call]].
Note: The cursor name is not a valid parameter for use with a single cursor IFSTRT thread.</td>
</tr>
<tr>
</tr>
</table>

==Usage notes==

Use the IFRRFL call to remove a record from a list. 

The IFRRFL call is valid on all types of IFSTRT threads. On a multiple cursor IFSTRT thread, you must specify the cursor name for the current record. On a single cursor IFSTRT thread, IFRRFL processes the current record using the set that is current for the file or group most recently opened. 

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 ARGS-FOR-CALL.
05 RETCODE PIC 9(5) COMP SYNC.
05 LISTNAME PIC X(5) VALUE "SAVE;".
.
.
.
PROCEDURE DIVISION.
.
.
CALL "IFRRFL" USING RETCODE, LISTNAME.

In this example, processing is done on a single cursor IFSTRT thread, and the IFRRFL call is preceded by IFFIND, IFLIST, and IFGET calls (not shown). 

[[Category: HLI functions]]

IFRRFL (HLI function) - Revision history

ELowell at 19:36, 13 July 2016

ELowell at 22:55, 11 July 2016

ELowell: Created page with " ==Summary== Description The IFRRFL call (REMOVE RECORD FROM LIST) removes the current record from the specified list. Thread type multiple..."

ELowell: Created page with " ==Summary==

Description

The IFRRFL call (REMOVE RECORD FROM LIST) removes the current record from the specified list.

Thread type

multiple..."