IFPROLS (HLI function)
The conventions used on this page are described in Function call notation conventions.
Summary
- Description
- The IFPROLS call (PLACE RECORDS ON LIST) places a set of found records on a list. IFPROLS creates a list or references an existing list on the current thread.
- Thread type
- multiple cursor IFSTRT
- IFCALL function number
- 109
Syntax
IFPROLS|IFPRLS(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 added to a list. Specify the records and the list as a character string using the following format:
set qualifier ON [LIST] listname where: set qualifier is required; specify the setname using the IN label clause, 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. If the list does not exist, it is created. |
Usage notes
Use the IFPROLS call to add records to a list.
The IFPROLS call is the equivalent of the PLACE RECORDS ON LIST statement in SOUL in the host language multiple cursor environment. For information about the PLACE RECORDS ON 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(20) VALUE "IN PREVFD ON LIST L;". . . . PROCEDURE DIVISION. . . . CALL "IFPROLS" USING RETCODE, LISTSPEC.