RPC HELP TSharedRPCBroker - Revision history

Kdtop at 17:32, 8 July 2015

2015-07-08T17:32:41Z

← Older revision		Revision as of 17:32, 8 July 2015
Line 14:		Line 14:
	The TSharedRPCBroker component is derived from the existing [[RPC_HELP_TRPCBroker\|TRPCBroker]] component. The TSharedRPCBroker component provides applications or plug-ins to applications easy access to an RPCBroker without the need for a separate M partition. Each component has its own security (i.e., option) as well. The default value of the [[RPC_HELP_TSharedRPCBroker_AllowShared_Property\|AllowShared]] is True. If an application will have RPCs that require extensive time, it would be best to NOT share a Broker instance and the [[RPC_HELP_TSharedRPCBroker_AllowShared_Property\|AllowShared]] should then be set to False.		The TSharedRPCBroker component is derived from the existing [[RPC_HELP_TRPCBroker\|TRPCBroker]] component. The TSharedRPCBroker component provides applications or plug-ins to applications easy access to an RPCBroker without the need for a separate M partition. Each component has its own security (i.e., option) as well. The default value of the [[RPC_HELP_TSharedRPCBroker_AllowShared_Property\|AllowShared]] is True. If an application will have RPCs that require extensive time, it would be best to NOT share a Broker instance and the [[RPC_HELP_TSharedRPCBroker_AllowShared_Property\|AllowShared]] should then be set to False.

	For its functionality, the TSharedRPCBroker component uses the RPCSharedBrokerSessionMgr.EXE, which is an out of process Common Object Module (COM) component. This executable handles the actual Broker connections and communication, permitting multiple applications to use a single connection and partition to the VistA M Server. However, it also handles connections of different applications to different Server/Port combinations and can handle multiple connections to a specific Server/Port combination, if an application sets [[~~RPC_HELP_AllowShared~~\|AllowShared]] to False.		For its functionality, the TSharedRPCBroker component uses the RPCSharedBrokerSessionMgr.EXE, which is an out of process Common Object Module (COM) component. This executable handles the actual Broker connections and communication, permitting multiple applications to use a single connection and partition to the VistA M Server. However, it also handles connections of different applications to different Server/Port combinations and can handle multiple connections to a specific Server/Port combination, if an application sets [[RPC_HELP_TSharedRPCBroker_AllowShared_Property\|AllowShared]] to False.

	Like the [[RPC_HELP_TRPCBroker\|TRPCBroker]], the TSharedRPCBroker component and RPCSharedBrokerSessionMgr executable provide VistA application developers with all of the client/server-related functionality in one integrated component. Using the TSharedRPCBroker component, an application can connect to the VistA M Server by simply setting the [[RPC_HELP_TRPCBroker_Connected\|Connected]] property to True. Remote procedures on the server can be executed by preparing the [[RPC_HELP_TRPCBroker_Param\|Param]] and [[RPC_HELP_TRPCBroker_RemoteProcedure\|RemoteProcedure]] properties and invoking either the [[RPC_HELP_TRPCBroker_Call_Method_Example\|Example]], [[RPC_HELP_TRPCBroker_strCall_Method_Example\|Example]] or [[RPC_HELP_TRPCBroker_lstCall_Method_Example\|Example]] methods.		Like the [[RPC_HELP_TRPCBroker\|TRPCBroker]], the TSharedRPCBroker component and RPCSharedBrokerSessionMgr executable provide VistA application developers with all of the client/server-related functionality in one integrated component. Using the TSharedRPCBroker component, an application can connect to the VistA M Server by simply setting the [[RPC_HELP_TRPCBroker_Connected\|Connected]] property to True. Remote procedures on the server can be executed by preparing the [[RPC_HELP_TRPCBroker_Param\|Param]] and [[RPC_HELP_TRPCBroker_RemoteProcedure\|RemoteProcedure]] properties and invoking either the [[RPC_HELP_TRPCBroker_Call_Method_Example\|Example]], [[RPC_HELP_TRPCBroker_strCall_Method_Example\|Example]] or [[RPC_HELP_TRPCBroker_lstCall_Method_Example\|Example]] methods.

Kdtop at 17:31, 8 July 2015

2015-07-08T17:31:52Z

← Older revision		Revision as of 17:31, 8 July 2015
Line 5:		Line 5:
	[[RPC_HELP_TSharedRPCBroker_Example\|Example]]		[[RPC_HELP_TSharedRPCBroker_Example\|Example]]

	<h3>Parent Class<h3>		<h3>Parent Class</h3>
	TSharedRPCBroker = class(TComponent)		TSharedRPCBroker = class(TComponent)

Kdtop at 17:24, 8 July 2015

2015-07-08T17:24:30Z

