Difference between revisions of "VistALink"
From VistApedia
m (→Environment:) |
(Added glossary link to Application~) |
||
| (2 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 | + | 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 19: | Line 24: | ||
Background: | Background: | ||
| − | VistALink is a utility provided by the VA to allow JAVA | + | 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 48: | Line 53: | ||
DEVICE: HOME// <enter> | DEVICE: HOME// <enter> | ||
| − | Output should be: | + | ''Output should be:'' |
PACKAGE: VISTALINK Jul 15, 2007 10:03 pm PAGE 1 | PACKAGE: VISTALINK Jul 15, 2007 10:03 pm PAGE 1 | ||
PATCH # INSTALLED INSTALLED BY | PATCH # INSTALLED INSTALLED BY | ||
| Line 68: | Line 73: | ||
Input device: <terminal>: /tmp/xobv-gtm.ro <enter> | Input device: <terminal>: /tmp/xobv-gtm.ro <enter> | ||
Output directory: <VistAOfficeEHR>/gtm_V5.2-000/r/ <enter> <-- don't forget the last slash | Output directory: <VistAOfficeEHR>/gtm_V5.2-000/r/ <enter> <-- don't forget the last slash | ||
| − | Verify modified routines installed | + | 5. Verify modified routines installed |
| − | GTM> ZLINK "XOBVTCPL" WRITE $TEXT(+5^XOBVTCPL) <enter> | + | GTM> ZLINK "XOBVTCPL" WRITE $TEXT(+5^XOBVTCPL) <enter> |
| − | Output should be: | + | ''Output should be:'' |
| − | ; SIS/LM - Modified for GT.M - Mar 23, 2004 | + | ; SIS/LM - Modified for GT.M - Mar 23, 2004 |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | DEFAULT | + | 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) |
| − | + | User's Access/Verify Code must use capital letters | |
| − | Installing VistALink sample application files | + | |
| − | + | 10. Grant Kernel Access to Sample [[Application~|Application]] | |
| − | + | In User Edit, for Primary/Secondary Menu Options, assign “XOBV VISTALINK TESTER” | |
| + | |||
| + | 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)''' | '''copy VistALink libraries (under vlj-1.5.0.026/jars dir)''' | ||
| Line 110: | Line 121: | ||
'''create setVistaLinkEnvironment.sh from setVistaLinkEnvironment.bat''' | '''create setVistaLinkEnvironment.sh from setVistaLinkEnvironment.bat''' | ||
'''create runSwingTester.sh from runSwingTester.bat''' | '''create runSwingTester.sh from runSwingTester.bat''' | ||
| − | + | ||
| − | == Running SwingTester sample application == | + | == Running SwingTester sample [[application~|Application]] == |
'''source setVistaLinkEnvironment.sh''' | '''source setVistaLinkEnvironment.sh''' | ||
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/
Contents
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]
