$FunSkip - Revision history

JAL: UL Interface becomes SOUL Interface

2015-03-16T20:17:31Z

UL Interface becomes SOUL Interface

← Older revision		Revision as of 20:17, 16 March 2015
Line 2:		Line 2:
	<span class="pageSubtitle">Skip to next output record for $FunImg, $FunsStr</span>		<span class="pageSubtitle">Skip to next output record for $FunImg, $FunsStr</span>

	This skips the current <i>[[Fast/Unload]]</i> output record for a request so ~~that~~ subsequent [[$FunImg]] and [[$FunsStr]] calls ~~will~~ operate on the next record.		This skips the current <var class="product">[[Fast/Unload]]</var> output record for a request, so subsequent <var>[[$FunImg]]</var> and <var>[[$FunsStr]]</var> calls operate on the next record.

	The <var>$FunSkip</var> function accepts one argument and returns a numeric result.		The <var>$FunSkip</var> function accepts one argument and returns a numeric result.

	~~The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.~~
	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%result</span> = <span class="literal">$FunSkip</span>(<span class="term">req_num</span>)</p>		<p class="syntax"><span class="term">%result</span> = <span class="literal">$FunSkip</span>(<span class="term">req_num</span>)</p>

			The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.
	<p>		<p>
	<var class="term">%result</var> is set to 1~~, or it is set to an~~ error code if there is no record to skip~~.</p>~~		<var class="term">%result</var> is set to either of these:</p>
	<p class="code">		<ul>
	1 - Record skipped		<li>1</li>
	0 - Fast/Unload completed with return code 0; no more data
	-1 - Request not found		<li>An error code, if there is no record to skip:
	<-1 - Fast/Unload completed with non-zero return code, value		<p class="code"> 1 — Record skipped
	returned is negative of return code; no more data		0 — Fast/Unload completed with return code 0; no more data
	</p>		-1 — Request not found
	<~~p class="caption"~~>~~$FunSkip Error Codes~~		<-1 — Fast/Unload completed with non-zero return code, value
	</p>		returned is negative of return code; no more data </p></li>
			</ul>

	If <i>[[Fast/Unload]]</i> has not unloaded any records yet, <var>$FunSkip</var> ~~will wait~~ for the first record. If <var>$FunSkip</var> returns a value less than or equal to 0, the request has completed.		==Usage notes==
			<ul>
			<li>If <var class="product">Fast/Unload</var> has not unloaded any records yet, <var>$FunSkip</var> waits for the first record. If <var>$FunSkip</var> returns a value less than or equal to 0, the request has completed. </li>

	<var>$FunSkips</var> can be mixed with [[$FunsStr]] and [[$FunImg]] calls for the same request. In addition, multiple unloads can be performed simultaneously with <var>$FunSkip</var> calls for the different requests mixed freely.		<li><var>$FunSkips</var> can be mixed with <var>$FunsStr</var> and <var>$FunImg</var> calls for the same request. In addition, multiple unloads can be performed simultaneously with <var>$FunSkip</var> calls for the different requests mixed freely. </li>
			</ul>

	==Example==		==Example==
	The following example compares the first two bytes of each unloaded record with 'XX'. If they are equal, the record is copied into image 'IMAGE' and then processed; otherwise the record is simply skipped.		The following example compares the first two bytes of each unloaded record with <code>XX</code>. If they are equal, the record is copied into image <code>IMAGE</code> and then processed; otherwise the record is simply skipped.
	<p class="code">%REQ = $FunLoad('DATA', , , '*')		<p class="code">%REQ = $FunLoad('DATA', , , '*')
	IF %REQ LE 0 THEN		IF %REQ LE 0 THEN
Line 46:		Line 51:
	==Products authorizing {{PAGENAMEE}}==		==Products authorizing {{PAGENAMEE}}==
	<ul class="smallAndTightList">		<ul class="smallAndTightList">
	<li>[[Fast/Unload ~~User Language~~ Interface]]		<li>[[Fast/Unload SOUL Interface]]
	</ul>		</ul>

	[[Category:$Functions\|$FunSkip]]		[[Category:$Functions\|$FunSkip]]
	[[Category:Fast/Unload ~~User Language~~ Interface]]		[[Category:Fast/Unload SOUL Interface]]

ELowell at 21:50, 11 November 2014

2014-11-11T21:50:01Z

