Laura: /* Syntax */

2014-05-06T17:05:43Z

Syntax

← Older revision		Revision as of 17:05, 6 May 2014
Line 14:		Line 14:

	==Syntax==		==Syntax==
			LOAD <file name> [{SOURCE\|OBJECT}]

	[[Image:Load.png]]		[[Image:Load.png]]

Mikhail.zheleznov: Created and added new Syntax diagram

2011-12-26T15:39:56Z

Created and added new Syntax diagram

← Older revision		Revision as of 15:39, 26 December 2011
Line 23:		Line 23:
	==Parameters==		==Parameters==

	Load requires the '''file~~-ref~~''' parameter, which tells BR which file to load into memory. If you do not provide an extension with the file-ref, BR looks for a file with the extension .BR.		Load requires the '''file name''' parameter, which tells BR which file to load into memory. If you do not provide an extension with the file-ref, BR looks for a file with the extension .BR.

	The optional '''OBJECT''' parameter loads the object portion of a saved program. If no extension is specified in the file-ref, BR looks for a file with the extension .BRO.		The optional '''OBJECT''' parameter loads the object portion of a saved program. If no extension is specified in the file-ref, BR looks for a file with the extension .BRO.

Mikhail.zheleznov: Imported LOAD command page from old wiki

2011-12-26T15:36:19Z

Imported LOAD command page from old wiki

New page

The '''Load (LO)''' [[command]] loads a program file from disk to memory. The Load command has been enhanced to load a specified [[library]] as [[resident]].

==Comments and Examples==

When executing the Load command, BR finds the file to load, performs a [[Clear]] operation and then loads the specified file. If the specified file cannot be found, BR leaves memory intact.

BR automatically searches for a file with the appropriate default extension for the parameters you specify with the Load command. To prevent this you must include a period (or an extension) after the file name. To load the file NAME (with no extension), then, you would use the following command:

LOAD NAME.

The following example loads PROG.BRS, a program source file located on the disk in drive B:

LOAD B:PROG SOURCE

==Syntax==

[[Image:Load.png]]

==Defaults==

Load the executable portion of a saved program. If the file does not specify an extension, use .BR or .BRO (see also the [[ChainDflt]] configuration specification in the [[BRConfig.sys]]).

==Parameters==

Load requires the '''file-ref''' parameter, which tells BR which file to load into memory. If you do not provide an extension with the file-ref, BR looks for a file with the extension .BR.

The optional '''OBJECT''' parameter loads the object portion of a saved program. If no extension is specified in the file-ref, BR looks for a file with the extension .BRO.

The optional '''SOURCE''' parameter indicates that the file to be loaded is an ASCII text file (a BR display file) filled with BR program lines. BR must enter these lines into memory, one by one, just as if they were being typed in from the keyboard. If no extension is provided in the file-ref, BR looks for a file with the extension .BRS.

'''RESIDENT''' indicates that the specified program should be loaded as a resident library.

==Technical Considerations==

:1) Syntax error checking occurs for each individual line (as if it were entered at the keyboard) when LOAD is executed on a source file. Syntax errors encountered during a LOAD SOURCE command cause BR to stop processing and wait for a correction from the keyboard.
:2) Stopping on syntax errors when LOAD SOURCE is initiated from a procedure is prevented when [[PROCERR RETURN]] is in effect. This allows greater flexibility in automating conversions between different major releases of BR. When PROCERR RETURN is in effect, BR returns the error code to the procedure by setting the function ERR. The function LINE is also set to the line number preceding the error. The procedure can test ERR with a SKIP command to determine whether or not the LOAD SOURCE was successful.

If [[ERR]] is nonzero (ERR will be nonzero if the LOAD failed, as a successful LOAD automatically sets ERR to zero), the procedure can print a message including the error code and the number of the line before the error. The syntax error must still be corrected before the file can be loaded, but the procedure can continue its process of loading other files in the meantime.

<noinclude>
[[Category:Commands]]
[[Category:Program Management Commands]]
</noinclude>

Load - Revision history

Laura: /* Syntax */

Mikhail.zheleznov: Created and added new Syntax diagram

Mikhail.zheleznov: Imported LOAD command page from old wiki