! STEXPro.alt - Installing the STEX Pro API on a 469D.  07-June-2011 JWR
!
! Installation Instructions:
!
! PC Setup
! --------
!    Place this package folder in the project subfolder.
!    i.e. demo469D\STEXPro
!
!    Open a command prompt window and change to the package directory.
!    From the command prompt type:
!
!	STEX469DTestServer /regserver
!
!    You should see a text box pop up telling you that the installation
!    was successful.
!
!    Add a line to the hosts file in Windows\System32\drivers\etc
!    similar to this:
!
!	127.0.0.1             msp-rosenowj-l3                    # 469D
!
!    Replace the label 'msp-rosenowj-l3' with your machine name and replace
!    the 127.0.0.1 with your network IP address.
!    The machine name and network IP address is available at the command prompt
!    via this command:
!
!	ipconfig /all
!
! Application Modifications
! -------------------------
!
! AppGui Folder
!
! 0) Copy these new files to AppGui.
	RpcFile.alt		-> AppGui\RpcFile.alt
	RpcFileRecorder.alt	-> AppGui\RpcFileRecorder.alt
		NOTE: RpcFileRecorder is a subclass of Recorder and Recorder
		method init has a two different signatures based on the vintage
		of code.  Older code has 3 parameters, new has 4, you must match
		the super.init[] parameter list to the expectation of the superclass
		Recorder.
	RpcApi.alt		-> AppGui\RpcApi.alt

! 1) Replace (or merge) these files with those in this package.
	FilePlayer.alt		-> AppGui\FilePlayer.alt
	Nodes\Link.alt		-> AppGui\Link.alt
	Nodes\Node.alt		-> AppGui\Node.alt
	Nodes\RemoteThing.alt	-> AppGui\RemoteThing.alt
	Nodes\ResultArrays.alt	-> AppGui\ResultArrays.alt

! 2) Add these lines to file AppGui\aadefine.alt if not already there.
	! create node to remote applications

	INCLUDE 'ResultArrays.alt'
	INCLUDE 'RemoteThing.alt'
	INCLUDE 'Link.alt'
	INCLUDE 'Node.alt'

	Node.is[1]	! 1 is this program; must be 0-15.


! 2.1) Replace Api.alt and its instantation with rpcApi in AppGui\aadefine.alt

	! Include the RPC classes

	INCLUDE 'RpcFile.alt'
		NOTE: New FilePlayer.alt depends on this class so this line
		must be included before FilePlayer.
	INCLUDE 'RpcFileRecorder.alt'
		NOTE: RpcFileRecoder depends on Recorder so it must be defined
		after class Recorder.
	INCLUDE 'RpcApi.alt'

	VAR	rpcApi := RpcApi.new.init

! 3) Add instance variable rpcrec and access method to AppGui\VirtualMachine.alt. e.g.:

	METHOD rpcrec IS
	BEGIN
		RETURN rpcrec
	END METHOD

! 4) Create the RPC data recorder, note the use of the monitor filters 'monfil'.
     find the instantation and setup of rec and make a copy of that block,
     rename rec to rpcrec as below
	! create RPC file data recorder
	rpcrec	:= RpcFileRecorder.new.init[self, 'rpcrec', nRec, 'monfil']
				.setName['RPC Data Recorder']
				.initSize[recBufferSize]
				.addSamplePeriods[recPeriods]
	rpcrec.filterDevice	.initFilters[recFilters]
		NOTE: The addSamplePeriods method may not exist in older code.
		Just remove it in favor of the rate setup usually in line with
		the recorder instantsation.

! 5) Add the following method to MySystem.alt

	METHOD stationName IS
	BEGIN
		RETURN setFileName
	END METHOD

!
! AppCon folder
!
! 5) Add rpc data recorder to vm.c.
! i.e.:
	static objects	rpcrec;					/* data recorder */
	...
	/* create data recorder */
	rpcrec = new(Recorder, seqHi, RECSIZE);
	...
	add(hostLink,	"rpcrec",			rpcrec);