CALL SYSTEM
This page was last modified 11:51, 11 May 2020 by Mars2000you. Based on work by Gdx and Rderooy.

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

Contents

CALL SYSTEM in Disk Basic 1.x

Effect

Returns to MSX-DOS 1. Typically only works if you started MSX-DOS first and exited to BASIC.

Syntax

CALL SYSTEM

Using

For this command to work, you first need to have started MSX-DOS 1. At the DOS prompt, you can exit to BASIC, with the command "BASIC". To return to MSX-DOS 1, you can do a CALL SYSTEM. A MSX-DOS 1 disk needs to be present in the currently active disk drive (by default, it's drive A:).

If you did not first start MSX-DOS 1, you will normally get an "Illegal function call" error, but you can bypass this problem by entering POKE &HF346,1: CALL SYSTEM or POKE &HF346,1: _SYSTEM.

The "Illegal function call" error will not be displayed if you have the MSX-DOS 2 cartridge plugged in, or have a Turbo R, in which case it will check for a MSX-DOS 1 disk and start DOS if possible.

Example

MSX-DOS version 2.30
Copyright (1990) ASCII Corporation

A>BASIC
MSX BASIC version 4.1
Copyright 1990 by Microsoft
25271 Bytes free
Disk BASIC version 2.01
Ok
CALL SYSTEM
A>

Compatibility

Disk BASIC 1.0 or higher


CALL SYSTEM in Disk Basic 2.x

Effect

Goes to the MSX-DOS 2 environment and launches a batch file.

You need to have the MSX-DOS 2 cartridge plugged in, or have a Turbo R, in which case the instruction will check for a MSX-DOS 2 disk and start DOS 2 if possible.

Syntax

CALL SYSTEM [("[<devicename>:][\][<path>[\]][<filename>]")]

Note: Character backslash (\) is replaced by the character '¥' on a Japanese MSX or the character won (₩) on Korean MSX.

Parameters

<devicename> is the name for used drive or partition. It can be A, B, C, D, E, F, G, H or COM (linked computer on RS-232C)

<path> is used to specify the location in folders of the file to execute under MSX-DOS 2 environment. Each folder name in path are separate by a backslash (\).

<filename> is the name of the batch file to be lauunched. When a file is not specified, then a batch file called REBOOT.BAT will be searched for and executed if found.

Example

Enter the following command under Basic to go to the MSX-DOS 2 environment on drive B: and run the file 'mm.bat'.

_SYSTEM("B:\MM\mm.bat")

Compatibility

Disk BASIC 2.0 or higher


CALL SYSTEM in DM-System2 Basic

Effect

This instruction can be used

  • alone : it uninstalls DM-System2 and goes back to the standard MSX-BASIC environment
  • preceded by CALL SYSOFF: it uninstalls DM-System2 and goes back to the MSX-DOS 1 or 2 environnent

This instruction was added in DM-System2 Basic only because MSX-DOS 1 or 2 is unstable when DM-System2 has been installed and that you go back to MSX-DOS without first uninstalling DM-System2 with CALL SYSOFF.

Syntax

CALL SYSTEM

Related to

CALL SYSOFF, CALL SYSON

Compatibility

DM-System2 BASIC