IFRRFLS (HLI function)

The conventions used on this page are described in Function call notation conventions.

Summary

Description

The IFRRFLS call (REMOVE RECORDS FROM LIST) removes records from a particular list on the current thread.

Thread type

multiple cursor IFSTRT

IFCALL function number

110

Syntax

IFRRFLS|IFRFLS(RETCODE,LIST_SPEC)

Compile-only form

Not available

Execute-only form

Not available

Specify the parameters in the syntax order shown above.

Parameter	Description
RETCODE	[O,i,r] The Model 204 return code is the required first parameter. The code is a binary integer value.
LIST_SPEC	[I,c,r] The list specification is a required input parameter that specifies an existing set of found records to be matched against and removed from a particular list. Specify the record set and the list as a character string using the following format: set qualifier FROM [LIST] listname where: set qualifier is required and specifies the name of a previously established found set or list using the IN label format, where label is the name of a saved IFFIND, IFFNDX, IFFWOL, IFFAC, IFSORT, IFFDV, or IFSRTV compilation from a previously compiled call. listname is required and specifies the name of a particular list from which records (having a match in the found set) will be removed.

Usage notes

Use the IFRRFLS call to delete from a particular list any records that match those in the specified found set or list.

The IFRRFLS call is the equivalent of the REMOVE RECORDS FROM LIST statement in SOUL in the host language multiple cursor environment. For information about the REMOVE RECORDS FROM LIST statement, see DML statements in Parallel Query Option/204.

Coding example (COBOL)

WORKING-STORAGE SECTION. 01 CALL-ARGS. 05 RETCODE PIC 9(5) COMP SYNC. 05 LISTSPEC PIC X(22) VALUE "IN PREVFD FROM LIST L;". . . . PROCEDURE DIVISION. . . . CALL "IFRRFLS" USING RETCODE, LISTSPEC.