File Manager 22.2 Installation Guide

Contents > Stand-alone Installation

Stand-alone Fileman Installation on Caché/Ensemble or GT.M

Your backup should be already completed by this point if you have any data to back-up.

The following instructions apply to installation of stand-alone FileMan (i.e., without Kernel).

Routine Mapping for Caché

Before you start, you need to remember that Caché maps % routines to the %SYS namespace. Using Caché tools (not described in this manual), you need to map %DT, %DTC, %RCR, %ZIS, %ZISS, and %ZISC to the namespace where Fileman will be installed.

Delete Old Fileman Routines

It is recommended that you delete the old Fileman routines just before loading in the new ones to ensure that the only routines in Filemanʼs namespace are those coming in with version 22.2. Use your M system routine deletion utility to delete the DD*, DI*, and DM* routines, preserving local routines (DDZ*, DIZ*, DMZ*) if necessary.

Load Routines

Use your M systemʼs routine loading utility to load the Fileman version 22.2 routines from the distribution file (VA-FILEMAN-22P2.RSA) into your account.

Rename Routines

Rename, using the commands available with your M implementation.

DIDT rename to %DT
DIDTC rename to %DTC
DIRCR rename to %RCR
DIIS rename to %ZIS
DIISS rename to %ZISS
DIISC rename to %ZISC

Customize %ZIS and %ZISS Routines

If you are not using a VT100 terminal (or a terminal emulating a VT100), you will need to customize the %ZIS and %ZISS routines in the Manager account.

Run DINIT—Initializing Fileman

Finally, return to the account and run the DINIT routine. DINIT prompts you for a site name and number like this:

SITE NAME:
SITE NUMBER:

Note: The site number entered by the installer will be multiplied by 1000 to determine the beginning number of the default file number assignment, when using the Modify File Attributes option to add a new file.

After entering the site number, there will be a slight pause while Fileman installs the MUMPS OPERATING SYSTEM file (#.7), DIALOG file (#.84) and the LANGUAGE file (#.85). The installer will then be asked:

TYPE OF MUMPS SYSTEM YOU ARE USING:

Type a question mark ("?") at this point to see your choices. If you do not see your M operating system vendor listed, or you are unsure, enter OTHER in answer to this prompt.

Then the other Fileman files will be initialized.

The PACKAGE file (#9.4) will be initialized next. The PACKAGE file is necessary if you want to bundle an application package together for export using DIFROM. (In the Programmer Manual, see the DIFROM section of the Programmer Utilities chapter.) The PACKAGE file will not be updated if you have a File #9.4 with a name other than "PACKAGE."

When the initialization has completed, you will see the statement:

INITIALIZATION COMPLETED IN nnnn SECONDS.

In your account:

>D ^DINIT

Fileman V.22.2T0

Initialize Fileman now? NO//Y <ENTER>

SITE NAME: DEV SITE// <ENTER> <---- Enter your site name here

SITE NUMBER: 1// <ENTER> <----- Enter your site number here

..................................

Now loading MUMPS Operating System File

Do you want to change the MUMPS OPERATING SYSTEM File? NO//Y <ENTER>

Now loading DIALOG and LANGUAGE Files..............................................................

TYPE OF MUMPS SYSTEM YOU ARE USING: GT.M(UNIX)// ?? <ENTER>
Answer with MUMPS OPERATING SYSTEM NAME
Choose from:
CACHE/OpenM
DSM for OpenVMS
DTM-PC
GT.M(UNIX)
GT.M(VAX)
MSM
OTHER
TYPE OF MUMPS SYSTEM YOU ARE USING: GT.M(UNIX)// <ENTER>

Now loading other FileMan files--please wait...............................................................
...................................................................
...................................................................
...............................

The following files have been installed:
.11 INDEX
.2 DESTINATION
.31 KEY
.4 PRINT TEMPLATE
.401 SORT TEMPLATE
.402 INPUT TEMPLATE
.403 FORM
.404 BLOCK
.44 FOREIGN FORMAT
.46 IMPORT TEMPLATE
.5 FUNCTION
.6 DD AUDIT
.7 MUMPS OPERATING SYSTEM
.81 DATA TYPE
.83 COMPILED ROUTINE
.84 DIALOG
.85 LANGUAGE
1 FILE
1.1 AUDIT
1.11 ARCHIVAL ACTIVITY
1.12 FILEGRAM HISTORY
1.13 FILEGRAM ERROR LOG
1.2 ALTERNATE EDITOR
1.521 SQLI_SCHEMA
1.52101 SQLI_KEY_WORD
1.5211 SQLI_DATA_TYPE
1.5212 SQLI_DOMAIN
1.5213 SQLI_KEY_FORMAT
1.5214 SQLI_OUTPUT_FORMAT
1.5215 SQLI_TABLE
1.5216 SQLI_TABLE_ELEMENT
1.5217 SQLI_COLUMN
1.5218 SQLI_PRIMARY_KEY
1.5219 SQLI_FOREIGN_KEY
1.52191 SQLI_ERROR_TEXT
1.52192 SQLI_ERROR_LOG
Your Package file will now be updated.

I AM GOING TO SET UP THE FOLLOWING FILES:

  9.4   PACKAGE
Note: You already have the 'PACKAGE' File.

...HMMM, THIS MAY TAKE A FEW
MOMENTS..........................................................
OK, I'M DONE.
NOTE THAT FILE SECURITY-CODE PROTECTION HAS BEEN MADE

Re-indexing entries in the DIALOG file...........................

Compiling all forms ...
DICATT (#.001)
DIPTED (#.1001)
DIKC EDIT (#.1101)
DIKC EDIT UI (#.1102)
DIKK EDIT (#.3101)
DIBTED (#.40001)
DIETED (#.40101)
DIEDIT (#.40201)
DDGF BLOCK EDIT (#.40301)
DDGF PAGE ADD (#.40302)
DDGF PAGE EDIT (#.40303)
DDGF PAGE SELECT (#.40304)
DDGF FORM EDIT (#.40305)
DDGF HEADER BLOCK EDIT (#.40306)
DDGF FIELD ADD (#.40401)
DDGF FIELD CAPTION ONLY (#.40402)
DDGF FIELD DD (#.40403)
DDGF FIELD FORM ONLY (#.40404)
DDGF FIELD COMPUTED (#.40405)
DDGF BLOCK ADD (#.40406)
DDGF BLOCK DELETE (#.40407)
DDGF HEADER BLOCK SELECT (#.40408)
DDXP FF FORM1 (#.441)
DDMP SPECIFY IMPORT (#.461)
INITIALIZATION COMPLETED IN 2 SECONDS.

Fileman is now ready to use.

[return]