IFRRFLS (HLI function)

From m204wiki
Jump to navigation Jump to search

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.