← Older revision		Revision as of 21:50, 11 November 2014
Line 2:		Line 2:
	<span class="pageSubtitle">Skip to next output record for $FunImg, $FunsStr</span>		<span class="pageSubtitle">Skip to next output record for $FunImg, $FunsStr</span>

	This skips the current ''[[Fast/Unload]]'' output record for a request so that subsequent [[$FunImg]] and [[$FunsStr]] calls will operate on the next record.		This skips the current <i>[[Fast/Unload]]</i> output record for a request so that subsequent [[$FunImg]] and [[$FunsStr]] calls will operate on the next record.

	The <var>$FunSkip</var> function accepts one argument and returns a numeric result.		The <var>$FunSkip</var> function accepts one argument and returns a numeric result.
Line 21:		Line 21:
	</p>		</p>

	If ''[[Fast/Unload]]'' has not unloaded any records yet, <var>$FunSkip</var> will wait for the first record. If <var>$FunSkip</var> returns a value less than or equal to 0, the request has completed.		If <i>[[Fast/Unload]]</i> has not unloaded any records yet, <var>$FunSkip</var> will wait for the first record. If <var>$FunSkip</var> returns a value less than or equal to 0, the request has completed.

	<var>$FunSkips</var> can be mixed with [[$FunsStr]] and [[$FunImg]] calls for the same request. In addition, multiple unloads can be performed simultaneously with <var>$FunSkip</var> calls for the different requests mixed freely.		<var>$FunSkips</var> can be mixed with [[$FunsStr]] and [[$FunImg]] calls for the same request. In addition, multiple unloads can be performed simultaneously with <var>$FunSkip</var> calls for the different requests mixed freely.

JAL: /* Syntax */

2013-04-10T22:35:33Z

Syntax

