$TXT Created by TOPPENBERG,KEVIN at FAMILY PHYSICANS OF GREENEVILLE (KIDS) on 1/7/10
=============================================================================
Run Date: 3/31/10		     Designation: TMG1-1.0*1.0*6
Package : TMG - FAMILY PHYSICANS OF GREENEVILLE  Priority: Optional
Version : 1       SEQ #6                       Status: Released
=============================================================================

Associated patches: None

Subject: Patch to support TMG-CPRS Imaging

Category:
  - Routine

Description:
============
  This patch provides adds extra fields use with TMG-CPRS imaging, added to NETWORK LOCATION
  file, with field numbers and field names being in the TMG numberspace.

Important background information
================================
  Traditional CPRS does not support built in imaging.  It will show an icon next to a note
  to flag that there is an image attached to the note.  But it does not provide a way to
  view this.  This task has been deligated to a separate application, VistA Imaging (VI).

  TMG-CPRS integrates the display of such objects into a separate IMAGES tab inside TMG-CPRS.

  With VI, the server will provide the name of the linked image.  It is the responsibility of the
  client to fetch the image via a shared MS Windows samba filesystem.  We did not feel this gave
  adequate security, as anyone at this computer could browse all images if they simply knew the
  folder path.

  TMG-CPRS changes this system slightly.  I should still be compatible with other VistA imaging
  solutions, though this has not been tested.  It uses a drop-box system, whereby the server puts
  the requested files into a drop-box folder.  And it is from here that TMG-CPRS moves the image
  to a local temporary folder on the client.  In this way, the server controls what is visible 
  to the client.

  At our location, we have a linux server running VistA, and we have a MS Windows server running
  our domain for all the desktop client PC's.  We store the images on the linux server, and put
  the drop-box folder on the MS Windows machine.  We then mount the windows drive as a drive on the
  Linux filesystem.

  TMG-CPRS has functionality to also transport the images inside RPC calls (independant of any
  requirements for a common file system.)  But it is slower.  It also has the ability to interact 
  directly with the stored images folder, if that is how an administer wants to set things up.
  However, at the time of this writing that have not been fully debugged and are turned off.

  Information about images is stored in the IMAGE file (2005) on the server.  A file name will be
  stored in the FILEREF field, but there is no path included in the file name.  This allows the
  images to be moved if needed without breaking the filename.  The TMG-CPRS RPC calls need to know
  where the images are stored.  And it needs to know where the drop box is.  This information is
  stored in the three custom fields below.

  The patch provides three custom fields to the NETWORK LOCATION file:

	22700-TMG PRIVATE PHYSICAL REFERENCE    e.g. /opt/var/Vista/server-files
 	22701-TMG NODE DIVIDER SYMBOL           e.g. /
 	22702-TMG DROPBOX PHYSICAL REFERENCE    e.g. /mnt/WinServer/dropbox/

  The final piece of configuration that will be required to be set up is the filepath of the 
  drop-boxfolder on the MS Windows samba filesystem.  This will allow TMG-CPRS to pull the image 
  and display it.  This will be configurable under TMG-CPRS options.  Options --> Images tab.
  

Post-installation Configuration instructions.  
==============================================

 ... to be finished later...



  INSTALLATION INSTRUCTIONS:
  ==========================
  Users should be logged off the system.  
  Note: the follow instructions were copied from another KIDS install and modified.  
  There may be some discrepancies.

  The following are instructions for those using the Packman method:
  ------------------------------------------------------------------
  1.  Use the INSTALL/CHECK MESSAGE option on the PackMan menu.

  2.  Review your mapped set.  If any of the routines listed in the
      ROUTINE SUMMARY section are mapped, they should be removed
      from the mapped set at this time.

  3.  From the Kernel Installation and Distribution System Menu, select
      the Installation menu.

  4.  From this menu, you may elect to use the following options
      (when prompted for INSTALL NAME, enter TMG1-1.0-6:
          a.  Backup a Transport Global
          b.  Compare Transport Global to Current System
          c.  Verify Checksums in Transport Global

  5.  Use the Install Package(s) option and select the package TMG1-1.0-6

  6.  When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//'
      respond NO.

  7.  When prompted 'Want to DISABLE Scheduled Options, Menu Options, and
      Protocols? YES//', respond NO.

  8.  If routines were unmapped as part of step 2, they should be returned
      to the mapped set once the installation has run to completion.

  9.  (See step 9 below)

  The following are instructions for those loading the patch via Host File System:
  ---------------------------------------------------------------------------------
  1.  Navigate the menu option path to reach the Kernel Installation and Distribution
      System Menu.  Or, the menu option XPD MAIN may be entered directly.

  2.  Next, at the menu displaying:
          Edits and Distribution ...
          Utilities ...
          Installation ...     <---------- pick this one.

  3.  Next, at the menu displaying the options as below, choose each of the options
      in a step-by-step fashion, in numerical order (i.e. 1, 2, 3 etc.)  Step #1 will
      prompt the user to enter the file path on the host file system where the source
      file is stored.  The filename to enter is TMG1-1.0-6.KIDS, but add the
      appropriate path.  E.g. /tmp/TMG1-1.0-6.KIDS

       1      Load a Distribution
       2      Verify Checksums in Transport Global
       3      Print Transport Global
       4      Compare Transport Global to Current System
       5      Backup a Transport Global
       6      Install Package(s)
              Restart Install of Package(s)
              Unload a Distribution

  4.  From this menu, you may elect to use the following options
      (when prompted for INSTALL NAME, enter TMG1-1.0-6
          a.  Backup a Transport Global
          b.  Compare Transport Global to Current System
          c.  Verify Checksums in Transport Global

  5.  Use the Install Package(s) option and select the package TMG1-1.0-6

  6.  When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//'
      respond NO.

  7.  When prompted 'Want to DISABLE Scheduled Options, Menu Options, and
      Protocols? YES//', respond NO.

  8.  If routines were unmapped as part of step 2, they should be returned
      to the mapped set once the installation has run to completion.


=============================================================================
User Information:
Entered By  : TOPPENBERG,KEVIN            Date Entered : 3/31/10
Completed By: TOPPENBERG,KEVIN            Date Completed: 3/31/10
Released By : TOPPENBERG,KEVIN            Date Released : 3/31/10
=============================================================================

Packman Mail Message:
=====================

$END TXT
