ELowell at 19:33, 13 July 2016

2016-07-13T19:33:00Z

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

2016-07-11T22:51:28Z

← Older revision		Revision as of 22:51, 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 IFPROLS call (PLACE RECORDS ON LIST) places a set of found records on a list. IFPROLS creates a list or references an existing l..."

2016-07-08T16:48:16Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFPROLS call (PLACE RECORDS ON LIST) places a set of found records on a list. IFPROLS creates a list or references an existing l..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>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.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>109</dd>
</dl>

==Syntax==
IFPROLS|IFPRLS(RETCODE,LIST_SPEC)

<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 first parameter. The code is a binary integer value.</td>
</tr>
<tr>
<td>LIST_SPEC</td>
<td>[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:

<var class="term">set qualifier</var> is required; specify the setname using the IN <var class="term">label</var> clause, where <var class="term">label</var> is the name of a saved IFFIND, IFFNDX, IFFWOL, IFFAC, IFSORT, IFFDV, or IFSRTV compilation from a previously compiled call. 

<var class="term">listname</var> is required and specifies the name of a particular list. If the list does not exist, it is created.
</td>
</tr>
</table>

==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.

[[Category: HLI functions]]

IFPROLS (HLI function) - Revision history

ELowell at 19:33, 13 July 2016

ELowell at 22:51, 11 July 2016

ELowell: Created page with " ==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 l..."

ELowell: Created page with " ==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 l..."