You should have backed-up your system already.
This installation requires a pre-existing Kernel version 8.0.
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, and %RCR to the namespace where Fileman will be installed. Remember that the Kernel needs additional mappings not described here. If you are installing into an existing VISTA environment, then you do not need to perform this step as it has already been performed.
Since there is no menu option to shut down the OE/RR background filer (routine ORTSK), this job will need to be stopped via the appropriate M operating system utility. Make sure to run ^%SS or an equivalent utility to ensure that all jobs have stopped. Do not proceed if all jobs have not been stopped yet. A last resort, which you may use if there is no way to shut down the job, is the command 'WRITE $ZU(4,{PID})', where {PID} is the process number you obtain from ^%SS.
Shut down Taskman. Make sure you shut down active submanagers.
| >D STOP^ZTMKU Are you sure you want to stop TaskMan? NO// Y <ENTER> Shutting down TaskMan. Should active submanagers shut down after finishing their current tasks? NO// Y <ENTER> Okay! Should active jobs be signaled to stop? NO// Y <ENTER> Signaling active Tasks to STOP. Done. |
Or you may use the operating system (OS) command to prevent logons. Using the OS command will not cause a problem and will allow you to work within the menu system as needed during the installation. Caché/OpenM sites can stop the LAT and TELNET services.
Use Fileman to edit the VOLUME SET file (#14.5). Replace VAH below with your active volume set. If unsure, you can inhibit log-ins for all volume sets in the file.
| >D Q^DI Fileman 22.0 Select OPTION: ENTER OR EDIT FILE ENTRIES INPUT TO WHAT FILE: VOLUME SET// <ENTER> EDIT WHICH FIELD: ALL// INHIBIT LOGONS ? <ENTER> THEN EDIT FIELD: <ENTER> Select VOLUME SET: VAH <ENTER> INHIBIT LOGONS?: NO// YES <ENTER> |
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.
| >D ^%ZTRDEL ROUTINE DELETE All Routines? No => No <ENTER> Routine: DI*<ENTER> Routine: 'DIZ*<ENTER> Routine: DM*<ENTER> Routine: 'DMZ*<ENTER> Routine: DD*<ENTER> Routine: 'DDZ*<ENTER> |
Use your M systemʼs routine loading utility to load the Fileman version 22.2 routines from the distribution file (VA-FILEMAN-22P2V1.RSA).
Caché/OpenM sites: >D ^%RI
| >D ^%RI Input routines from Sequential Device: /tmp/VA-FILEMAN-22P2V1.RSA Parameters? "R" => <ENTER> ***** W A R N I N G *****File Header: Fileman 22.2 Date Stamp: GT.M 13-DEC-2012 15:41:42 This file may not be a %RO output file. Override and use this File with %RI? No => Yes <ENTER> %RI has detected a routine written with UNKNOWN mode. 0) Cache 1) DSM-11 2) DTM 3) Ipsum 4) Cobra 5) DSM-VMS 6) DSM-J 7) DTM-J 8) MSM 9) BASIC 10) U2/M 11) MVBASIC Please enter a number from the above list: 0 <ENTER> File written by OLD GT.M 13-DEC-2012 15:41:42 with description: Fileman 22.2 ( All Select Enter List Quit ) Routine Input Option: All Routines <ENTER> If a selected routine has the same name as one already on file, shall it replace the one on file? No => Yes <ENTER> Recompile? Yes => <ENTER> Display Syntax Errors? Yes => <ENTER> |
Run DINTEG to check the integrity of the routines you have loaded. DINTEG detects any discrepancies between your copy of Fileman and the one distributed by the developers.
| >D ^DINTEG Checksum routine created on 3121213.153844 by KERNEL V7.3 DDBR ok DDBR0 ok <rest of the output elided> |
Save DIDT as %DT, DIDTC as %DTC, and DIRCR as %RCR.
| >ZL DIDT ZS %DT >ZL DIDTC ZS %DTC >ZL DIRCR ZS %RCR |
| >D ^DINIT,^DIINIT,^DMLAINIT |
The following is an example of the initialization process done at the Development Environment. For the prompts for Site Name and Number, you should accept the defaults unless you are planning to rename your site or change its station number. The first time you run DINIT for V22.2, you will not be asked whether to change the MUMPS OPERATING SYSTEM file; the file will be changed automatically. In subsequent times when you run DINIT, you will be given that choice.
| >D ^DINIT,^DIINIT,^DMLAINIT Fileman V.22.2 Initialize Fileman now? NO//Y <ENTER> SITE NAME: TEST SITE// <ENTER> <---- Enter your site name here SITE NUMBER: 11310// <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: CACHE/OpenM// ? <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: CACHE/OpenM// <ENTER> Now loading other FileMan files--please wait............................................................... ................................................................... ................................................................... ............................... The following files have been installed: .11 INDEXRe-indexing entries in the DIALOG file............................. Compiling all forms ... DICATT (#.001)INITIALIZATION COMPLETED IN 4 SECONDS. This version (#22.2T0) of 'DIINIT' was created on 13-DEC-2012 (at FILEMAN.MUMPS.ORG, by Fileman 22.2T0) NOTE: This package also contains SECURITY KEYS NOTE: This package also contains OPTIONS NOTE: This package also contains REMOTE PROCEDURES ARE YOU SURE EVERYTHING'S OK? No// Y <ENTER> Executing the Pre-Init for Fileman 22.2 Deleting the now no longer used ^DD(FN,0,"DDA") nodes Deleting the DIAUDIT DD menu option, no longer used in FM 22.2 ...SORRY, LET ME PUT YOU ON 'HOLD' FOR A SECOND............................................................. ............................... 'DDBROWSER' Option Filed 'DDMP IMPORT' Option Filed 'DDS DELETE A FORM' Option Filed 'DDS EDIT/CREATE A FORM' Option Filed 'DDS PURGE UNUSED BLOCKS' Option Filed 'DDS RUN A FORM' Option Filed 'DDS SCREEN MENU' Option Filed 'DDXP CREATE EXPORT TEMPLATE' Option Filed 'DDXP DEFINE FORMAT' Option Filed 'DDXP EXPORT DATA' Option Filed 'DDXP EXPORT MENU' Option Filed 'DDXP FORMAT DOCUMENTATION' Option Filed 'DDXP SELECT EXPORT FIELDS' Option Filed 'DI DD COMPILE' Option Filed 'DI DDMAP' Option Filed 'DI DDU' Option Filed 'DI DDUCHK' Option Filed 'DI INPUT COMPILE' Option Filed 'DI MGMT MENU' Option Filed 'DI PRINT COMPILE' Option Filed 'DI REINITIALIZE' Option Filed 'DI SET MUMPS OS' Option Filed 'DI SORT COMPILE' Option Filed 'DIAUDIT' Option Filed 'DIAUDIT DD' Option Filed 'DIAUDIT MONITOR USER' Option Filed 'DIAUDIT PURGE DATA' Option Filed 'DIAUDIT PURGE DD' Option Filed 'DIAUDIT TURN ON/OFF' Option Filed 'DIAUDITED FIELDS' Option Filed 'DIAX ADD/DELETE' Option Filed 'DIAX CANCEL' Option Filed 'DIAX CREATE' Option Filed 'DIAX EXTRACT MENU' Option Filed 'DIAX MODIFY' Option Filed 'DIAX PRINT' Option Filed 'DIAX PURGE' Option Filed 'DIAX SELECT' Option Filed 'DIAX UPDATE' Option Filed 'DIAX VALIDATE' Option Filed 'DIEDFILE' Option Filed 'DIEDIT' Option Filed 'DIFG' Option Filed 'DIFG CREATE' Option Filed 'DIFG DISPLAY' Option Filed 'DIFG GENERATE' Option Filed 'DIFG INSTALL' Option Filed 'DIFG SPECIFIERS' Option Filed 'DIFG VIEW' Option Filed 'DIFG-SRV-HISTORY' Option Filed 'DIFIELD CHECK' Option Filed 'DIIDENT' Option Filed 'DIINQUIRE' Option Filed 'DIITRAN' Option Filed 'DIKEY' Option Filed 'DILIST' Option Filed 'DIMODIFY' Option Filed 'DIOTHER' Option Filed 'DIOTRAN' Option Filed 'DIPRINT' Option Filed 'DIRDEX' Option Filed 'DISEARCH' Option Filed 'DISTATISTICS' Option Filed 'DITEMP' Option Filed 'DITRANSFER' Option Filed 'DIUNEDIT' Option Filed 'DIUSER' Option Filed 'DIUTILITY' Option Filed 'DIVERIFY' Option Filed 'DIWF' Option Filed 'DIXREF' Option Filed 'DMSQ DIAGNOSTICS' Option Filed 'DMSQ MENU' Option Filed 'DMSQ PRINT ERRORS' Option Filed 'DMSQ PROJECT' Option Filed 'DMSQ PS COLUMNS BY DOMAIN' Option Filed 'DMSQ PS COLUMNS REG NOID' Option Filed 'DMSQ PS MENU' Option Filed 'DMSQ PS TOTAL COLUMNS' Option Filed 'DMSQ PS TOTAL COLUMNS REG' Option Filed 'DMSQ PS TOTAL INDEXES' Option Filed 'DMSQ PS TOTAL TABLE COLS' Option Filed 'DMSQ PS TOTAL TABLE COLS A' Option Filed 'DMSQ PS TOTAL TABLE ELEMENTS' Option Filed 'DMSQ PS TOTAL TABLES' Option Filed 'DMSQ PURGE' Option Filed 'DMSQ SUGGEST TABLE GROUPINGS' Option Filed 'DMSQ TS FIELDS BRIEF' Option Filed 'DMSQ TS FIELDS FULL' Option Filed 'DMSQ TS MENU' Option Filed 'DMSQ TS NAMES' Option Filed 'DMSQ TS PTR PARENT BRIEF' Option Filed 'DMSQ TS PTR PARENT FULL' Option Filed 'DMSQ TS PTR STATS' Option Filed 'DMSQ TS PTR STATS SUMMARY' Option Filed 'DMSQ TS PTR SUBFILE FULL' Option Filed 'DMSQ TS SUBFILE BRIEF' Option Filed............ This version (#22.2T0) of 'DMLAINIT' was created on 06-DEC-2012 (at FILEMAN.MUMPS.ORG, by Fileman 22.2T0) I AM GOING TO SET UP THE FOLLOWING FILES: .85 LANGUAGE (including data) Note: You already have the 'LANGUAGE' File. I will OVERWRITE your data with mine. ...SORRY, JUST A MOMENT PLEASE....................... OK, I'M DONE. NOTE THAT FILE SECURITY-CODE PROTECTION HAS BEEN MADE |
Use Fileman to edit the Inhibit Logon field in the VOLUME SET file (#14.5) for each volume set. This will allow Taskman to start tasks.
| >D Q^DI Fileman 22.2 Select OPTION: ENTER OR EDIT FILE ENTRIES INPUT TO WHAT FILE: VOLUME SET <ENTER> EDIT WHICH FIELD: ALL// INHIBIT LOGONS ? <ENTER> THEN EDIT FIELD: <ENTER> Select VOLUME SET: VAH <ENTER> INHIBIT LOGONS?: YES// NO <ENTER> |
Start Taskman.
| >D ^ZTMB |
Refer to each packageʼs documentation on how to start its background tasks. Normally Taskman is responsible for starting background tasks/filers. However, if there are any background tasks that are started manually from an external program, you will have to start them.
**** You have now completed the installation of Fileman. ****