Contents |
Effect
Loads a TSR (Terminate and Stay Resident) program into the memory managed by MemMan 2.3 and higher.
Syntax
CMD TL("<Device>:\<Path>\<Filename>",T,<StringVariable>,<Variable>)
Only the <Filename> is requested in all cases. Other 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. |
| Data recorder | CAS | Not available on MSX Turbo R |
| Data cartridge | CAT | Requires Sony HBI-55 or Yamaha UDC-01 |
| Linked computer | COM | Requires RS-232C interface |
| Memory disk | MEM | Created with CALL MEMINI |
By default, the loading will be made from the current active drive (generally drive A).
<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 name of the TSR file, without the TSR extension.
Parameter T is used to display the TSR’s intro text.
<StringVariable> is used to store the TSR internal ID-name.
<String> is used to store an eventual specific error code. If this variable is omitted load errors will produce a standard MSX-BASIC error.
Examples
CMD TL("PB")
10 CMD TL("B:CAPS",T,A$,A) 20 PRINT A$ 30 PRINT A RUN
Caps blink and key click TSR (c) 1991 - by MJV MJVcapsblink 0 Ok
Specific error codes
| Error code | Meaning |
|---|---|
| 0 | TSR loaded successfully |
| 1 | TSR installation aborted |
| 2 | Structure error in TSR file |
| 3 | TSR table is full |
| 4 | Hook table is full |
| 5 | No free MemMan segment |
| 6 | Not enough BASIC work memory |