		     Notes on MASM 6.11 Error Messages
		     (c) Copyright Microsoft Corp. 1993

     
     Part 1 of this text file contains updated ML error messages; Part 2 
     lists the Microsoft MS-DOS Extender error messages.


     Part 1: ML Errors Update
     ------------------------
     The following is updated information on ML error messages. The
     complete list of assembler error messages is located in Appendix A
     of Microsoft MASM Environment and Tools.

	  A1004: out of memory

		 The assembler could not load the file because all memory 
		 is exhausted. For ML.EXE to run with the Microsoft Windows 
		 operating system, a Windows swap file must exist.


	  A1018: COFF error writing file

	  
	  A1019: invalid debug and browser data; file exceeds line limit 
			  
		 The assembler cannot generate debug or browse information 
		 on an OMF file longer than 32,767 lines, or on a coff file
		 longer than 65,553 lines.
	    
		 To eliminate this error:

		 - Break the file up into smaller pieces (each having less 
		   than 32,767 lines for OMF files, 65,553 for coff files) 
		   and reassemble, or

		 - Assemble without options /Zi, /Fr, or /FR.

	  
	  A1020: cannot find link.exe

		 This error occurs when link.exe cannot be found on the 
		 path. Placing link.exe on the path will resolve this error.

 
	  A1021: cannot find cvpack.exe

		 This error occurs when cvpack.exe cannot be found on the 
		 path. Placing cvpack.exe on the path will resolve this 
		 error.


	  A2210: 16 bit segments not allowed with /coff option

		 You have attempted to compile a 16-bit segment module with
		 the /coff option. Remove the /coff switch from your command
		 line and recompile.
		 

	  A2211: FAR not allowed in flat model comm variables

		 The assembler has detected a FAR directive in a flat model
		 program. The FAR directive is irrelevant for flat model 
		 programs and should be removed.


	  A2212: invalid .model parameter for flat model
	  
		 The assembler has detected nearstack or farstack 
		 directives in a flat model program. These directives are 
		 irrelevant for flat model programs and should be removed.
	  

	  A4014: directive ignored with /coff switch

		 Directives .seq, .alpha, and .dosseg are ignored when 
		 assembling with the /coff switch. These directives have no 
		 effect and should be removed from flat-model code.


	  A4015: /Gc switch incompatible with flat model

		 The /Gc switch is incompatible when assembling a flat-
		 model program. The switch was ignored.


	  A4016: /AT switch incompatible with flat model

		 The /At switch is incompatible when assembling a flat-
		 model program. The switch was ignored. 
		 
	  
	  A4017: invalid command line option: /<option>

		 ML has detected a command-line option that is invalid.
		 The option was removed and ML compiled as it normally
		 would.


	  A5006: calling convention not supported in flat model

		 ML has detected a calling convention not supported in flat
		 model programs. The convention was ignored.


*****************************************************************************
		
     Part 2: Microsoft MS-DOS Extender Run-Time Errors
     -------------------------------------------------
     The MASM assembler, ML.EXE, is a 32-bit MS-DOS-extended program. An
     MS-DOS Extender error can occur when you run ML. MS-DOS Extender 
     errors have the following format:

     DOSXNT : fatal error DXnnnn: message


	  DX1020: unhandled exception: exception; contact Microsoft 
		  Support Services

		  A problem exists in ML.EXE. Additional information 
		  appears after this error message. Note the circumstances 
		  of the error and notify Microsoft Corporation by 
		  following the instructions in the "Microsoft Support 
		  Services" section in Microsoft MASM Environment and 
		  Tools.


	  DX1070: GODOSXNT.EXE stub out of date

		  ML is not compatible with the version of DOSXNT.EXE 
		  available. A compatible version of the Microsoft DOSXNT 
		  MS-DOS Extender (DOSXNT.EXE) must exist in the same 
		  directory or in a directory specified in the PATH 
		  environment variable.

		  This error can result when Microsoft MASM 6.11 is 
		  installed in the same directory as another language 
		  product. Try reinstalling MASM 6.11 in a different 
		  directory.


	  DX1140: DOSXNT.386 driver required to run with Windows

		  For ML.EXE to run with the Microsoft Windows operating 
		  system, the driver called DOSXNT.386 must be specified 
		  in the [386Enh] section of SYSTEM.INI as follows:

		  DEVICE=<path>\DOSXNT.386

		  where <path> is the directory that contains the 
		  DOSXNT.386 file.


	  DX1180: cannot load program : <reason>

		  The MS-DOS Extender could not load ML.EXE for the given 
		  reason. The message describing the reason can be one of 
		  the following:

		  - access denied to file
		       Change the access rights for the file.

		  - invalid or corrupted .EXE file
		       Contact Microsoft Support Services.

		  - out of memory
		       Remove some TSRs or add more memory.

		  - too many open files
		       Either close some files or increase the number of 
		       file handles specified in the FILES= statement in 
		       CONFIG.SYS.


	  DX1230: DOSXNT initialization failed

		  This error usually follows error DX5420.


	  DX1270: command-line error : unknown command switch

		  This error occurs if one of the following environment 
		  variables is set: G, GO, GOT, GOTN, GOTNT, T, TN, TNT. 
     
		  To see the current settings of environment variables, run 
		  the SET command at the operating system prompt. To clear 
		  an environment variable, run the command SET variable=, 
		  where variable is the name of the variable to be cleared; 
		  no other characters can appear before you press ENTER. 
		  Changes in environment variables must be made outside of 
		  Windows. Check AUTOEXEC.BAT for environment variable 
		  settings.


	  DX1350: cannot load program: file not found

		  This error occurs if one of the following environment 
		  variables is set: G, GO, GOT, GOTN, GOTNT, T, TN, TNT.

		  To see the current settings of environment variables, 
		  run the SET command at the operating system prompt. To 
		  clear an environment variable, run the command SET 
		  variable=, where variable is the name of the variable to 
		  be cleared; no other characters can appear before pressing 
		  ENTER. Changes in environment variables must be made 
		  outside of Windows. Check AUTOEXEC.BAT for environment 
		  variable settings.

     
	  DX1390: cannot load program

		  DOSXNT cannot load the executable file because all memory 
		  is exhausted. For ML.EXE to run with the Microsoft Windows 
		  operating system, a Windows swap file must exist.


	  DX5420: CheckDPMI: error when checking for coprocessor support

		  For ML.EXE to run with the Microsoft Windows operating 
		  system, the following must be specified in the [386Enh] 
		  section of SYSTEM.INI:
     
		  DEVICE=*vmcpd

	  
	  Phar Lap err 58: Can't create VM swap file of size 0 in 
		  directory T:\

		  (where T:\ is a read-only network drive). This error
		  may occur in the DOS environment (outside of Windows)
		  when ML.EXE is located on a read-only network share.
		  To avoid this, you can do one of the following:

		  - Set the DOSX environment variable to "set dosx=novm".
		    This instructs the dos extender not to use VM.

		  - Set the DOSX environment variable to "set dosx=-swapdir
		    c:\<dir>", where <dir> is a directory on drive C:.
		    This instructs the dos extender to put the swap file in
		    the desired directory.

