IFRELR (HLI function): Difference between revisions
No edit summary |
m (link repair) |
||
| Line 4: | Line 4: | ||
<dl> | <dl> | ||
<dt>Description</dt> | <dt>Description</dt> | ||
<dd>The IFRELR call ( | <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> | |||
<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 | 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# | 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)== | ||
Latest revision as of 16:29, 25 April 2018
The conventions used on this page are described in Function call notation conventions.
Summary
- Description
- The IFRELR call (Release Records) releases a particular record set held by the current thread.
- Thread type
- multiple cursor IFSTRT
- IFCALL function number
- 103
Syntax
IFRELR(RETCODE,SET_QUAL)
- 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. |
| SET_QUAL | [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: label is the name of a saved IFFIND, IFFNDX, IFFWOL, IFFAC, IFSORT, IFFDV, or IFSRTV compilation from a previously compiled call. listname specifies the name of a list that contains the found set. |
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 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.