:::
   name: emsAlloc
   desc: allocates expanded memory (EMS)
  
   type: function
   args: [in] bytes:long    	| bytes to alloc
   retn: integer		| allocated mem' handle (0 if error)
  
   decl: emsAlloc% (byval bytes as long)
  
   chng: sep/01 written [v1ctor]
   obs.: max 4Mb can be allocated per call;
  	 handle returned _can't_ be used to invoke the EMS manager

:::
   name: emsCalloc
   desc: allocates expanded memory (EMS) and clears it
  
   type: function
   args: [in] bytes:long    	| bytes to alloc
   retn: integer		| allocated mem' handle (0 if error)
  
   decl: emsCalloc% (byval bytes as long)
  
   chng: sep/01 written [v1ctor]
   obs.: same as for emsAlloc

:::
   name: emsAvail
   desc: get the size of the largest free expanded memory block
  
   type: function
   args: none
   retn: long                  | largest free block size
  
   decl: emsAvail& ()
  
   chgn: sep/01 written [v1ctor]
   obs.: none

:::
   name: emsFill
   desc: fills a ems' block
  
   type: sub
   args: [in] hnd:integer,	| hnd to block
  	      offs:long,	| offset inside block
  	      bytes:long,      	| number of bytes to fill
  	      char:integer	| char to use
   retn: none
  
   decl: emsFill (byval hnd as integer, byval offs as long,_ 
  		  byval bytes as long, byval char as integer)
  
   chng: sep/01 written [v1ctor]
   obs.: none

:::
   name: emsFree
   desc: frees an expanded memory allocated using emsAlloc
  
   type: sub
   args: [in] hnd:integer	| handle of block to free
   retn: none
  
   decl: emsFree (byval hnd as integer)
  
   chng: sep/01 written [v1ctor]
   obs.: none

:::
   name: emsMap
   desc: maps expanded memory (up to 64k) to conventional mem
  
   type: sub
   args: [in] hnd:integer,   	| handle
  	      offs:long		| start offset (16k page granular!)
  	      bytes:long	| bytes to map (max 64k)
   retn: integer		| EMS' frame segment (0 if error mapping)
  
   decl: emsMap% (byval hnd as integer,_
  		  byval offs as long,_
  		  byval bytes as long)
  
   chng: sep/01 written [v1ctor]
   obs.: none

