Difference between revisions of "VistALink"

From VistApedia
Jump to: navigation, search
 
(Added glossary link to Application~)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
Information for running the VistALink tester including an install script for Linux and easy instructions for Windows can be found here.  This has not been verified to allow use of any of the Java [[application~|Application]]s, however.  The instructions that follow from Minto Tsai will likely allow it.
 +
 +
http://opensourcevista.net:8888/NancysVistAServer/VistALinkFiles/
 +
 +
 +
 
== Setup VistALink 1.5 ==
 
== Setup VistALink 1.5 ==
 
  on VistA Office EHR SemiViva 2.3.1
 
  on VistA Office EHR SemiViva 2.3.1
 
  by Minto Tsai
 
  by Minto Tsai
−
 
  
 
==Background:==
 
==Background:==
−
VistALink is a utility provided by the VA to allow JAVA applications to execute Remote Procedure Calls (RPC) on the VistA/M server.
+
VistALink is a utility provided by the VA to allow JAVA [[application~|Application]]s to execute Remote Procedure Calls (RPC) on the VistA/M server.
  
 
== Environment: ==
 
== Environment: ==
Line 18: Line 23:
 
by Minto Tsai
 
by Minto Tsai
  
−
Background:
+
  Background:
−
VistALink is a utility provided by the VA to allow JAVA applications to execute Remote Procedure Calls (RPC) on the VistA/M server.  
+
VistALink is a utility provided by the VA to allow JAVA [[application~|Application]]s to execute Remote Procedure Calls (RPC) on the VistA/M server.  
  
 
Environment:
 
Environment:
Line 29: Line 34:
 
Sea Island Systems' modified VistALink routines  
 
Sea Island Systems' modified VistALink routines  
  
−
<nowiki>Setup Steps:
+
−
Install VistA Office EHR SemiViva 2.3.1
+
== Setup Steps: ==
−
Verify VistALink 1.5 is already installed:
+
 
−
GTM> D ^XUP <enter>
+
1. Install VistA Office EHR SemiViva 2.3.1
−
Terminal Type set to: C-VT100 <enter>
+
2. Verify VistALink 1.5 is already installed:
−
Select OPTION NAME: eve <enter>
+
    GTM> '''D ^XUP''' <enter>
−
CHOOSE 1-5: 1 <enter>
+
    Terminal Type set to: '''C-VT100''' <enter>
−
Select Systems Manager Menu Option: programmer <enter>
+
    Select OPTION NAME: '''eve''' <enter>
−
Select Programmer Options Option: kids <enter>
+
    CHOOSE 1-5: '''1''' <enter>
−
Select Kernel Installation & Distribution System Option: utilities <enter>
+
    Select Systems Manager Menu Option: '''programmer''' <enter>
−
Select Utilities Option: display <enter>
+
    Select Programmer Options Option: '''kids''' <enter>
−
Select PACKAGE NAME: vistalink <enter>
+
    Select Kernel Installation & Distribution System Option: '''utilities''' <enter>
−
CHOOSE 1-2: 1 <enter>
+
    Select Utilities Option: '''display''' <enter>
−
Select VERSION: 1.5// <enter></nowiki>
+
    Select PACKAGE NAME: '''vistalink''' <enter>
−
Do you want to see the Descriptions? NO// <enter>
+
    CHOOSE 1-2: '''1''' <enter>
−
DEVICE: HOME// <enter>
+
    Select VERSION: 1.5// <enter>
−
Output should be:
+
    Do you want to see the Descriptions? NO// <enter>
−
PACKAGE: VISTALINK    Jul 15, 2007 10:03 pm                          PAGE 1
+
    DEVICE: HOME// <enter>
−
PATCH #            INSTALLED                    INSTALLED BY
 
−
-------------------------------------------------------------------------------
 
