MORE command

From m204wiki
Revision as of 16:12, 22 March 2017 by ELowell (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Summary

Privileges
Any user
Function
Indicates to Model 204 that the next SOUL request is a continuation of the previous request

Syntax

More

Usage notes

A SOUL request normally is preceded by a Begin command and concluded by an End statement. However, if the More command is used rather than Begin, Model 204 considers the request that follows to be a continuation of the previous request. The continued request can refer to statement labels and other information contained in the previous request.

A request that is to be continued must be concluded by:

end more

not simply by End.

The following example shows the use of the More command:

begin . . . SOUL statement(s) . . . end more request output . . . command(s) . . . more . . . SOUL statement(s) . . . end request output

Request continuation is used to break up requests that otherwise would be too large to run (that is, would exhaust work table space), or to increase user interaction with Model 204 without increasing retrieval costs.

If a request ends with an End More Use statement, the USE data set is left open after the request has been completed. This allows a continuation to add to the USE output without having the page number reset.

After Model 204 encounters an End statement without More, it does not consider subsequent requests to be continuations. Request continuation is described in greater detail in Large request considerations.

When More follows another command that 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. See Update units and transactions for more information.