IFRELR (HLI function) - Revision history

JAL: link repair

2018-04-25T16:29:09Z

link repair

← Older revision		Revision as of 16:29, 25 April 2018
Line 4:		Line 4:
	<dl>		<dl>
	<dt>Description</dt>		<dt>Description</dt>
	<dd>The IFRELR call (~~RELEASE RECORDS~~) releases a particular record set held by the current thread.</dd>		<dd>The <var>IFRELR</var> call (Release Records) releases a particular record set held by the current thread.</dd>
	<dt>Thread type</dt>		<dt>Thread type</dt>
	<dd>multiple cursor IFSTRT</dd>		<dd>multiple cursor <var>IFSTRT</var></dd>
	<dt>IFCALL function number</dt>		<dt>IFCALL function number</dt>
	<dd>103</dd>		<dd>103</dd>
Line 27:		Line 27:
	<th>Description</th>		<th>Description</th>
	</tr>		</tr>

	<tr>		<tr>
	<td>RETCODE</td>		<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>		<td>[O,i,r] The Model 204 return code is the required first parameter. The code is a binary integer value.</td>
	</tr>		</tr>

	<tr class="head">		<tr class="head">
	<td>SET_QUAL</td>		<td>SET_QUAL</td>
Line 36:		Line 38:
	<p class="syntax">[IN <span class="term">label</span> \| ON [LIST] <span class="term">listname</span>]</p>		<p class="syntax">[IN <span class="term">label</span> \| ON [LIST] <span class="term">listname</span>]</p>
	<p>		<p>
	~~where~~: </p>		Where: </p>
	<p>		<p>
	<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. </p>		<var class="term">label</var> is the name of a saved <var>IFFIND</var>, <var>IFFNDX</var>, <var>IFFWOL</var>, <var>IFFAC</var>, <var>IFSORT</var>, <var>IFFDV</var>, or <var>IFSRTV</var> compilation from a previously compiled call. </p>
	<p>		<p>
	<var class="term">listname</var> specifies the name of a list that contains the found set.</p>		<var class="term">listname</var> specifies the name of a list that contains the found set. </p></td>
	</td>
	</tr>		</tr>
	</table>		</table>
Line 47:		Line 48:
	==Usage notes==		==Usage notes==
	<p>		<p>
	Use the IFRELR call to explicitly release a single found set of records. </p>		Use the <var>IFRELR</var> call to explicitly release a single found set of records. </p>
	<p>		<p>
	If you issue an IFRELR call on a sorted set, Model 204 frees the records in the scratch file. If you issue an IFRELR call on a list, Model 204 performs a ~~CLEAR LIST~~ function. See the IFCLST (~~CLEAR LIST~~) call. </p>		If you issue an <var>IFRELR</var> call on a sorted set, Model 204 frees the records in the scratch file. If you issue an <var>IFRELR</var> call on a list, Model 204 performs a Clear List function. See the <var>IFCLST</var> (Clear List) call. </p>
	<p>		<p>
	The IFRELR call is the equivalent of the [[Record level locking and concurrency control#~~RELEASE RECORDS~~ statement\|~~RELEASE RECORDS~~ statement]] in SOUL in the host language multiple cursor environment.</p>		The <var>IFRELR</var> call is the equivalent of the [[Record level locking and concurrency control#Release Records statement\|Release Records statement]] in SOUL in the host language multiple cursor environment.</p>

	==Coding example (COBOL)==		==Coding example (COBOL)==

ELowell at 19:34, 13 July 2016

2016-07-13T19:34:37Z

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

2016-07-11T22:53:23Z

← Older revision		Revision as of 22:53, 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 IFRELR call (RELEASE RECORDS) releases a particular record set held by the current thread.

Thread type

multipl..."

2016-07-08T18:55:25Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFRELR call (RELEASE RECORDS) releases a particular record set held by the current thread.</dd> <dt>Thread type</dt> <dd>multipl..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFRELR call (RELEASE RECORDS) releases a particular record set held by the current thread.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>103</dd>
</dl>

==Syntax==
IFRELR(RETCODE,SET_QUAL)

<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 class="head">
<td>SET_QUAL</td>
<td>[I,c,r] The set qualifier is required for specifying the record set or list whose records will be released. Specify the set qualifier as a character string using either one of the following formats:
[IN label | ON [LIST] listname]

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> specifies the name of a list that contains the found set.
</td>
</tr>
</table>

==Usage notes==

Use the IFRELR call to explicitly release a single found set of records. 

If you issue an IFRELR call on a sorted set, Model 204 frees the records in the scratch file. If you issue an IFRELR call on a list, Model 204 performs a CLEAR LIST function. See the IFCLST (CLEAR LIST) call. 

The IFRELR call is the equivalent of the [[Record level locking and concurrency control#RELEASE RECORDS statement|RELEASE RECORDS statement]] in SOUL in the host language multiple cursor environment.

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 CALL-ARGS.
05 RETCODE PIC 9(5) COMP SYNC.
05 REL-SPEC PIC X(10) VALUE "IN PREVFD;".
.
.
.
PROCEDURE DIVISION.

.
.
.
CALL "IFRELR" USING RETCODE, REL-SPEC.

[[Category: HLI functions]]

IFRELR (HLI function) - Revision history

JAL: link repair

ELowell at 19:34, 13 July 2016

ELowell at 22:53, 11 July 2016

ELowell: Created page with " ==Summary== Description The IFRELR call (RELEASE RECORDS) releases a particular record set held by the current thread. Thread type multipl..."

ELowell: Created page with " ==Summary==

Description

The IFRELR call (RELEASE RECORDS) releases a particular record set held by the current thread.

Thread type

multipl..."