−
VERSION: 1.5        OCT 08, 2006                  SCHLEHUBER,CAMERON
 
  
−
1                NOV 06, 2006@15:11:19        SCHLEHUBER,CAMERON
+
''Output should be:''
−
Save original ^XOB* routines (See ReadMe.txt from Sea Island Systems', see references below)
+
PACKAGE: VISTALINK    Jul 15, 2007 10:03 pm                          PAGE 1
−
GTM> D ^%RO <enter>
+
PATCH #            INSTALLED                    INSTALLED BY
−
Routine: ^XOB* <enter>
+
-------------------------------------------------------------------------------  
−
Routine: <enter>
+
VERSION: 1.5        OCT 08, 2006                  SCHLEHUBER,CAMERON
−
Output device: <terminal>: /tmp/xob_orig.ro <enter>
+
−
Header Label: <enter>
+
1                NOV 06, 2006@15:11:19        SCHLEHUBER,CAMERON
−
String comments <No>?: <enter>
 
−
Restore modified routines from xobv-gtm.ro (download from Sea Island Systems', see references below)
 
−
GTM> D ^%RI <enter>
 
−
Formfeed delimited <No>? <enter>
 
−
Input device: <terminal>: /tmp/xobv-gtm.ro <enter>
 
−
Output directory: <VistAOfficeEHR>/gtm_V5.2-000/r/ <enter>    <-- don't forget the last slash
 
−
Verify modified routines installed
 
−
GTM> ZLINK "XOBVTCPL" WRITE $TEXT(+5^XOBVTCPL) <enter>
 
−
Output should be:
 
−
; SIS/LM - Modified for GT.M - Mar 23, 2004
 
−
Start the listener
 
−
GTM> JOB LISTENER^XOBVTCPL(8001) <enter>
 
−
Verify listener has started
 
−
GTM> <Press CTRL-Z>
 
−
$ lke show all <enter>
 
−
Output should be:
 
  
−
DEFAULT
+
3. Save original ^XOB* routines (See ReadMe.txt from Sea Island Systems', see references below)
 +
    GTM> D ^%RO <enter>
 +
    Routine: ^XOB* <enter>
 +
    Routine: <enter>
 +
    Output device: <terminal>: /tmp/xob_orig.ro <enter>
 +
    Header Label: <enter>
 +
    String comments <No>?: <enter>
 +
4. Restore modified routines from xobv-gtm.ro (download from Sea Island Systems', see references below)
 +
    GTM> D ^%RI <enter>
 +
    Formfeed delimited <No>? <enter>
 +
    Input device: <terminal>: /tmp/xobv-gtm.ro <enter>
 +
    Output directory: <VistAOfficeEHR>/gtm_V5.2-000/r/ <enter>    <-- don't forget the last slash
 +
5. Verify modified routines installed
 +
    GTM> ZLINK "XOBVTCPL" WRITE $TEXT(+5^XOBVTCPL) <enter>
 +
''Output should be:''
 +
; SIS/LM - Modified for GT.M - Mar 23, 2004
 +
 
 +
6. Start the listener
 +
    GTM> JOB LISTENER^XOBVTCPL(8001) <enter>
 +
 
 +
7. Verify listener has started
 +
    GTM> <Press CTRL-Z>
 +
    $ lke show all <enter>
 +
''Output should be:''
 +
 
 +
DEFAULT
 
         ^%ZIS(8994.171,RPCB Listener,ROU,VAH,ROU:KLW133,9210)
 
         ^%ZIS(8994.171,RPCB Listener,ROU,VAH,ROU:KLW133,9210)
 
                         Owned by PID= 32102 which is an existing process
 
                         Owned by PID= 32102 which is an existing process
 
         ^XOB(18.01,VistALink Listener,ROU,VAH,ROU:KLW133,8001)
 
         ^XOB(18.01,VistALink Listener,ROU,VAH,ROU:KLW133,8001)
 
                         Owned by PID= 18338 which is an existing process
 
                         Owned by PID= 18338 which is an existing process
−
$ fg
+
$ fg
−
Telnet test to listener
+
 
−
telnet localhost 8001
+
8. Telnet test to listener
−
you should connect if the listener is up
+
    telnet localhost 8001
−
Create a user (or use existing user)
+
    you should connect if the listener is up
−
User's Access/Verify Code must use capital letters
+
 
−
Grant Kernel Access to Sample Application  
+
9. Create a user (or use existing user)
−
In User Edit, for Primary/Secondary Menu Options, assign “XOBV VISTALINK TESTER”
+
    User's Access/Verify Code must use capital letters
−
  Installing VistALink sample application files
+
 
−
unzip XOB_1_5.ZIP
+
10. Grant Kernel Access to Sample [[Application~|Application]]
−
cd vlj-1.5.0.026/samples/J2SE
+
    In User Edit, for Primary/Secondary Menu Options, assign “XOBV VISTALINK TESTER”
−
  copy VistALink libraries (under vlj-1.5.0.026/jars dir)
+
   
 +
11. Installing VistALink sample [[application~|Application]] files
 +
    unzip XOB_1_5.ZIP
 +
    cd vlj-1.5.0.026/samples/J2SE
 +
 
 +
  '''copy VistALink libraries (under vlj-1.5.0.026/jars dir)'''
 
  vljConnector-1.5.0.026.jar
 
  vljConnector-1.5.0.026.jar
 
  vljFoundationsLib-1.5.0.026.jar
 
  vljFoundationsLib-1.5.0.026.jar
 
  vljSecurity-1.5.0.026.jar
 
  vljSecurity-1.5.0.026.jar
−
  copy supporting library files
+
 
 +
  '''copy supporting library files'''
 
  j2ee.jar (get from J2EE SDK)
 
  j2ee.jar (get from J2EE SDK)
 
  jaxen-dom.jar (under vlj-1.5.0.026/rar/ExplodedVistaLinkRAR/lib dir)
 
  jaxen-dom.jar (under vlj-1.5.0.026/rar/ExplodedVistaLinkRAR/lib dir)
Line 101: Line 118:
 
  saxpath.jar  
 
  saxpath.jar  
 
  log4j-1.2.8.jar
 
  log4j-1.2.8.jar
−
  create setVistaLinkEnvironment.sh from setVistaLinkEnvironment.bat
+
 
−
  create runSwingTester.sh from runSwingTester.bat
+
  '''create setVistaLinkEnvironment.sh from setVistaLinkEnvironment.bat'''
−
Running SwingTester sample application
+
  '''create runSwingTester.sh from runSwingTester.bat'''
−
  source setVistaLinkEnvironment.sh
+
 
 +
== Running SwingTester sample [[application~|Application]] ==
 +
 
 +
  '''source setVistaLinkEnvironment.sh'''
 
  . ./setVistaLinkEnvironment.sh
 
  . ./setVistaLinkEnvironment.sh
−
  launch SwingTester
+
 
 +
  '''launch SwingTester'''
 
  ./runSwingTester.sh'
 
  ./runSwingTester.sh'
 +
 
  '''connect to M server'''
 
  '''connect to M server'''
 
  enter IP: localhost
 
  enter IP: localhost

Latest revision as of 14:51, 22 February 2012

Information for running the VistALink tester including an install script for Linux and easy instructions for Windows can be found here. This has not been verified to allow use of any of the Java Applications, however. The instructions that follow from Minto Tsai will likely allow it.

http://opensourcevista.net:8888/NancysVistAServer/VistALinkFiles/


Setup VistALink 1.5

on VistA Office EHR SemiViva 2.3.1
by Minto Tsai

Background:

VistALink is a utility provided by the VA to allow JAVA Applications to execute Remote Procedure Calls (RPC) on the VistA/M server.

Environment:

Ubuntu 7.04 (Feisty Fawn)
JDK 1.5.0_12
J2EE SDK 5.02
VistA Office EHR SemiViva 2.3.1
VistALink 1.5 (Listener is already installed on VistA Office EHR SemiViva 2.3.1)
Sea Island Systems' modified VistALink routines

Setup VistALink 1.5 on VistA Office EHR SemiViva 2.3.1 by Minto Tsai 

 Background:

VistALink is a utility provided by the VA to allow JAVA Applications to execute Remote Procedure Calls (RPC) on the VistA/M server.

Environment: Ubuntu 7.04 (Feisty Fawn) JDK 1.5.0_12 J2EE SDK 5.02 VistA Office EHR SemiViva 2.3.1 VistALink 1.5 (Listener is already installed on VistA Office EHR SemiViva 2.3.1) Sea Island Systems' modified VistALink routines


Setup Steps:

1. Install VistA Office EHR SemiViva 2.3.1
2. Verify VistALink 1.5 is already installed:
   GTM> D ^XUP <enter>
   Terminal Type set to: C-VT100 <enter>
   Select OPTION NAME: eve <enter>
   CHOOSE 1-5: 1 <enter>
   Select Systems Manager Menu Option: programmer <enter>
   Select Programmer Options Option: kids <enter>
   Select Kernel Installation & Distribution System Option: utilities <enter>
   Select Utilities Option: display <enter>
   Select PACKAGE NAME: vistalink <enter>
   CHOOSE 1-2: 1 <enter>
   Select VERSION: 1.5// <enter>
   Do you want to see the Descriptions? NO// <enter>
   DEVICE: HOME// <enter>

Output should be:
PACKAGE: VISTALINK     Jul 15, 2007 10:03 pm                          PAGE 1 
PATCH #             INSTALLED                     INSTALLED BY 
------------------------------------------------------------------------------- 
VERSION: 1.5        OCT 08, 2006                  SCHLEHUBER,CAMERON 

1                NOV 06, 2006@15:11:19         SCHLEHUBER,CAMERON 

3. Save original ^XOB* routines (See ReadMe.txt from Sea Island Systems', see references below)
   GTM> D ^%RO <enter>
   Routine: ^XOB* <enter>
   Routine: <enter>
   Output device: <terminal>: /tmp/xob_orig.ro <enter>
   Header Label: <enter>
   String comments <No>?: <enter>
4. Restore modified routines from xobv-gtm.ro (download from Sea Island Systems', see references below)
   GTM> D ^%RI <enter>
   Formfeed delimited <No>? <enter>
   Input device: <terminal>: /tmp/xobv-gtm.ro <enter>
   Output directory: <VistAOfficeEHR>/gtm_V5.2-000/r/ <enter>     <-- don't forget the last slash
5. Verify modified routines installed
   GTM> ZLINK "XOBVTCPL" WRITE $TEXT(+5^XOBVTCPL) <enter>
Output should be:
; SIS/LM - Modified for GT.M - Mar 23, 2004

6. Start the listener
   GTM> JOB LISTENER^XOBVTCPL(8001) <enter>

7. Verify listener has started
   GTM> <Press CTRL-Z>
   $ lke show all <enter>
Output should be:

DEFAULT
       ^%ZIS(8994.171,RPCB Listener,ROU,VAH,ROU:KLW133,9210)
                        Owned by PID= 32102 which is an existing process
       ^XOB(18.01,VistALink Listener,ROU,VAH,ROU:KLW133,8001)
                        Owned by PID= 18338 which is an existing process
$ fg

8. Telnet test to listener
   telnet localhost 8001
   you should connect if the listener is up

9. Create a user (or use existing user)
   User's Access/Verify Code must use capital letters

10. Grant Kernel Access to Sample Application 
    In User Edit, for Primary/Secondary Menu Options, assign “XOBV VISTALINK TESTER”

11. Installing VistALink sample Application files
    unzip XOB_1_5.ZIP
    cd vlj-1.5.0.026/samples/J2SE

copy VistALink libraries (under vlj-1.5.0.026/jars dir)
vljConnector-1.5.0.026.jar
vljFoundationsLib-1.5.0.026.jar
vljSecurity-1.5.0.026.jar

copy supporting library files
j2ee.jar (get from J2EE SDK)
jaxen-dom.jar (under vlj-1.5.0.026/rar/ExplodedVistaLinkRAR/lib dir)
jaxen-core.jar 
saxpath.jar 
log4j-1.2.8.jar

create setVistaLinkEnvironment.sh from setVistaLinkEnvironment.bat
create runSwingTester.sh from runSwingTester.bat

Running SwingTester sample Application

source setVistaLinkEnvironment.sh
. ./setVistaLinkEnvironment.sh

launch SwingTester
./runSwingTester.sh'

connect to M server
enter IP: localhost
enter Port: 8001
click Connect
enter Access/Verify code

References:

VistALink VA Documentation - [1]

Vistapedia Documentation (see item 14)- [2]

Sea Island Systems' modified VistALink routines - [3]

Retrieved from "https://vistapedia.com/index.php?title=VistALink&oldid=14008"