File Manager 22.2 Installation Guide

Contents > Installation on Caché

Installation on Caché/Ensemble on Any OS with Kernel Installed

You should have backed-up your system already.

This installation requires a pre-existing Kernel version 8.0.

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

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 ^%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.

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

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.

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

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-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 the Integrity Routine

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>

Rename % Routines

Save DIDT as %DT, DIDTC as %DTC, and DIRCR as %RCR.

>ZL DIDT ZS %DT
>ZL DIDTC ZS %DTC
>ZL DIRCR ZS %RCR

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 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 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 ...
DICATT   (#.001)
DIPTED   (#.1001)
DIKC EDIT   (#.1101)
DIKC EDIT UI   (#.1102)
<output elided>
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

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]