CALL LOAD
This page was last modified 00:50, 31 May 2023 by Mars2000you. Based on work by Gdx and Rderooy.

This instruction is available in DM-System2 Basic, MSX2-SAS Basic and QuickDisk Basic.

Contents

CALL LOAD in DM-System2 Basic

Effect

Reads a file or a part.

Note: The data recorder is not supported by this instruction.

Syntax

CALL LOAD ("<Device>[\<Path>\]<Filename>",@<DestinationAddress>,<Length>,<Offset>)

The two last parameters are optionaL.

Notes:

  • Character backslash (\) serves as a separator between the folders and the file name in MSX-DOS2. You don't have to put it after the colon of the device name.
  • Character backslash is replaced by the character yen (¥) on Japanese MSX or the character won (₩) on Korean MSX.
  • Parameters can not end with a comma alone.

Parameters

<Device> is the name for used device. (see table below)

Device type Device name Remark
Disk drive A, B, C, D, E, F, G, H A floppy disk interface can control until 2 drives.
Linked computer COM Requires RS-232C interface


By default, the loading will be made from the current active drive (generally drive A) in the other cases.

<Path> is used to specify the location in folders of file to load. Each folder name in path are separate by a backslash (\). This parameter is only available in version 2 of Disk BASIC.

<Filename> is the file name that contains the data to load.

<DestinationAddress> is destination address to load data. If the address is preceded by an at sign (@) the loading will be done in VRAM instead of RAM.

<Length> is data length to load

<Offset> is a value relative to the load address to move the destination.

Related to

CALL CHGDRV, CALL FILES, CALL FSIZE, CALL SAVE

Compatibility

DM-System2 BASIC


CALL LOAD in MSX2-SAS Basic

Effect

Loads from disk a BASIC source, as single file or additional file that will be merged to the current source in RAM.

Associated function key in set 2: F2

Syntax

CALL LOAD("<Device>:<Filename>",A)

Note: The final part ",A) can be omitted if you don't use the A parameter.

Parameters

<Device> is the name for used device. It can only be a disk drive.

If you don't specify the drive, the computer will use the currently active drive (by default, it's drive A:)

Device type Device name Remark
Disk drive A, B, C, D, E, F, G, H A floppy disk interface can control up to 2 drives.


<Filename> is a string that contains name of the BASIC source you want to load in RAM. The format is 8 characters followed by a point and an extension with 3 characters. (Not case sensitive) - It can be omitted when you want to load again after modifications of the source in RAM.

You can always omit the extension because the instruction will automatically add the ASF extension (ASF = ASCII Source File).

When the parameter A is indicated, it will mean that the file to load will be merged to the current source in RAM.

Example

_LOAD("RAMSLOT")

Related to

CALL ASM, CALL SAVE

Compatibility

MSX2-SAS BASIC


CALL LOAD in QuickDisk Basic

Effect

Loads a non-binary file from the specified Quick Disk device.

It can be a BASIC file in tokenized mode or in ASCII text, or a DATA file (always in ASCII text).

Note: You can also press the F2 function key

Syntax

CALL LOAD ("QDn:]<filename>",R)

Specify at least the <Filename>. Parameters can not end with a comma alone.

Parameters

QD specifies the used device is the Quick Disk. Value n can vary between 0 and 7. By default, the loading will be done from Quick Disk device 0.

<Filename> is the file name in format of 8 characters followed by a point and an extension with 3 characters. This extension can be used to differentiate between BASIC files (extension BAS) and DATA files (extension DAT).

The parameter R automatically executes the loaded BASIC program. Don't use it with DATA files!

Related to

CALL MERGE, CALL RUN, CALL SAVE

Compatibility

QuickDisk BASIC