CALL SAVE
This page was last modified 12:51, 7 December 2016 by Mars2000you. Based on work by Gdx.

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

Contents

CALL SAVE in DM-System2 Basic

Effect

Saves data to a new file or to a location in an already existing file.

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

Syntax

CALL SAVE ("[<devicename>:][\<path>][\]<filename>",[@]<source address>,<length>[,<offset>])

Note: Character backslash (\) is used in Disk BASIC 2.x. It is replaced by the character yen (¥) on Japanese MSX.

Parameters

<devicename> 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 saving 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 save. Each folder name in path are separate by a backslash (\). This parameter is only available in version 2 of Disk BASIC.

<filename> is the name of file to save the data.

<source address> is source address of data to save. If the address is preceded by an at sign (@) the data will be saved from VRAM.

<length> is data length to save

<offset> is a value relative to start address in file, it indicates the location to save new data.

Related to

CALL CHGDRV, CALL FILES, CALL FSIZE, CALL LOAD

Compatibility

DM-System2 BASIC


CALL SAVE in QuickDisk Basic

Saves on a Quick Disk device the BASIC program or DATA present in the MSX memory.

The DATA will always be saved in ASCII text. The BASIC program can be saved in ASCII text or in tokenized mode.

Syntax

CALL SAVE ("[QD[n]:]"<filename>"[,A])

Parameters

QD specifies used device is the Quick Disk. Value n can vary between 0 and 7. By default, the loading will be made 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 make the difference between BASIC files (extension BAS) and DATA files (extension DAT).

When the parameter A is indicated, the BASIC program will be saved in ASCII text otherwise it will be saved as it is (tokenized format).

ASCII text and Tokenized format

The tokenized format allows a faster loading than the loading of the same BASIC program in ASCII text and the loaded program takes less space in the MSX memory.

However, contrary to the ASCII text, the listing of the program can't be directly displayed and read.

Related to

CALL LOAD, CALL MERGE, CALL RUN

Compatibility

QuickDisk BASIC