MSX-DOS2 programming index ASCII, 01-09-94 M S X -- D O S v e r s i o n 2 ================================= The advanced disk operating system for MSX 2 computers CONTENTS Page 1. Introduction ............................... 3 2. Transient Program Environment .............. 4 2.1 Entry from MSX-DOS .................... 4 2.2 Return to MSX-DOS ..................... 4 2.3 Page Zero Usage ....................... 5 2.4 BIOS Jump Table ....................... 8 2.5 RAM Paging ............................ 9 3. MSX-DOS calls .............................. 11 3.1 Calling Conventions ................... 11 3.2 Devices and Character I/O ............. 12 3.3 File Handles .......................... 13 3.4 File Info Blocks ...................... 15 3.5 Environment Strings ................... 18 3.6 File Control Blocks ................... 20 4. Screen Control Codes ....................... 22 5. Mapper Support Routines .................... 24 5.1 Mapper Initialization ................. 24 5.2 Mapper Variables and Routines ......... 24 5.3 Using Mapper Routines ................. 26 5.4 Allocating and Freeing Segments ....... 27 5.5 Inter-Segment Read and Write .......... 28 5.6 Inter-Segment Calls ................... 29 5.7 Direct paging routines ................ 30 6. Errors ..................................... 32 6.1 Disk Errors ........................... 33 6.2 MSX-DOS Function Errors ............... 35 6.3 Program Termination Errors ............ 40 6.4 Command Errors ........................ 41 This document describes the interface to transient programs provided by MSX-DOS version 2.20. 1. INTRODUCTION ================= This manual describes the environment which MSX-DOS 2 provides for transient programs on MSX 2 computers. It is intended as a guide for writing new programs to run under MSX-DOS 2 and also to assist in converting existing CP/M and MSX-DOS 1 programs to take advantage of the advanced features. MSX-DOS 2 provides many enhancements to the standard CP/M and MSX-DOS 1 environment, but is largely compatible with existing programs. The main features include: MS-DOS style tree structured directories File handles Environment Strings Proper error handling Many extra DOS calls are implemented, and these are accessed via the DOS entry jump at address 5 (the 'BDOS' jump in CP/M). The descriptions of the individual functions can be found in the MSX-DOS 2 Function Specification. Throughout this manual, the term MSX-DOS is used generally to refer to MSX-DOS 2 unless otherwise stated. |