Effect

Inserts a new disk image in the USB virtual drive.

If the instruction is correctly executed and the files are not hidden in sectors, you can access the list of files with FILES, and normally use typical instructions, such as RUN, LOAD, SAVE, BLOAD, BSAVE, etc.

Multi-disk games can be used, there are two modes of operation:

• Multiple correlative disks: the game is divided into several disk images, named as follows: GAME.DS1, GAME.DS2, GAME.DS3 … etc
• Concatenated disks: a single file that contains the images of the disks one after the other

The operation is as follows: you insert the image of the first disk image, and when the game asks us to change the disk then you need to press and hold the disk number to be inserted and press the key that the game indicates (normally the bar space)

Notes:

• This instruction is currently limited to disk images with a maximum size of 720kB.
• When you restart the USB virtual drive, the last used disk image will be automatically inserted again, but you can temporarily cancel that by pressing the ESC key during hardware initialization. The system saves indeed the name of this disk image in the USBMSX.INI file.
• The USBMSX.INI file will also be ignored at start when the system detects the existence of an AUTOEXEC.DSK file, that will be treated as the inserted image by default.

Syntax

CALL INSERTDISK ("<DiskName>")

Parameter

<DiskName> is the name of the new disk image.

Example

CALL INSERTDISK ("TEST.DSK")

Related to

CALL EJECT, CALL REBOOT, FILES

Compatibility

RookieDrive BASIC