VistA RPC - Revision history

DavidWhitten: /* Protocol Definition */

2012-02-14T00:43:50Z

Protocol Definition

← Older revision		Revision as of 00:43, 14 February 2012
Line 5:		Line 5:
	The protocol definition is still to be found in detail,		The protocol definition is still to be found in detail,
	but the RPC Standard Header and Message Parameters are documented at: [[Broker msg specs]]		but the RPC Standard Header and Message Parameters are documented at: [[Broker msg specs]]
			A Microsoft word document with the same information is available at:
			http://mirrors.medsphere.org/pub/downloads.va.gov/files/FOIA/Software/VistA_FOIA_Historical_Files/VISTA_FOIA_RELEASES_BEFORE_2008/XWB-RPC%20Broker/PROGRAMS/broker%20msg%20specs.doc

	== Delphi Implementation ==		== Delphi Implementation ==

DavidWhitten: /* Protocol Definition */

2012-02-14T00:41:24Z

Protocol Definition

← Older revision		Revision as of 00:41, 14 February 2012
Line 4:		Line 4:

	The protocol definition is still to be found in detail,		The protocol definition is still to be found in detail,
	but the RPC Standard Header and Message Parameters are documented at:		but the RPC Standard Header and Message Parameters are documented at: [[Broker msg specs]]
	[~~ftp://ftp.va.gov/vista/Software/Packages/RPC%20Broker%20-%20XWB/PROGRAMS/broker%20msg%20specs.doc broker~~ msg specs~~.doc~~]

	== Delphi Implementation ==		== Delphi Implementation ==

DavidWhitten at 12:55, 18 October 2011

2011-10-18T12:55:40Z

← Older revision		Revision as of 12:55, 18 October 2011
Line 11:		Line 11:
	The Delphi Components and Published Property and Methods are documented at:		The Delphi Components and Published Property and Methods are documented at:

	[~~[Image~~:7A62E804d01.pdf\|RPC Broker: Getting Started]]		[http://vistapedia.net/images/7/78/7A62E804d01.pdf \|RPC Broker: Getting Started]

DavidWhitten at 12:54, 18 October 2011

2011-10-18T12:54:01Z

← Older revision		Revision as of 12:54, 18 October 2011
Line 14:		Line 14:


	CPRS is written in delphi and relies on a delphi library to make VistA RPC calls. This library is documented in [http://~~www~~.~~va.gov~~/vdl/~~documents~~/Infrastructure/Remote_Proc_Call_Broker_(RPC)/xwb1_1p40pm.pdf RPC BROKER: Getting Started with the Broker Development Kit (BDK)] which you can download from the VA.		CPRS is written in delphi and relies on a delphi library to make VistA RPC calls. This library is documented in [http://vistainstitute.com/vdl/VistA_Lib/Infrastructure/Remote_Proc_Call_Broker_(RPC)/xwb1_1p40pm.pdf RPC BROKER: Getting Started with the Broker Development Kit (BDK)] which you can download from the VA.

	=== Return types ===		=== Return types ===

Ssw0213: fix Getting Started link by uploading the pdf as a local image

2010-10-07T17:06:18Z

fix Getting Started link by uploading the pdf as a local image

← Older revision		Revision as of 17:06, 7 October 2010
Line 7:		Line 7:
	[ftp://ftp.va.gov/vista/Software/Packages/RPC%20Broker%20-%20XWB/PROGRAMS/broker%20msg%20specs.doc broker msg specs.doc]		[ftp://ftp.va.gov/vista/Software/Packages/RPC%20Broker%20-%20XWB/PROGRAMS/broker%20msg%20specs.doc broker msg specs.doc]

	== Delphi ~~Implemetation~~ ==		== Delphi Implementation ==

	The Delphi Components and Published Property and Methods are documented at:		The Delphi Components and Published Property and Methods are documented at:

	[~~ftp~~:~~//ftp~~.~~va.gov/vista/Software/Packages/~~RPC~~%20Broker%20-%20XWB/PROGRAMS/broker%20msg%20specs.doc broker msg specs.doc~~]		[[Image:7A62E804d01.pdf\|RPC Broker: Getting Started]]

Ftrotter: added port info

2007-06-26T00:18:55Z

added port info

← Older revision		Revision as of 00:18, 26 June 2007
Line 65:		Line 65:

	== M2M Broker Implementation ==		== M2M Broker Implementation ==

			== TCP/IP information ==

			If you are trying to access VistA from behind a firewall you might have some problems, here is a complete description of what those problems might be and some troubleshooting tips.

			Like FTP VistA RPC is a multiple port protocol. There are two stages in the VistA RPC protocol

			* CPRS -> VistA. source port is random. Destination port is whatever VistA is configured to listen to usually in the 9211 range. The system will attempt to login with the most modern VistA RPC implementation which is marked by the '[XWB]' in the protocol. Failing that the system will increase the source port by one and attempt to connect using the older version of the protocol which begins with '{XWB}'
			* VistA -> CPRS After receiving the initial connection, VistA will attempt to call the client back. VistA will choose a random port? in the low range i.e. 1250 and attempt to connect to the CPRS client machine on the original CPRS sourceport +1. So if CPRS originally contacted VistA from 1586, then VistA will try to call back to destination port 1587. If VistA cannot get through to the client it will try and change its source port. So it will try 1250 first, then 1251 then 1252 and so on.

			The "callback" nature of the RPC protocol is a problem for a NAT environment. For instance when a network is hidden behind a single IP address, the outgoing connection to VistA from inside the network is understood by the NAT device. The "callback" is the problem without some mechanism to associate the the callback to the original connection the NAT device does not know which host on the NATed network to send the new traffic to. However, the callbacks do enable a certain amount of implicit security. Because the RPC protocol is a "single packet" protocol, it is particularly vulnerable to spoofing. Apparently there is a setting within VistA to force "same-port" operation.

			== Links ==

			University of Kuopio in Finland has written an RAD tool making use of the delphoi RPCBroker system called [http://www.uku.fi/tike/fixit/english.html FixIT]. [http://www.hardhats.org/cs/fixIT/fixITmain.html HardHats has some FixIT information]

DavidWhitten at 17:11, 21 June 2007

2007-06-21T17:11:23Z

← Older revision		Revision as of 17:11, 21 June 2007
Line 62:		Line 62:

	no idea.		no idea.


			== M2M Broker Implementation ==

DavidWhitten at 17:09, 21 June 2007

2007-06-21T17:09:44Z

← Older revision		Revision as of 17:09, 21 June 2007
Line 2:		Line 2:

	== Protocol Definition ==		== Protocol Definition ==
	~~The protocol definition is found in [ftp://ftp.va.gov/vista/Software/Packages/RPC%20Broker%20-%20XWB/PROGRAMS/broker%20msg%20specs.doc broker msg specs.doc]~~

	~~Thank God~~.		The protocol definition is still to be found in detail,
			but the RPC Standard Header and Message Parameters are documented at:
			[ftp://ftp.va.gov/vista/Software/Packages/RPC%20Broker%20-%20XWB/PROGRAMS/broker%20msg%20specs.doc broker msg specs.doc]

	== Delphi Implemetation ==		== Delphi Implemetation ==

			The Delphi Components and Published Property and Methods are documented at:

			[ftp://ftp.va.gov/vista/Software/Packages/RPC%20Broker%20-%20XWB/PROGRAMS/broker%20msg%20specs.doc broker msg specs.doc]


	CPRS is written in delphi and relies on a delphi library to make VistA RPC calls. This library is documented in [http://www.va.gov/vdl/documents/Infrastructure/Remote_Proc_Call_Broker_(RPC)/xwb1_1p40pm.pdf RPC BROKER: Getting Started with the Broker Development Kit (BDK)] which you can download from the VA.		CPRS is written in delphi and relies on a delphi library to make VistA RPC calls. This library is documented in [http://www.va.gov/vdl/documents/Infrastructure/Remote_Proc_Call_Broker_(RPC)/xwb1_1p40pm.pdf RPC BROKER: Getting Started with the Broker Development Kit (BDK)] which you can download from the VA.

DavidWhitten at 17:04, 21 June 2007

2007-06-21T17:04:37Z

← Older revision		Revision as of 17:04, 21 June 2007
Line 1:		Line 1:
	VistA RPC is a VA developed protocol that allows for remote procedure calls against VistA. Most famously, CPRS uses the RPC mechanism as its primary communication method.		VistA RPC is a VA developed protocol that allows for [[Remote Procedure Calls~\|remote procedure calls]] against VistA. Most famously, CPRS uses the RPC mechanism as its primary communication method.

	== Protocol Definition ==		== Protocol Definition ==

Ftrotter: found the specs :)

2007-06-21T09:58:56Z

found the specs :)

← Older revision		Revision as of 09:58, 21 June 2007
Line 1:		Line 1:
	VistA RPC is a VA developed protocol that allows for remote procedure calls against VistA. Most famously, CPRS uses the RPC mechanism as its primary communication method.		VistA RPC is a VA developed protocol that allows for remote procedure calls against VistA. Most famously, CPRS uses the RPC mechanism as its primary communication method.

			== Protocol Definition ==
			The protocol definition is found in [ftp://ftp.va.gov/vista/Software/Packages/RPC%20Broker%20-%20XWB/PROGRAMS/broker%20msg%20specs.doc broker msg specs.doc]

			Thank God.

	== Delphi Implemetation ==		== Delphi Implemetation ==