VistALink - Revision history

NeilArmstrong: Added glossary link to Application~

2012-02-22T14:51:38Z

Added glossary link to Application~

← Older revision		Revision as of 14:51, 22 February 2012
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 ~~applications~~, however. The instructions that follow from Minto Tsai will likely allow it.		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/		http://opensourcevista.net:8888/NancysVistAServer/VistALinkFiles/
Line 10:		Line 10:

	==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 24:		Line 24:

	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 100:		Line 100:
	User's Access/Verify Code must use capital letters		User's Access/Verify Code must use capital letters

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

	11. Installing VistALink sample application files		11. Installing VistALink sample [[application~\|Application]] files
	unzip XOB_1_5.ZIP		unzip XOB_1_5.ZIP
	cd vlj-1.5.0.026/samples/J2SE		cd vlj-1.5.0.026/samples/J2SE
Line 122:		Line 122:
	'''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'''

Anthracite: /* Setup VistALink 1.5 */

2011-09-05T15:13:14Z

Setup VistALink 1.5

← Older revision		Revision as of 15:13, 5 September 2011
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 applications, 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:==

JohnLeoZ: /* Setup Steps: */

2007-07-16T04:37:42Z

Setup Steps:

← Older revision		Revision as of 04:37, 16 July 2007
Line 48:		Line 48:
	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 68:
	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
	~~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		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
	cd vlj-1.5.0.026/samples/J2SE		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)'''		'''copy VistALink libraries (under vlj-1.5.0.026/jars dir)'''
Line 110:		Line 116:
	'''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 ==

JohnLeoZ: /* Environment: */

2007-07-16T04:31:58Z

Environment:

← Older revision		Revision as of 04:31, 16 July 2007
Line 18:		Line 18:
	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 applications to execute Remote Procedure Calls (RPC) on the VistA/M server.

Line 29:		Line 29:
	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>
			Do you want to see the Descriptions? NO// <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
	-------------------------------------------------------------------------------		-------------------------------------------------------------------------------
	VERSION: 1.5 OCT 08, 2006 SCHLEHUBER,CAMERON		VERSION: 1.5 OCT 08, 2006 SCHLEHUBER,CAMERON

			1 NOV 06, 2006@15:11:19 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)
	Save original ^XOB* routines (See ReadMe.txt from Sea Island Systems', see references below)		GTM> D ^%RO <enter>
	GTM> D ^%RO <enter>		Routine: ^XOB* <enter>
	Routine: ^XOB* <enter>		Routine: <enter>
	Routine: <enter>		Output device: <terminal>: /tmp/xob_orig.ro <enter>
	Output device: <terminal>: /tmp/xob_orig.ro <enter>		Header Label: <enter>
	Header Label: <enter>		String comments <No>?: <enter>
	String comments <No>?: <enter>		4. Restore modified routines from xobv-gtm.ro (download from Sea Island Systems', see references below)
	Restore modified routines from xobv-gtm.ro (download from Sea Island Systems', see references below)		GTM> D ^%RI <enter>
	GTM> D ^%RI <enter>		Formfeed delimited <No>? <enter>
	Formfeed delimited <No>? <enter>		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		Verify modified routines installed
	GTM> ZLINK "XOBVTCPL" WRITE $TEXT(+5^XOBVTCPL) <enter>		GTM> ZLINK "XOBVTCPL" WRITE $TEXT(+5^XOBVTCPL) <enter>
Line 91:		Line 95:
	unzip XOB_1_5.ZIP		unzip XOB_1_5.ZIP
	cd vlj-1.5.0.026/samples/J2SE		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)'''
	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 107:
	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 ==

			'''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

JohnLeoZ at 04:16, 16 July 2007

2007-07-16T04:16:13Z

New page

== 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

<nowiki>Setup Steps:
Install VistA Office EHR SemiViva 2.3.1
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></nowiki>
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
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>
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
^%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
Telnet test to listener
telnet localhost 8001
you should connect if the listener is up
Create a user (or use existing user)
User's Access/Verify Code must use capital letters
Grant Kernel Access to Sample Application
In User Edit, for Primary/Secondary Menu Options, assign “XOBV VISTALINK TESTER”
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 - [http://www.va.gov/vdl/application.asp?appid=163]

Vistapedia Documentation (see item 14)- [http://www.vistapedia.org/~forum/index.php?title=Installation_How_To_VistA_GT.M_Ubuntu_Linux]

Sea Island Systems' modified VistALink routines - [http://www.seaislandsystems.com/Downloads/VistALink/]