File Manager 22.2 Installation Guide

Contents > Installation on GT.M

Installation on GT.M on Unix with Kernel Installed

This installation requires a pre-existing Kernel version 8.0.

You should have backed-up your system already.

Stop All Background Filers, such as those for MailMan, OE/RR, Integrated Billing, and HL7

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.

Pre-Install Taskman Procedures

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.

DO NOT PROCEED AT THIS POINT UNLESS YOU ARE SURE THAT THERE ARE NO VISTA/RPMS RELATED TASKS RUNNING EXCEPT YOUR OWN. RUN %SS TO CONFIRM.

Inhibit Logons for Each Volume Set

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>

Delete Old Fileman Routines and Object files

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

Read the Routines into System

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>

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.

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>

Rename % Routines

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

Initialize Fileman; Install Menu Options, Security Keys, and Remote Procedures; Install the Expanded Language File

>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 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
Re-indexing entries in the DIALOG file.............................

Compiling all forms ...
XUEDIT CHARACTERISTICS   (#1)
XUEXISTING USER   (#2)
BMC REFERRAL ADD   (#3)
<output elided>
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

Enable Logons

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>

Post-Install Taskman Procedures

Start Taskman.

>D ^ZTMB

Start all Background Filers that You Previously Stopped

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. ****

[return]