$Fsterr - Revision history

JAL: link repair

2015-03-02T20:10:40Z

link repair

← Older revision		Revision as of 20:10, 2 March 2015
Line 1:		Line 1:
	<p>		<p>
	The <var>$~~FstErr~~</var> function returns a string containing the prefix and text of the first [[Introduction to User Language#Counting errors\|counting error]] message or request cancellation message received by the user. </p>		The <var>$Fsterr</var> function returns a string containing the prefix and text of the first [[Introduction to User Language#Counting errors\|counting error]] message or request cancellation message received by the user. </p>

	==Syntax==		==Syntax==
Line 19:		Line 19:
	<li>The maximum length of the returned string is determined by the setting of the <var>[[ERRMSGL parameter\|ERRMSGL]]</var> parameter. That parameter defaults to 80 which means a maximum of 79 characters are returned, but <var>ERRMSGL</var> can be set as high as 256 which means up to 255 characters would be returned. </li>		<li>The maximum length of the returned string is determined by the setting of the <var>[[ERRMSGL parameter\|ERRMSGL]]</var> parameter. That parameter defaults to 80 which means a maximum of 79 characters are returned, but <var>ERRMSGL</var> can be set as high as 256 which means up to 255 characters would be returned. </li>

	<li><var>$~~FstErr~~</var> is not available for Host Language Interface applications. </li>		<li><var>$Fsterr</var> is not available for Host Language Interface applications. </li>

	<li>The <var>$~~FstErr~~</var> function requires an additional 88 bytes in the fixed portion of the server.</li>		<li>The <var>$Fsterr</var> function requires an additional 88 bytes in the fixed portion of the server.</li>
	</ul>		</ul>

	==Example==		==Example==
	<p>A sample <var>$~~FstErr~~</var> function with an <var>On Error</var> unit follows. To learn about <var>On Error</var> units, see [[Subroutines#ON units\|ON units]].</p>		<p>
			A sample <var>$Fsterr</var> function with an <var>On Error</var> unit follows. To learn about <var>On Error</var> units, see [[Subroutines#ON units\|ON units]].</p>
	<p class="code">begin		<p class="code">begin
	fsterr.proc: on error		fsterr.proc: on error
Line 45:		Line 46:
	==See also==		==See also==
	<ul>		<ul>
	<li>[[~~IFGERR~~ IFAM ~~function~~]] </li>		<li><var>IFGERR</var> <var class="product">[[Media:M204_HLIReference_V75.pdf\|IFAM]]</var> function </li>

	<li><var>[[$Errmsg]]</var>, which returns the <b>most recent</b> counting error message. </li>		<li><var>[[$Errmsg]]</var>, which returns the <b>most recent</b> counting error message. </li>

JAL at 19:40, 2 September 2014

2014-09-02T19:40:03Z

← Older revision		Revision as of 19:40, 2 September 2014
Line 1:		Line 1:
	<p>The <var>$FstErr</var> function returns a string containing the prefix and text of the first counting error message or request cancellation message received by the user. </p>		<p>
	<p>A null value is returned if no counting error or request cancellation message has been received since:~~</p>~~		The <var>$FstErr</var> function returns a string containing the prefix and text of the first [[Introduction to User Language#Counting errors\|counting error]] message or request cancellation message received by the user. </p>

			==Syntax==
			<p>
			This function takes no arguments. </p>

			==Usage notes==
			<ul>
			<li>A null value is returned if no counting error or request cancellation message has been received since:
	<ul>		<ul>
	<li>The beginning of the user's <var class="product">Model 204</var> session</li>		<li>The beginning of the user's <var class="product">Model 204</var> session</li>
	~~</li>~~
	<li>The last call to the <var>[[$ErrClr]]</var> function</li>		<li>The last call to the <var>[[$ErrClr]]</var> function</li>
	~~</li>~~
	<li>Processing a <var class="product">SOUL</var> <var>Open</var> statement</li>		<li>Processing a <var class="product">SOUL</var> <var>Open</var> statement</li>
	</li>		</ul></li>

			<li>The maximum length of the returned string is determined by the setting of the <var>[[ERRMSGL parameter\|ERRMSGL]]</var> parameter. That parameter defaults to 80 which means a maximum of 79 characters are returned, but <var>ERRMSGL</var> can be set as high as 256 which means up to 255 characters would be returned. </li>

			<li><var>$FstErr</var> is not available for Host Language Interface applications. </li>

			<li>The <var>$FstErr</var> function requires an additional 88 bytes in the fixed portion of the server.</li>
	</ul>		</ul>
	~~<p>Refer to the Rocket <var class~~=~~"product">Model 204</var> Messages Manual for more information on counting messages. This function takes no arguments. </p>~~
	~~<p><var>$FstErr</var> is not available for Host Language Interface applications. </p>~~		==Example==
	~~<p>The <var>$FstErr</var> function requires an additional 88 bytes in the fixed portion of the server.</p>~~
	~~<b>~~Example~~</b>~~
	<p>A sample <var>$FstErr</var> function with an <var>On Error</var> unit follows. To learn about <var>On Error</var> units, see [[Subroutines#ON units\|ON units]].</p>		<p>A sample <var>$FstErr</var> function with an <var>On Error</var> unit follows. To learn about <var>On Error</var> units, see [[Subroutines#ON units\|ON units]].</p>
	<p class="code">begin		<p class="code">begin
Line 30:		Line 42:
	end		end
	</p>		</p>
	<p>The maximum length of the returned string is determined by the setting of the <var>[[ERRMSGL parameter\|ERRMSGL]]</var> parameter. That parameter defaults to 80 which means a maximum of 79 characters are returned, but <var>ERRMSGL</var> can be set as high as 256 which means up to 255 characters would be returned.
	==See also==		==See also==
	<ul>		<ul>

JAL: /* See also */

2014-08-13T21:10:48Z

See also

← Older revision		Revision as of 21:10, 13 August 2014
Line 33:		Line 33:
	==See also==		==See also==
	<ul>		<ul>
	<li>~~the~~ [[IFGERR IFAM function]]		<li>[[IFGERR IFAM function]] </li>
	<li><var>[[$Errmsg]]</var>, which returns the <b>most recent</b> counting error message.
	<li>The <var>[[ERRMSGL parameter\|ERRMSGL]]</var> parameter, which determines the length of errors returned by <var>$Errmsg</var> and <var>$Fsterr</var>.		<li><var>[[$Errmsg]]</var>, which returns the <b>most recent</b> counting error message. </li>

			<li>The <var>[[ERRMSGL parameter\|ERRMSGL]]</var> parameter, which determines the length of errors returned by <var>$Errmsg</var> and <var>$Fsterr</var>.</li>
	</ul>		</ul>

	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Mlarocca at 14:01, 1 August 2014

2014-08-01T14:01:01Z

← Older revision		Revision as of 14:01, 1 August 2014
Line 4:		Line 4:
	<li>The beginning of the user's <var class="product">Model 204</var> session</li>		<li>The beginning of the user's <var class="product">Model 204</var> session</li>
	</li>		</li>
	<li>The last call to the <var>[[$~~ERRCLR~~]]</var> function</li>		<li>The last call to the <var>[[$ErrClr]]</var> function</li>
	</li>		</li>
	<li>Processing a <var class="product">SOUL</var> <var>Open</var> statement</li>		<li>Processing a <var class="product">SOUL</var> <var>Open</var> statement</li>
Line 34:		Line 34:
	<ul>		<ul>
	<li>the [[IFGERR IFAM function]]		<li>the [[IFGERR IFAM function]]
	<li><var>[[$~~ERRMSG~~]]</var>, which returns the <b>most recent</b> counting error message.		<li><var>[[$Errmsg]]</var>, which returns the <b>most recent</b> counting error message.
	<li>The <var>[[~~ErrMsgL~~ parameter\|ERRMSGL]]</var> parameter, which determines the length of errors returned by <var>$~~ErrMsg~~</var> and <var>$~~FstErr~~</var>.		<li>The <var>[[ERRMSGL parameter\|ERRMSGL]]</var> parameter, which determines the length of errors returned by <var>$Errmsg</var> and <var>$Fsterr</var>.
	</ul>		</ul>
	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Mlarocca: Mlarocca moved page $FSTERR to $Fsterr: Lower case change

2014-07-21T17:47:11Z

Mlarocca moved page $FSTERR to $Fsterr: Lower case change

← Older revision	Revision as of 17:47, 21 July 2014
(No difference)

Dme: /* See also */

2014-04-26T23:02:19Z

See also

← Older revision		Revision as of 23:02, 26 April 2014
Line 34:		Line 34:
	<ul>		<ul>
	<li>the [[IFGERR IFAM function]]		<li>the [[IFGERR IFAM function]]
	<li><var>[[$ERRMSG]]</var> ~~parameter~~, which returns the <b>most recent</b> counting error message.		<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</b> counting error message.
	<li>The <var>[[ErrMsgL parameter\|ERRMSGL]]</var>, which determines the length of errors returned by <var>$ErrMsg</var> and <var>$FstErr</var>.		<li>The <var>[[ErrMsgL parameter\|ERRMSGL]]</var> parameter, which determines the length of errors returned by <var>$ErrMsg</var> and <var>$FstErr</var>.
	</ul>		</ul>
	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Dme: /* See also */

2014-04-26T23:01:11Z

See also

← Older revision		Revision as of 23:01, 26 April 2014
Line 34:		Line 34:
	<ul>		<ul>
	<li>the [[IFGERR IFAM function]]		<li>the [[IFGERR IFAM function]]
	<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</b> counting error message.		<li><var>[[$ERRMSG]]</var> parameter, which returns the <b>most recent</b> counting error message.
	<li>The <var>[[ErrMsgL parameter\|ERRMSGL]]</var>, which determines the length of errors returned by <var>$ErrMsg</var> and <var>$FstErr</var>.		<li>The <var>[[ErrMsgL parameter\|ERRMSGL]]</var>, which determines the length of errors returned by <var>$ErrMsg</var> and <var>$FstErr</var>.
	</ul>		</ul>
	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Dme at 22:57, 26 April 2014

2014-04-26T22:57:39Z

← Older revision		Revision as of 22:57, 26 April 2014
Line 1:		Line 1:
	<p>The $~~FSTERR~~ function returns a ~~variable length~~ string ~~of up to 79 characters that contains~~ the prefix and the first counting error message or request cancellation message ~~you~~ received ~~since the last time that~~ the ~~count was reset to zero~~. ~~$FSTERR returns a null value, if~~ <~~var class="product"~~>~~Model 204~~<~~/var~~> ~~has not received a~~ counting error or request cancellation message since:</p>		<p>The <var>$FstErr</var> function returns a string containing the prefix and text of the first counting error message or request cancellation message received by the user. </p>
			<p>A null value is returned if no counting error or request cancellation message has been received since:</p>
	<ul>		<ul>
	<li>The beginning of ~~your~~ <var class="product">Model 204</var> session</li>		<li>The beginning of the user's <var class="product">Model 204</var> session</li>
	</li>		</li>
	<li>The last call to the <var>[[$ERRCLR]]</var> function</li>		<li>The last call to the <var>[[$ERRCLR]]</var> function</li>
	</li>		</li>
	<li>Processing a ~~User Language OPEN~~ statement</li>		<li>Processing a <var class="product">SOUL</var> <var>Open</var> statement</li>
	</li>		</li>
	</ul>		</ul>
	<p>~~For more information about counting errors or request cancellation messages, refer~~ to the Rocket <var class="product">Model 204</var> Messages Manual. ~~To return the most recent error message, refer to the~~ <var>[[$~~ERRMSG]]~~</var> ~~function. $FSTERR~~ is not available for Host Language Interface applications~~. The $FSTERR function takes no arguments~~.</p>		<p>Refer to the Rocket <var class="product">Model 204</var> Messages Manual for more information on counting messages. This function takes no arguments. </p>
	<p>The $~~FSTERR~~ function requires an additional 88 bytes in the fixed portion of the server.</p>		<p><var>$FstErr</var> is not available for Host Language Interface applications. </p>
			<p>The <var>$FstErr</var> function requires an additional 88 bytes in the fixed portion of the server.</p>
	<b>Example</b>		<b>Example</b>
	<p>~~An example of the~~ $~~FSTERR~~ function with an ~~ON ERROR~~ unit follows. ~~For more information~~, ~~refer to~~ [[Subroutines#ON units\|ON units]]. </p>		<p>A sample <var>$FstErr</var> function with an <var>On Error</var> unit follows. To learn about <var>On Error</var> units, see [[Subroutines#ON units\|ON units]].</p>
	<p class="code">~~BEGIN~~		<p class="code">begin
	~~FSTERR~~.~~PROC~~: ~~ON ERROR~~		fsterr.proc: on error
	~~PRINT~~ '~~THE REQUEST IS ENDING~~'		print 'The request is ending'
	~~PRINT~~ '~~THE FIRST ERROR MESSAGE WAS~~:'		print 'The first error message was:'
	~~PRINT~~ $~~FSTERR~~		print $fstErr
	~~END ON~~		end on

	~~GET~~.~~RECS~~: ~~FIND ALL RECORDS FOR WHICH~~		get.recs: find all records for which
	~~AGENT~~ = ~~BLAKE~~		agent = blake
	~~END FIND~~		end find
	~~FOR EACH RECORD IN GET~~.~~RECS~~		for each record in get.recs
	.		.
	.		.
	~~END FOR~~		end for
	~~END~~		end
	</p>		</p>
			<p>The maximum length of the returned string is determined by the setting of the <var>[[ERRMSGL parameter\|ERRMSGL]]</var> parameter. That parameter defaults to 80 which means a maximum of 79 characters are returned, but <var>ERRMSGL</var> can be set as high as 256 which means up to 255 characters would be returned.
	==See also==		==See also==
	<ul>		<ul>
	<li>the [[IFGERR IFAM function]]		<li>the [[IFGERR IFAM function]]
	<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</b> counting error message.		<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</b> counting error message.
	<li>The [[ERRMSGL ~~parameter~~]], which determines the length of errors returned by <var>[[$~~ERRMSG]]~~</var> and <var>[[$~~FSTERR]]~~</var>.		<li>The <var>[[ErrMsgL parameter\|ERRMSGL]]</var>, which determines the length of errors returned by <var>$ErrMsg</var> and <var>$FstErr</var>.
	</ul>		</ul>
	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Dme: /* See also */

2014-04-25T23:29:16Z

See also

← Older revision		Revision as of 23:29, 25 April 2014
Line 32:		Line 32:
	<li>the [[IFGERR IFAM function]]		<li>the [[IFGERR IFAM function]]
	<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</b> counting error message.		<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</b> counting error message.
			<li>The [[ERRMSGL parameter]], which determines the length of errors returned by <var>[[$ERRMSG]]</var> and <var>[[$FSTERR]]</var>.
	</ul>		</ul>
	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Dme at 21:21, 24 April 2014

2014-04-24T21:21:13Z

← Older revision		Revision as of 21:21, 24 April 2014
Line 28:		Line 28:
	END		END
	</p>		</p>
			==See also==
			<ul>
			<li>the [[IFGERR IFAM function]]
			<li><var>[[$ERRMSG]]</var>, which returns the <b>most recent</b> counting error message.
			</ul>
	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]