IFPROL (HLI function) - Revision history

ELowell at 19:32, 13 July 2016

2016-07-13T19:32:39Z

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

2016-07-11T22:50:59Z

← Older revision		Revision as of 22:50, 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: /* Syntax */

2016-07-08T19:05:09Z

Syntax

← Older revision		Revision as of 19:05, 8 July 2016
Line 37:		Line 37:
	<tr>		<tr>
	<td>CURSOR_NAME</td>		<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 placed on the list. Specify the cursor name as a short character string (maximum 32 characters), using the name previously assigned to the cursor in a corresponding IFOCUR call. See the description of ~~the~~ [[IFOCUR (HLI function)#CURSOR_NAME\|~~cursor name~~ for the IFOCUR call]].		<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 placed on the list. Specify the cursor name as a short character string (maximum 32 characters), 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]].
	<p class="note"><b>Note:</b> The cursor name is not a valid parameter for use with a single cursor IFSTRT thread.</p>		<p class="note"><b>Note:</b> The cursor name is not a valid parameter for use with a single cursor IFSTRT thread.</p>
	</td>		</td>

ELowell: Created page with " ==Summary==

Description

The IFPROL call (PLACE RECORD ON LIST) places the current record on the specified list.

Thread type

multiple curso..."

2016-07-08T16:45:15Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFPROL call (PLACE RECORD ON LIST) places the current record on the specified list.</dd> <dt>Thread type</dt> <dd>multiple curso..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFPROL call (PLACE RECORD ON LIST) places the current record on the specified list.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>33</dd>
</dl>

==Syntax==
IFPROL(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 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_NAME</td>
<td>[I,c,r] The list name is a required input parameter that specifies the name of the list to be used. If the list does not already exist, Model 204 creates a new list using this name. Specify a character string variable that is the name of a list, existing or new.
</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 placed on the list. Specify the cursor name as a short character string (maximum 32 characters), using the name previously assigned to the cursor in a corresponding IFOCUR call. See the description of the [[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>
</table>

==Usage notes==

Use the IFPROL call to add a record to a list if the record is not already on the list. You may use IFPROL to add records from a sorted set to a list.

The IFPROL call is valid on all types of IFSTRT threads. On a multiple cursor IFSTRT thread, you must specify the cursor whose current record is to be placed on the list. On a single cursor IFSTRT thread, IFPROL places the current record on the list. 

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

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

[[Category: HLI functions]]

IFPROL (HLI function) - Revision history

ELowell at 19:32, 13 July 2016

ELowell at 22:50, 11 July 2016

ELowell: /* Syntax */

ELowell: Created page with " ==Summary== Description The IFPROL call (PLACE RECORD ON LIST) places the current record on the specified list. Thread type multiple curso..."

ELowell: Created page with " ==Summary==

Description

The IFPROL call (PLACE RECORD ON LIST) places the current record on the specified list.

Thread type

multiple curso..."