← Older revision		Revision as of 17:24, 8 July 2015
Line 12:		Line 12:

	<h3>Description</h3>		<h3>Description</h3>
	The TSharedRPCBroker component is derived from the existing [[RPC_HELP_TRPCBroker\|TRPCBroker]] component. The TSharedRPCBroker component provides applications or plug-ins to applications easy access to an RPCBroker without the need for a separate M partition. Each component has its own security (i.e., option) as well. The default value of the [[~~RPC_HELP_AllowShared~~\|AllowShared]] is True. If an application will have RPCs that require extensive time, it would be best to NOT share a Broker instance and the [[~~RPC_HELP_AllowShared~~\|AllowShared]] should then be set to False.		The TSharedRPCBroker component is derived from the existing [[RPC_HELP_TRPCBroker\|TRPCBroker]] component. The TSharedRPCBroker component provides applications or plug-ins to applications easy access to an RPCBroker without the need for a separate M partition. Each component has its own security (i.e., option) as well. The default value of the [[RPC_HELP_TSharedRPCBroker_AllowShared_Property\|AllowShared]] is True. If an application will have RPCs that require extensive time, it would be best to NOT share a Broker instance and the [[RPC_HELP_TSharedRPCBroker_AllowShared_Property\|AllowShared]] should then be set to False.

	For its functionality, the TSharedRPCBroker component uses the RPCSharedBrokerSessionMgr.EXE, which is an out of process Common Object Module (COM) component. This executable handles the actual Broker connections and communication, permitting multiple applications to use a single connection and partition to the VistA M Server. However, it also handles connections of different applications to different Server/Port combinations and can handle multiple connections to a specific Server/Port combination, if an application sets [[RPC_HELP_AllowShared\|AllowShared]] to False.		For its functionality, the TSharedRPCBroker component uses the RPCSharedBrokerSessionMgr.EXE, which is an out of process Common Object Module (COM) component. This executable handles the actual Broker connections and communication, permitting multiple applications to use a single connection and partition to the VistA M Server. However, it also handles connections of different applications to different Server/Port combinations and can handle multiple connections to a specific Server/Port combination, if an application sets [[RPC_HELP_AllowShared\|AllowShared]] to False.

Kdtop: Created page with " RPC Broker Help Home

TSharedRPCBroker Component

Properties [[RPC_HELP_TSharedRPCBroker_Example|Example]..."

2015-07-08T17:13:22Z

Created page with " RPC Broker Help Home <h2>TSharedRPCBroker Component</h2> Properties [[RPC_HELP_TSharedRPCBroker_Example|Example]..."

New page

[[RPC_Broker_Help| RPC Broker Help Home]]
<h2>TSharedRPCBroker Component</h2>
[[RPC_HELP_TSharedRPCBroker_Properties|Properties]]

[[RPC_HELP_TSharedRPCBroker_Example|Example]]

<h3>Parent Class<h3>
TSharedRPCBroker = class(TComponent)

<h3>Unit</h3>
[[RPC_HELP_TRPCB_Unit|TRPCB Unit]]

<h3>Description</h3>
The TSharedRPCBroker component is derived from the existing [[RPC_HELP_TRPCBroker|TRPCBroker]] component. The TSharedRPCBroker component provides applications or plug-ins to applications easy access to an RPCBroker without the need for a separate M partition. Each component has its own security (i.e., option) as well. The default value of the [[RPC_HELP_AllowShared|AllowShared]] is True. If an application will have RPCs that require extensive time, it would be best to NOT share a Broker instance and the [[RPC_HELP_AllowShared|AllowShared]] should then be set to False.

For its functionality, the TSharedRPCBroker component uses the RPCSharedBrokerSessionMgr.EXE, which is an out of process Common Object Module (COM) component. This executable handles the actual Broker connections and communication, permitting multiple applications to use a single connection and partition to the VistA M Server. However, it also handles connections of different applications to different Server/Port combinations and can handle multiple connections to a specific Server/Port combination, if an application sets [[RPC_HELP_AllowShared|AllowShared]] to False.

Like the [[RPC_HELP_TRPCBroker|TRPCBroker]], the TSharedRPCBroker component and RPCSharedBrokerSessionMgr executable provide VistA application developers with all of the client/server-related functionality in one integrated component. Using the TSharedRPCBroker component, an application can connect to the VistA M Server by simply setting the [[RPC_HELP_TRPCBroker_Connected|Connected]] property to True. Remote procedures on the server can be executed by preparing the [[RPC_HELP_TRPCBroker_Param|Param]] and [[RPC_HELP_TRPCBroker_RemoteProcedure|RemoteProcedure]] properties and invoking either the [[RPC_HELP_TRPCBroker_Call_Method_Example|Example]], [[RPC_HELP_TRPCBroker_strCall_Method_Example|Example]] or [[RPC_HELP_TRPCBroker_lstCall_Method_Example|Example]] methods.

<h3>Using the TSharedRPCBroker Component</h3>
To use the TSharedRPCBroker component in place of the TRPCBroker component with an existing application, do the following:
# Open the application.
# Notate the current name assigned to the TRPCBroker component.
# Remove the TRPCBroker component.
# Add the TSharedRPCBroker component and give it the same name that was used for the TRPCBroker component (see Step #2).
# If you do not have any other components (e.g., FileMan Delphi Components) that reference the original TRPCBroker component (see Step #2), simply recompile and run the application. Otherwise, proceed to Step #6.
# If you have components (e.g., FMLister, FMGets, etc.) that reference the original TRPCBroker component, do the following:
#* Click on the component(s).
#* Select the new TSharedRPCBroker component at the TRPCBroker reference for this component in the object inspector. The assignment isn't by name but to the actual component instance or location in memory at the time, and this has to be reset.
#* Repeat Steps #6a-6b for each additional component
#* Recompile and run the application.

NOTE: Application developers must remember to include the RPCSharedBrokerSessionMGR.EXE when building their applications.

When the first application connects, you will see an instance of the RPCSharedBrokerSessionMgr appear in the taskbar. All Broker connections via the TSharedRPCBroker component are routed through this executable.

NOTE: For help on inherited properties, please see the parent component (i.e., [[RPC_HELP_TRPCBroker|TRPCBroker]]).