https://m204wiki.rocketsoftware.com/index.php?title=IFFWOL_(HLI_function)&feed=atom&action=historyIFFWOL (HLI function) - Revision history2024-03-29T12:19:01ZRevision history for this page on the wikiMediaWiki 1.40.1https://m204wiki.rocketsoftware.com/index.php?title=IFFWOL_(HLI_function)&diff=89172&oldid=prevELowell at 23:01, 12 July 20162016-07-12T23:01:42Z<p></p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 23:01, 12 July 2016</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l1">Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>The conventions used on this page are described in [[HLI: Function <del style="font-weight: bold; text-decoration: none;">call list</del>#Function call notation conventions|Function call notation conventions]].</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>The conventions used on this page are described in [[HLI: Function <ins style="font-weight: bold; text-decoration: none;">summary</ins>#Function call notation conventions|Function call notation conventions]].</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>==Summary==</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>==Summary==</div></td></tr>
</table>ELowellhttps://m204wiki.rocketsoftware.com/index.php?title=IFFWOL_(HLI_function)&diff=88796&oldid=prevELowell at 22:07, 11 July 20162016-07-11T22:07:58Z<p></p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 22:07, 11 July 2016</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l1">Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">The conventions used on this page are described in [[HLI: Function call list#Function call notation conventions|Function call notation conventions]].</ins></div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>==Summary==</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>==Summary==</div></td></tr>
</table>ELowellhttps://m204wiki.rocketsoftware.com/index.php?title=IFFWOL_(HLI_function)&diff=87152&oldid=prevELowell: Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFFWOL call (FIND WITHOUT LOCKS) selects records from a Model 204 file or group without obtaining record locks and creates a fou..."2016-07-07T20:08:42Z<p>Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFFWOL call (FIND WITHOUT LOCKS) selects records from a Model 204 file or group without obtaining record locks and creates a fou..."</p>
<p><b>New page</b></p><div><br />
==Summary==<br />
<dl><br />
<dt>Description</dt><br />
<dd>The IFFWOL call (FIND WITHOUT LOCKS) selects records from a Model 204 file or group without obtaining record locks and creates a found set.</dd><br />
<dt>Thread type</dt><br />
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd><br />
<dt>IFCALL function number</dt><br />
<dd>87</dd><br />
</dl><br />
<br />
==Syntax==<br />
<p class="syntax">IFFWOL|IFFWO(RETCODE,FIND_SPEC,FWOL_NAME,%VARBUF,%VARSPEC)</p><br />
<dl><br />
<dt>Compile-only form</dt><br />
<dd>IFCALL function number: 88<br />
<p class="syntax">IFFWOLC|IFFWOC(RETCODE,FIND_SPEC,FWOL_NAME)</p></dd><br />
<dt>Execute-only form</dt><br />
<dd> IFCALL function number: 89<br />
<p class="syntax">IFFWOLE|IFFWOE(RETCODE,FWOL_NAME,%VARBUF,%VARSPEC)</p></dd><br />
</dl><br />
<br />
<p>Specify the parameters in the syntax order shown above.</p><br />
<table><br />
<tr class="head"><br />
<th>Parameter</th><br />
<th>Description</th><br />
</tr><br />
<tr><br />
<td>RETCODE</td><br />
<td>[O,i,r] The Model 204 return code is the required first parameter. The code is a binary integer value.</td><br />
</tr><br />
<tr><br />
<td>FIND_SPEC</td><br />
<td>[I,c,r] The find specification is a required input parameter that is the selection criteria to be used for retrieving records. Specify the selection criteria as a character string.<br />
<p><br />
See [[IFFIND (HLI function)#FIND_SPEC|FIND_SPEC]] for a detailed description of the find specification used for IFFIND that is also valid for IFFWOL. </p><br />
</td><br />
</tr><br />
<tr><br />
<td>FWOL_NAME</td><br />
<td>[I,s,r/o] The name of the IFFWOL compilation is an input parameter that is required for use with a multiple cursor IFSTRT thread. It is only required for a single cursor IFSTRT thread if using the Compiled IFAM facility (IFFWOLC and IFFWOLE). Model 204 saves the compilation using this name.<br />
<p><br />
Specify the name as unique and as a short character string (maximum 32 characters). <br />
<ul><br />
<li>On a single cursor IFSTRT thread, any characters <i>except</i> the following are valid in the name: blank, comma, parenthesis, equal sign, or semicolon.</li> <br />
<li>On a multiple cursor IFSTRT thread, the first character in the name must be alphanumeric, and the name must begin with a letter (A-Z or a-z) which may be followed by a letter, a digit (0-9), a period (.), or underscore (_).</li><br />
</ul> <br />
</p><br />
<p class="note"><b>Note:</b> A null value is equivalent to omitting the name parameter and is not valid for a multiple cursor thread.</p><br />
</td><br />
</tr><br />
<tr><br />
<td>%VARBUF</td><br />
<td>[I,c,o] The variable buffer is an optional input parameter that addresses a data area, which accommodates up to 255 bytes of data per value. The buffer contains values that are defined by the %VARSPEC parameter, below, to be assigned to %variables. Specify a character string. For information about %variables, see [[Using variables and values in computation]].</td><br />
</tr><br />
<tr><br />
<td>%VARSPEC</td><br />
<td>[I,c,o] The variable specification describes the format of the data that is contained in the %VARBUF parameter and lists the %variables to be assigned. %VARSPEC specifies the contents of the variable buffer, described above. Specify a character string which follows a LIST, DATA, or EDIT syntax.<br />
<p><br />
%VARSPEC is a required input parameter if %VARBUF is specified.</p><br />
</td><br />
</tr><br />
</table><br />
<br />
==Usage notes==<br />
<p><br />
Use the IFFWOL call to retrieve records without locks. The find specification is based on a specified combination of retrieval conditions and is identical to the one that is used with the IFFIND call.</p><br />
<br />
==Completion return code (RETCODE)==<br />
<p><br />
A completion code of 4 indicates an IFFWOL error. If the IFFWOL call is unsuccessful, Model 204 returns a completion code of 4 for the following error conditions: </p><br />
<ul><br />
<li>An error in an IFFWOL specification. Note that Model 204 does not save the compilation and does not define the compilation name.</li><br />
<li>A field name variable is replaced by a non-existent field. In this case, Model 204 does not execute the IFFWOL, but it does save the compilation if the name parameter is specified. </li><br />
<li>An error is encountered in a %variable parameter.</li><br />
</ul><br />
<br />
==Coding example (COBOL)==<br />
<p class="code">WORKING-STORAGE SECTION.<br />
01 CALL-ARGS.<br />
05 RETCODE PIC 9(5) COMP SYNC.<br />
05 QUAL-1 PIC X(75) VALUE 'SEX=FEMALE;<br />
OCCUPATION=DOCTOR OR DENTIST;<br />
CITY=BOSTON;NAME LIKE "PAT*";END;'.<br />
.<br />
.<br />
.<br />
PROCEDURE DIVISION.<br />
.<br />
.<br />
.<br />
CALL "IFFWOL" USING RETCODE, QUAL-1.</p><br />
<br />
[[Category: HLI functions]]</div>ELowell