large_diamond.gif (4180 bytes)


(for Cache 2.x)

Home PageM |  FileMan | Kernel | CS/MM/Web | Programmer Tools | Applications

The first jewel to be added to the Hardhats Gem series is the Diamond.  It is a clean, initialized Infrastructure-only installation of VistA that works under Intersystems Cache.  As such, it is distributed as a Cache.dat file. The following instructions provide guidance on how to setup and integrate the Cache.dat file into an existing configuration.

NOTE: The instructions on this page were developed with Cache v 2.1.6. Cache v3 has dramatically changed the user interface, so you will need to study the notes to find the corresponding settings. For those who are eternally curious, read how the Diamond is cut.

It is presumed that:

  • The reader is moderately familiar with the Cache configuration tools
  • Cache is installed and operational
  • The Diamond Cache.dat file has been acquired (if the zipped version, it must be unzipped prior to installation).

To increase the value to all Hardhats, please report errors, ask questions, etc. on the Hardhats mailing list. (Join the Hardhats mailing list if you are not already a subscriber - its free.)

Cache Linux shortcut:     For those who want to evaluate the Cache red Hat Linux download from Intersystems, you can download a preconfigured .cpf file. The file is named kernel.txt.  Rename it to kernel.cpf, once it is downloaded, and place it in the Cache directory where the cache.cpf file is located. You will then need to specify this new kernel.cpf file as the startup configuration for Cache.  If you have any doubts about this shortcut, use the steps below, instead, to update your configuration settings.

Let the Setup and Configuration begin...

small_diamond.gif (1445 bytes)  BACKUP!

As a precaution, be sure to have backed up your Cache installation before proceeding with the following procedure.

small_diamond.gif (1445 bytes)  Cache Account Creation

NOTE: It is your choice if Cache is running in the initial steps, but you will eventually be requested to shut down and then restart Cache.

To prepare for a baseline VistA install on Cache, create a dataset for use by the new namespace KERNEL.  Just click in the leftmost cell on the first blank line in the grid, shown below, to open a field to enter Dataset Name, etc.

dataset(gray).gif (10058 bytes)


small_diamond.gif (1445 bytes)  Cache Routine and Global Mappings

With the dataset in place, go to the Namespace tab and create a new namespace (this one is named KERNEL and was added with the 'Add Namespace' button).  Give the new namespace the following routine and global mappings (see images below).

[NOTE: The dataset and the namespace are not required to have the same name.]

routinemap(gray).gif (14739 bytes)

dataset(gray).gif (14322 bytes)


small_diamond.gif (1445 bytes)  Place the Cache.dat

NOTE: Shutdown Cache, in case it is currently running.

  1. Create a KERNEL directory in the MGR folder, where you have Cache installed. (If you use a name other than KERNEL, you will be required to perform one extra step at the end of the installation process.)
  2. Copy the Diamond Cache.dat file into the KERNEL directory.
  3. IMPORTANT: Under some versions of Windows, a file copied from a CD has its Read Only attribute checked. To change this, right click on the Cache.dat file that was just copied into the KERNEL directory.  Select the properties option and then uncheck the Read-only checkbox. Failure to do so, will cause Cache to report write errors.

small_diamond.gif (1445 bytes)  Confirm Installation Success

  1. Start Cache (click the green stoplight icon on the Cache Configuration floating bar).
  2. Start Utilities (click the yellow lightbulb icon on the Cache Configuration floating bar).
  3. If asked, select 'localTCP' at the Choose Connection box.
  4. From the Cache Utilities tool bar, select System Utilities.
  5. In the System Utilities window, select the Databases tab (you should see user, common, etc.).
  6. If you see KERNEL, you are set. If KERNEL does not appear, click the refresh button on the bottom right.
  7. Go back to the Cache Configuration floating bar and select Cache Programmer (the blue terminal screen icon).
  8. By default, it will take you to %sys.
  9. At the programmer prompt,. enter D ^%CD.
  10. Enter KERNEL (this will take you to the new cache.dat).
  11. If you used a namespace other than KERNEL, perform this dialog to synchronize the Diamond installation with your namespace.
  12. You can confirm you are there by doing the following at the programmer prompt:
        D ^%RD (use * to list all routine names)
        D ^%GD 

small_diamond.gif (1445 bytes)  Logging on

  1. At the > programmer prompt, enter D ^ZU to logon.
  2. At the Access Code: prompt enter "HH1234".
  3. When asked Verify Code:, simply press return.
  4. At the prompt for a new Verify Code, enter a code of your own choosing.
    (It must be a mixture of at least six alpha and numeric characters.)
  5. The System Manager's menu will appear.
  6. Explore the various menus to see the Printers that have been defined, etc.
  7. HAVE FUN!


Search | Home | MUMPS | Fileman | Kernel | C/S, Mailman, Web | Programmer Tools | Applications