This installation requires a pre-existing Kernel version 8.0.
You should have backed-up your system already.
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 ZSY, %SS, or an equivalent utility to ensure that all jobs have stopped. Do not proceed if all jobs have not been stopped yet.
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.
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> |
Find the main routines directory on Unix, and delete all Fileman routines from it. Please note that if you have local routines (DIZ*, DDZ*, DMZ*), you need to back those up prior to deletion and then restore them later.
Here is an example, shown from a Linux command-line prompt (note that your site may use a different directory structure):
| [~]$ echo $gtmroutines /home/sandbox/r/6.0-000(/home/sandbox/r) /home/sandbox/lib/gtm [~]$ cd /home/sandbox/r/ [~]$ rm -v D{I,D,M}*.m [~]$ rm -v 6.0-000/D{I,D,M}*.o |
Use your M systemʼs routine loading utility to load the Fileman version 22.2 routines from the distribution file (VA-FILEMAN-22P2.RSA).
| >D ^%RI Routine Input Utility - Converts RO file to *.m files. Formfeed delimited <No>? <ENTER> Input device: <terminal>: /tmp/VA-FILEMAN-22P2V1.RSA <ENTER> Fileman 22.2 GT.M 13-DEC-2012 14:46:40 Output directory : <-----------Enter the full path for the directory where your VISTA routines reside DDBR DDBR0 DDBR1 DDBR2 DDBR3 DDBR4 <remaining output elided> |
DINTEG detects any discrepancies between your copy of Fileman and the one distributed by the developers.
NOTE: As the integrity of the routines is checked, each will be compiled by GT.M. Many of these routines contains non-GT.M commands which will generate compiler errors. Code guards will ensure that these commands will never be executed, so these errors should be ignored.
| >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. Note: underscores below are used instead of % per GT.M system requirements.
From a Linux command-line prompt:
| cp ~/r/DIDT.m ~/r/_DT.m cp ~/r/DIDTC.m ~/r/_DTC.m cp ~/r/DIRCR.m ~/r/_RCR.m |
| >D ^DINIT,^DIINIT,^DMLAINIT |
The following is an example of the initialization process done at the Development RPMS 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: 8904// <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 NAMETYPE OF MUMPS SYSTEM YOU ARE USING: GT.M(UNIX)// <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 ... XUEDIT CHARACTERISTICS (#1)INITIALIZATION COMPLETED IN 9 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 ...EXCUSE ME, 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. ****