The program M2Z3INS1 is an installation program whose purpose is to make
the ZCPR environment descriptor address available inside a Turbo Modula2
program.

In ZCPR3.3 systems the TM2 program becomes self adapting... that is, after
installing it with the M2Z3INS1 program it can be moved to any ZCPR3.3
system and it will correctly find the environment descriptor.

In ZCPR3 systems the TM2 program must be reinstalled if moved to another
computer to guarantee that it will correctly find the environment descriptor.

In CP/M systems there is, of course, no environment descriptor but the
installation program permits installing a 16 char string in the TM2 program.
The intended use of the string is to install the name of a file containing
system environment info (TCAP?) but it's use is not restricted.

The system works by searching the TM2 .COM file 1 char at a time for a unique
marker (don't be surprised if it takes rather a long time on floppy disks!).
Just after the marker the .COM file is patched to insert the address of the
resident environment descriptor and a 16 char array.

Thanks to Steve Cohen for suggesting the basic approach!

To use the installation program you MUST include the GetEnv procedure in
your TM2 code.  Compile the code and link it into a .COM file.  After the 
installation process a call to GetEnv will return the address of the 
environment descriptor and the 16 char string.

I'm working on a procedure to extract the addresses of things in the
environment descriptor by it isn't quite complete yet.

Perhaps one of you out there in "Z Country" will tackle a procedure to 
translate named directories to the DU: form and vice versa!

Ed Jackson  10/20/87