File Manager 22.2 Installation Guide

Contents >Introduction


This guide provides instructions for installing Fileman version 22.2. Fileman is designed to be used either with the Kernel or as a stand-alone application running under a variety of implementations of American National Standards Institute (ANSI) M. Installation instructions are provided for sites running Kernel and for stand-alone sites. Fileman version 22.2 is not integrated with the installation of Kernel. Refer to Kernelʼs Installation Guide for instructions on installing Kernel.

Fileman version 22.2 uses features that are in the 1995 M Standard. Proceed with this installation only if you are running an M operating system that supports the 1995 M Standard.

Fileman consists of approximately 881 M routines; along with the necessary globals, they occupy approximately 7.1 megabytes of disk storage space. These routines, as they are run, set up all the M globals that Fileman will require.

Preliminary Considerations

Steps required to perform the installation are listed below. Instructions for performing these functions are provided in vendor-supplied operating system manuals as well as VISTA publications. DSM for OpenVMS instructions are provided in the Decentralized Hospital Computer Program (DHCP) VAX DSM Systems Guide; and MSM-DOS instructions are provided in the 486 Cookbook and Micronetics Standard MUMPS (MSM) System Managers Guide. Sites running ALPHA systems require knowledge of DSM. Caché/OpenM instructions are provided in the Caché System Manager Guide. Sites running GT.M are referred to the GT.M Administration and Operations Guide for Unix or VMS.

You will need to know how to:

Log onto the system.
Shut down and bring up the M configuration or boot the system.
Delete routines.
Restore routines from the distribution medium to your disk drive.
Run a system status and terminate a process.
Copy routines.
Back up the system; enable/disable journaling.


Beginning with version 21.0, Fileman no longer supports the following operating systems since they do not support the 1995 M standard:

DSM(V3 & V4)
VAX DSM(V4 & V5)

Note: If you are running under any of these operating systems, you should not proceed with the installation of Fileman version 22.2. If you upgrade from a non-supported M operating system to a system that supports the 1995 M Standard environment, kill ^DD("OS") in order to proceed with the installation.

In Fileman version 21.0, the VAX DSM(V6) entry was renamed to DSM for OpenVMS and the entry M/SQL-VAX was deleted.

In Fileman version 22.0, the M/SQL entry in the MUMPS OPERATING SYSTEM file (#.7) is renamed CACHE/OpenM. Caché/OpenM sites should select this entry.

Beginning with Fileman version 22.2, Fileman does not rely on the %ZOSF nodes belonging to the Kernel to perform OS specific functions. If you have customized the %ZOSF nodes for any reason, you can apply your customizations to the Mumps OS File instead for the appropriate Operating System.

Installation Summary

1. Backup your database.
2. Stop all VISTA tasks running in the background as well as Taskman. Make sure there are no users on the system.
3. Put the system as out of service so nobody can log on.
4. Delete all DI*, DM*, and DD* routines. If there are local (DIZ*, DMZ*, DDZ*) routines, you may preserve them if you wish.
5. Load the Fileman RSA file containing the routines.
6. Run ^DINTEG to assure integrity.
7. Move DIDT to %DT, DIDTC to %DTC, and DIRCR to %RCR.
8. Run, in succession, routines DINIT, DIINIT, and DMLAINIT.
9. Allow users to log back into the system.
10. Restart Taskman and background tasks.

The actual installation time (Step 8) for Fileman 22.2 is between 5 to 30 seconds.

Preparation Before Installation on your Production System

Back up your system as a safeguard before the installation.

If you still journal globals selectively, journal as follows:

Recommended: ^DD, ^DI, ^DIBT, ^DIC, ^DIE, ^DIPT, ^DIST, ^DIZ
Do NOT Journal: ^DISV

It's recommended that you install and try Fileman 22.2 on a test system that is a copy of your production system if you have one available. This is especially recommended if you use unpublished entry points or deprecated functionality in Fileman, as you may find out that these features are no longer supported. In general, Fileman 22.2 is almost 100% backward compatible as long as documented public entry points are used. The only change affecting backwards compatibility is the re-organization of the Language file, which isn't expected to cause any problems for existing code as all old global nodes have values.