← Older revision		Revision as of 22:35, 10 April 2013
Line 8:		Line 8:
	The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.		The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.
	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%result</span> = <span class="literal">$FunSkip</span>(<span class="term">req_num</span>		<p class="syntax"><span class="term">%result</span> = <span class="literal">$FunSkip</span>(<span class="term">req_num</span>)</p>
	<p>		<p>
	<var class="term">%result</var> is set to 1, or it is set to an error code if there is no record to skip.</p>		<var class="term">%result</var> is set to 1, or it is set to an error code if there is no record to skip.</p>
Line 23:		Line 23:
	If ''[[Fast/Unload]]'' has not unloaded any records yet, <var>$FunSkip</var> will wait for the first record. If <var>$FunSkip</var> returns a value less than or equal to 0, the request has completed.		If ''[[Fast/Unload]]'' has not unloaded any records yet, <var>$FunSkip</var> will wait for the first record. If <var>$FunSkip</var> returns a value less than or equal to 0, the request has completed.

	<var>$FunSkips</var> can be mixed with [[$FunsStr]] and [[$FunImg]] calls for the same request. In addition, multiple unloads can be performed simultaneously with <var>$FunSkip</var> calls for the different requests mixed freely.		<var>$FunSkips</var> can be mixed with [[$FunsStr]] and [[$FunImg]] calls for the same request. In addition, multiple unloads can be performed simultaneously with <var>$FunSkip</var> calls for the different requests mixed freely.

	==Example==		==Example==

JAL: /* Products authorizing {{PAGENAMEE}} */

2013-04-10T22:34:58Z

Products authorizing {{PAGENAMEE}}

← Older revision		Revision as of 22:34, 10 April 2013
Line 48:		Line 48:
	<li>[[Fast/Unload User Language Interface]]		<li>[[Fast/Unload User Language Interface]]
	</ul>		</ul>
	~~</p>~~
	~~<p>~~
	~~</p>~~

	[[Category:$Functions\|$FunSkip]]		[[Category:$Functions\|$FunSkip]]
	[[Category:Fast/Unload User Language Interface]]		[[Category:Fast/Unload User Language Interface]]

JAL: /* Syntax */

2013-04-10T22:34:35Z

Syntax

← Older revision		Revision as of 22:34, 10 April 2013
Line 8:		Line 8:
	The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.		The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.
	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%result</span> = <span class="literal">$FunSkip</span>(<span class="term">req_num)		<p class="syntax"><span class="term">%result</span> = <span class="literal">$FunSkip</span>(<span class="term">req_num</span>
	</p>
	<p>		<p>
	</p>		<var class="term">%result</var> is set to 1, or it is set to an error code if there is no record to skip.</p>
	<p>~~%result~~ is set to 1, or it is set to an error code if there is no record to skip.</p>
	<p class="code">		<p class="code">
	1 - Record skipped		1 - Record skipped
Line 27:		Line 25:
	<var>$FunSkips</var> can be mixed with [[$FunsStr]] and [[$FunImg]] calls for the same request. In addition, multiple unloads can be performed simultaneously with <var>$FunSkip</var> calls for the different requests mixed freely.		<var>$FunSkips</var> can be mixed with [[$FunsStr]] and [[$FunImg]] calls for the same request. In addition, multiple unloads can be performed simultaneously with <var>$FunSkip</var> calls for the different requests mixed freely.

			==Example==
	The following example compares the first two bytes of each unloaded record with 'XX'. If they are equal, the record is copied into image 'IMAGE' and then processed; otherwise the record is simply skipped.		The following example compares the first two bytes of each unloaded record with 'XX'. If they are equal, the record is copied into image 'IMAGE' and then processed; otherwise the record is simply skipped.
	<p class="code"> %REQ = $FunLoad('DATA', , , '*')		<p class="code">%REQ = $FunLoad('DATA', , , '*')
	IF %REQ LE 0 THEN		IF %REQ LE 0 THEN
	STOP		STOP
	END IF		END IF

	~~%RC = 1~~
	~~REPEAT WHILE %RC > 0~~
	~~%TEST = $FunsStr( %REQ, 1, 2)~~
	~~IF %TEST EQ 'XX' THEN~~
	~~%RC = $FunImg( %REQ, %IMAGE:ITEM )~~
	~~CALL PROCESS~~
	~~ELSE~~
	~~%RC = $FunSkip~~
	~~END IF~~
	~~END REPEAT~~

			%RC = 1
			REPEAT WHILE %RC > 0
			%TEST = $FunsStr( %REQ, 1, 2)
			IF %TEST EQ 'XX' THEN
			%RC = $FunImg( %REQ, %IMAGE:ITEM )
			CALL PROCESS
			ELSE
			%RC = $FunSkip
			END IF
			END REPEAT
	</p>		</p>
	~~<p class="code">~~

	==Products authorizing {{PAGENAMEE}}==		==Products authorizing {{PAGENAMEE}}==

JALWiccan: Automatically generated page update

2013-04-10T21:52:15Z

Automatically generated page update

← Older revision		Revision as of 21:52, 10 April 2013
Line 8:		Line 8:
	The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.		The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.
	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%result</span> = $FunSkip(req_num)		<p class="syntax"><span class="term">%result</span> = <span class="literal">$FunSkip</span>(<span class="term">req_num)
	</p>		</p>
	<p>		<p>

JALWiccan: Automatically generated page update

2013-04-10T21:28:34Z

Automatically generated page update

← Older revision		Revision as of 21:28, 10 April 2013
Line 8:		Line 8:
	The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.		The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.
	==Syntax==		==Syntax==
	<p class="syntax">%result = $FunSkip(req_num)		<p class="syntax"><span class="term">%result</span> = $FunSkip(req_num)
	</p>		</p>
	<p>		<p>

JALWiccan: Automatically generated page update

2013-04-10T18:16:53Z

Automatically generated page update

← Older revision		Revision as of 18:16, 10 April 2013
Line 8:		Line 8:
	The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.		The only argument is the request identifier returned by <var>$FunLoad</var> for the request from which data is to be retrieved. This is a required argument.
	==Syntax==		==Syntax==
	<p class="syntax"~~><section begin="syntax" /~~>%result = $FunSkip(req_num)		<p class="syntax">%result = $FunSkip(req_num)
	~~<section end="syntax" />~~</p>		</p>
	<p>		<p>
	</p>		</p>

DmeWiccan: 1 revision

2012-11-07T21:32:44Z

1 revision

← Older revision	Revision as of 21:32, 7 November 2012
(No difference)

JALWiccan: 1 revision

2012-11-07T21:32:39Z

1 revision

← Older revision		Revision as of 21:32, 7 November 2012
Line 47:		Line 47:
	<p class="code">		<p class="code">

	~~<h2>~~Products authorizing {{PAGENAMEE}}~~</h2>~~<ul class="smallAndTightList">		==Products authorizing {{PAGENAMEE}}==
			<ul class="smallAndTightList">
	<li>[[Fast/Unload User Language Interface]]		<li>[[Fast/Unload User Language Interface]]
	</ul>		</ul>