To acquire the VistA-M source tree, follow the instructions in ObtainingVistAMCode. To prepare the M components for import into the VistA instance, follow the steps found in the PrepareMComponents document.
The next set of steps is to import the routines and globals into the Caché instance and then configure the instance to the point where testing can be performed. All of these steps are performed from the Caché terminal. Right click on the Caché icon and select terminal from the pop-up as shown to bring up a Caché terminal.
The first step is to change from the default "USER" namespace to the namespace that you created earlier. Entering "D ^%CD" will bring up a prompt to accept the name of the new namespace that you want to enter. For demonstration purposes, we will assume that the namespace is called "VISTA".
USER> D ^%CD Namespace: VISTA You're in namespace VISTA Default directory is c:\intersystems\trycache\mgr\vista\ VISTA>
The %RI routine is a MUMPS routine that is used to import other routines from a specific file type. When prompted for a device, enter the path to the routines.ro file and press <Enter> to accept the default parameters, read-only mode. The terminal will then display a warning saying "This file may not be a %RO output file." This is an expected warning due to how we are creating the routines.ro file. At the prompt, enter "Yes" to continue and then enter then <Enter> to accept the 0th option (Caché) for the routines write type. To fully import the routines, enter "All Routines" at the Routine Input Option, and answer "YES" to "replace similarly named routines." All other options may be answered with <Enter> to accept the default value.
VISTA> D ^%RI Input routine from Sequential Device: (path to VistAroutines.ro) Parameters? "R" => (enter) * W A R N I N G * File Header: Routines Date Stamp: This file many not be a %RO output file. Override and use this File with %RI? No => <Yes> %RI has detected a routine written with UNKNOWN mode. 0) Cache . . . 11) MVBASIC Please enter a number from the above list: 0 File written by OLD with description: Routines ( All Select Enter List Quit ) Routine Input Option: All If a selected routiens has the same name as one already on file, shall it replace the one on file? No => Yes Recompile? Yes => Yes Display Syntax Errors? Yes => Yes
The system will respond with a list of all that have been processed and then displays the VistA prompt . In the listing, the symbols next to the routine name have meaning:
^ indicates routines which will replace those now on file.
@ indicates routines which have been [re]compiled.
- indicates routines which have not been filed.
The next step is to use the newly imported ZGI routine to import the VistA
globals from the repository. This ZGI routine should have been imported in the
routines.ro file which was created in the PrepareMComponents document.
If it is not found in the local instance, you can find ZGI in the Scripts
directory of the VistA repository. A .ro file for only that routine can
be created by using the command from PrepareMComponents, but only pass the
path to the VistA/Scripts directory as the arguments to the
PrepareMComponentsforImport.py file. That .ro file can be imported
with the same process as the above files.
Once ZGI is available, execute the LIST entry point of the ZGI routine
using the MUMPS WRITE command to start the import. An example follows:
VISTA> W $$LIST^ZGI("C:/Users/joe.snyder/Desktop/VistA/globals.lst")
C:/Users/joe.snyder/Desktop/VistA-M/Packages/Accounts Receivable/Globals/340+AR DEBTOR.zwr
C:/Users/joe.snyder/Desktop/VistA-M/Packages/Accounts Receivable/Globals/341+AR EVENT.zwr
C:/Users/joe.snyder/Desktop/VistA-M/Packages/Accounts Receivable/Globals/341.1+AR EVENT TYPE.zwr
.
.
.
C:/Users/joe.snyder/Desktop/VistA-M/Packages/Womens Health/Globals/790.72+WV AGE RANGE DEFAULT.zwr
C:/Users/joe.snyder/Desktop/VistA-M/Packages/Womens Health/Globals/WV.zwr
C:/Users/joe.snyder/Desktop/VistA-M/Packages/Wounded Injured and Ill Warriors/Globals/987.5+WII ADMISSIONS DISCHARGES.zwr
C:/Users/joe.snyder/Desktop/VistA-M/Packages/Wounded Injured and Ill Warriors/Globals/987.6+WII PARAMETERS.zwr
C:/Users/joe.snyder/Desktop/VistA-M/Packages/Wounded Injured and Ill Warriors/Globals/WII.zwr
VISTA>
At this point, all routines and globals are imported and the environment is ready to be configured. Enter "D ^ZTMGRSET" to initialize the current instance for use. Choose the default, Caché environment. Some routines are loaded and a series of prompts are shown on the screen. The NAME OF MANAGER'S NAMESPACE, PRODUCTION (SIGN-ON) NAMESPACE, and NAME OF THIS CONFIGURATION prompts should be answered with the name of the namespace that was created earlier (VISTA in this configuration), . At the fourth prompt, "Want to rename the FileMan routines," enter "Y" to rename the routines.
VISTA> D ^ZTMGRSET ZTMGRSET Version 8.0 Patch level 34,36,69,94,121,127,136,191,275,355,446 HELLO! I exist to assist you in correctly initializing the current account. Which MUMPS system should I install? 1 = VAX DSM(V6), VAX DSM(V7) 2 = MSM-PC/PLUS, MSM for NT or UNIX 3 = Cache (VMS, NT, Linux), OpenM-NT 4 = Datatree, DTM-PC, DT-MAX 5 = 6 = 7 = GT.M (VMS) 8 = GT.M (Unix) System: 3 I will now rename a group of routines specific to your operating system. Routine: ZOSVONT Loaded, Saved as %ZOSV Routine: ZIS4ONT Loaded, Saved as %ZIS4 . . . Routine: ZOSVKSOS Loaded, Saved as %ZOSVKSS Routine: ZOSVKSD Loaded, Saved as %ZOSVKSD NAME OF MANAGER'S NAMESPACE: %SYS// VISTA PRODUCTION (SIGN-ON) NAMESPACE: VAH// VISTA NAME OF THIS CONFIGURATION: ROU// VISTA ALL SET UP Now to load routines common to all systems. Routine: ZTLOAD Loaded, Saved as %ZTLOAD . . . Routine: ZTPTCH Loaded, Saved as %ZTPTCH Routine: ZTRDEL Loaded, Saved as %ZTRDEL Routine: ZTMOVE Loaded, Saved as %ZTMOVE Want to rename the FileMan routines: No// YES Routine: DIDT Loaded, Saved as %DT Routine: DIDTC Loaded, Saved as %DTC Routine: DIRCR Loaded, Saved as %RCR Installing ^%Z editor Setting ^%ZIS('C') Now, I will check your % globals........... ALL DONE VISTA>