:: Department of Veterans Affairs
:: HDSO
:: Product: VistALink (VL)

:: Connectivity Scope: J2EE to VistA/M
                       J2SE to VistA/M

:: Version: 1.6.9.001

=============================================
       CONTENTS
=============================================

   I. Build History/Lifecycle Map
  II. Introduction
 III. Zip Structure
  IV. Installation Instructions
   V. Known Issues and Limitations 
  VI. M Checksum Information


=============================================
   I.     Build History/Lifecycle Map
=============================================

Significant VistaLink release objects (JARs, EARs, WARs, etc.) have a build # in 
their filenames (e.g., in "vljSamples-1.6.8.001.jar", "001" is the build 
number). To determine what position in the development lifecycle a given 
VistALink build# represents, consult the following table.

      VistALink   VistALink
   v1.6 Build #   Lifecycle Position    Status
   ------------   --------------------  -------------------
     1.6.8.001 Release Candidate    current
     1.6.7.001 Release Candidate 6   (old)
     1.6.1.008 Release Candidate 5   (old                 
            028   Release Candidate 4   (old)
            027   Release Candidate 3   (old)
            026   Release Candidate 2   (old)
            025   Release Candidate 1   (old)
            024   Dev Preview 2         (old)
            023   Dev Preview           (old)


=============================================
  II.     Introduction
=============================================

VistALink v1.6.8 addresses a new SamlConnectionSPec requirement, as well as adaptation 
for the TRM approved dependency components and the 12c platform.
There are no functionality changes made to the J2EE Connectors. 
VistALink v1.6.8 provides a J2CA v1.5-compatible connector.

The previous version of VistALink (v1.5) was released in 6/06, and supports J2EE
v1.3 application servers (particularly WebLogic v. 8.1). It provides a J2CA 
v1.0-compatible connector.


=============================================
 III.     Zip Structure
=============================================

The directory structure of the distribution zip file is as follows:

   /vlj-1.6.8.xxx

        /app-j2ee               Application components for J2EE installation
            /configFile-j2ee    sample gov.va.med.vistalink.connectorConfig.xml configuration file
            /console            Console  standalone EAR version
            /Rar-Dev-Template   RAR for development systems
            /Rar-Prod-Template  RAR for production systems
            /sample             J2EE (web) sample application and its source code
            /shared-lib         shared libraries for production systems
            
        /javadoc                javadoc for public java-side VistALink APIs
        /log4j                    configuration file examples, VistALink logger spreadsheet
        /m                         KIDS distribution containing M side of VistALink
        /rpc-doc               extract of RPC Broker documentation on how to write RPCs
        /app-j2se              sample J2SE (rich client) application and its source code


=============================================
  IV.   Installation Instructions
=============================================

 - See the Installation Guide draft document provided with this version for a 
   installation instructions.


=============================================
   V.     Known Issues and Limitations 
=============================================

  - In WebLogic v10.3 and onward, the console plug-in should not be used. In its place, a
   standalone web application version of the console is provided in an EAR file.


=============================================
  VI.    M Checksum Information 
=============================================
   
This location is where M routine checksums are documented for VistALink.

Routine    CHECK1^XTSUMBLD checksum
--------   ------------------------
Package: XOBU 1.6

XOBUENV   value = 95255801
XOBUM     value = 36328580
XOBUM1    value = 26724948
XOBUPOST  value = 715309
XOBUPRE   value = 3331902
XOBUZAP   value = 66617883
XOBUZAP0  value = 5948951
XOBUZAP1  value = 2296758


Package: XOBV 1.6

XOBVLIB   value = 29603500
XOBVLL    value = 20760795
XOBVLT    value = 32764303
XOBVPOST  value = 74051370
XOBVPRE   value = 568396
XOBVRH    value = 12957948
XOBVRM    value = 4502318
XOBVRMX   value = 3008010
XOBVRPC   value = 55791656
XOBVRPCI  value = 31578368
XOBVRPCX  value = 22239279
XOBVSKT   value = 19091287
XOBVSYSI  value = 53927220
XOBVTCP   value = 48106146
XOBVTCPL  value = 7619114
XOBVTLS   value = 4033073


Package: XOBS 1.6

XOBSCAV   value = 55844023
XOBSCAV1  value = 81688032
XOBSCAV2  value = 64619205
XOBSCI    value = 583719
XOBSRA    value = 61930744
XOBSRA1   value = 2720328
XOBSRAKJ  value = 10014384
