April 21, 2025

The following files are installed with mumps:

    /share/man/man7/mumps-doc.7.gz
    /share/man/man1/mumps-sql-db-create.1.gz.gz
    /share/man/man1/mumps.1.gz
    /include/mumpsc/*.h
    /lib/libmpscpp.a
    /lib/libmumps.a
    /lib/libmpsglobal_native.a
    /bin/mumps2c
    /bin/mumps-sql-db-create.script
    /bin/mumpslib
    /bin/mumpsc
    /bin/mumps


DO NOT RUN configure / make - you need to run scripts that will invoke
configure and make in order to use the correct build parameters.

There are now only two versions of the interpreter/compiler:

    1. The single user native database version.
    2. The Sqlite3 database version.

If you build the system yourself (rather than use the .deb installers),
you need to install any system libraries you may be missing. If you use 
the .deb isntallers, the libraries will be installed automatically.

If you do not use the installers, there are two scripts to install the 
needed system libraries:

    1. ConfigureNativeMumps.script
    2. ConfigureSqliteMumps.script

Both MUST be run as root as they invoke apt..

If you configure and compile yourself, there are two scripts:

    1. BuildNativeMumps.script
    2. BuildSqliteMumps.script

Each of these will run configure and make with the appropriate parameters.
They will construct a local install in the directory local_install which
will be created in the mumps distro directory. These acripts assume you
have installed the needed system libraries. 

Both will also create .deb installer files:

    1. mumps-native-single-user-amd64.deb
    2. mumps-sqlite3-amd64.deb

To run one of the installers, normally, from an explorer window, double 
click on the .deb file and this will start the installer.

Alternatively, from the command line, use one of the followin:

    1. sudo dpkg -i mumps-native-single-user-amd64.deb
       sudo apt install -f

    2. sudo apt install gdebi (if not already installed)
       sudo gdebi mumps-native-single-user-amd64.deb

Substitute mumps-sqlite3-amd64.deb in the above for the sqlite3 database version.

If you use the Sqlite3 database, you must create (or rebuild if needed) a 
database in each directory you will use mumps in. You can do this with the 
command:

    mumps-sql-db-create.script

which was installed by the Sqlite installer. This creates a database file named
mumps.sqlite.

The mumps.sqlite database may also be opened with Sqlite3 with the command:

    sqlite3 mumps.sqlite

From which you may inspect or retrieve from the mumps table with standard SQL
commands.

The native database automatically creates key.dat and data.dat when mumps first
attempts a database operation. These files store the native, single user, globale
array database.

Multiple instances of sqlite mumps may access the same database concurrently.
Only one instance of the native database may access the database concurrently.

The Sqlite3 database can be accessed through Sqlite3 by the command

sqlite3 mumps.sqlite

assuming the default database name has not been altered. Standard Sqlite3
and SQL command my be used to search, alter, or modify the database.

By default, the clobal array names are in column a1. The indices of the
array are stored in columns a2 through a9 and the data stored, if any,
is in column a10. So, in a global array created with:

for i=1:1:10000 set ^a(i)=i

the SQL command to see the data from array elements ^a(9000) to ^a(9010)
would be:

sqlite> .separator " "
sqlite> select "^",a1,"(",a2,") =",a10 from mumps where
        cast (a2 as integer) >= 9000 and
        cast (a2 as integer) <= 9010;
^ a ( 9000 ) = 9000
^ a ( 9001 ) = 9001
^ a ( 9002 ) = 9002
^ a ( 9003 ) = 9003
^ a ( 9004 ) = 9004
^ a ( 9005 ) = 9005
^ a ( 9006 ) = 9006
^ a ( 9007 ) = 9007
^ a ( 9008 ) = 9008
^ a ( 9009 ) = 9009
^ a ( 9010 ) = 9010
sqlite>

Note: By default, this version of mumps stores numbers as character strings
so conversion is necessary when numeric ranges are used. The Sqlite3 command
.separator changes the separator from | to blank. The quoted fields are for
decoration.

For both versions, the command "mumps" will start the interpreter.

Changing / Updating

If you decide to switch from one form of the database to the other by installing
the alternate .deb file, you must first remove the old version. For example:

    sudo dpkg --remove mumps-sqlite3 
or
    sudo dpkg --remove mumps-native-single-user 

If you change versions (native <=> Sqlite3), be sure to fully compile and
re-install (.deb file) otherwise there may be residue from the previous
version present in the system.

From a terminal window:

	To run mumps type

		mumps

	To compile a mumps program type

		mumpsc pgm.mps

	To compile an MDH program type

		mumpsc mdhpgm.cpp