BEGIN command: Difference between revisions

Revision as of 11:02, 25 January 2015

Summary

Privileges: User
Function: Specifies the beginning of a User Language request

Syntax

BEGIN

Example

BEGIN DRIVER: FIND ALL RECORDS FOR WHICH RECTYPE = DRIVER END FIND NUM.DRIVERS: COUNT RECORDS IN DRIVER PRINT COUNT IN NUM.DRIVERS END

Usage notes

Every SOUL request must be preceded by either the Begin or More command and must be concluded by an End statement. After encountering a Begin command, Model 204 assumes that every user input line is a SOUL statement (or a portion of a statement), until the End statement is processed.

Output from a SOUL request appears on the user's terminal unless a USE command directs the output to an alternate device.

A Begin command is required even when a request is embedded in a stored procedure. SOUL requests are described in detail in the SOUL wiki pages.

When Begin follows another command which does not automatically end its own update unit (for example, DEFINE FIELD), Model 204 ends any update unit in progress and begins a non-backoutable update unit.

@@ Line 19: / Line 19: @@
 </p>
 ==Usage notes==
-<p>Every User Language request must be preceded by a BEGIN command or a MORE command and concluded by an END statement. After encountering a BEGIN command, <var class="product">Model&nbsp;204</var> assumes that every input line entered by the user is a User Language statement (or a portion of a statement), until the user specifies an END statement.</p>
+<p>Every SOUL request must be preceded by either the <var>Begin</var> or <var>[[MORE command|More]]</var> command and must be concluded by an <var>[[End statement|End]]</var> statement. After encountering a <var>Begin</var> command, <var class="product">Model&nbsp;204</var> assumes that every user input line is a SOUL statement (or a portion of a statement), until the <var>End</var> statement is processed.</p>
-<p>Output from a User Language request appears on the user's terminal unless a USE command directs the output to an alternate device.</p>
+<p>Output from a SOUL request appears on the user's terminal unless a <var>[[USE command|USE]]</var> command directs the output to an alternate device.</p>
-<p>A BEGIN command is required even when a request is embedded in a stored procedure. User Language [[Basic request structure|requests]] are described in detail in the Rocket Model&nbsp;204 User Language/SOUL wiki pages: <br/>http://m204wiki.rocketsoftware.com/index.php/Category:SOUL</p>
+<p>A <var>Begin</var> command is required even when a request is embedded in a stored procedure. SOUL [[Basic request structure|requests]] are described in detail in the [[:Category:SOUL|SOUL wiki pages]].</p>
 <p>
-When BEGIN follows another command that does not automatically end its own update unit (for example, DEFINE), <var class="product">Model&nbsp;204</var> ends any update unit in progress and begins a [[File_integrity_and_recovery#Non-backoutable_update_units|non-backoutable update unit]].</p>
+When <var>Begin</var> follows another command which does not automatically end its own update unit (for example, <var>[[DEFINE FIELD command|DEFINE FIELD]]</var>), <var class="product">Model&nbsp;204</var> ends any update unit in progress and begins a [[File_integrity_and_recovery#Non-backoutable_update_units|non-backoutable update unit]].</p>
 [[Category:Commands]]