The following instructions apply to installing all interfaces. These instructions do not presume that the interface is running on the same platform as PI is. They should be performed before installing the interface.
-
Test the connection to the gateway using the test programs as described in the Communication Testing Programs section (p. 23).
-
Define a point source as specified in the Point Source (PI2 only) section (p. 9).
-
Define tags with the specifications as described in the Tag Definition section (p. 11)
-
Define digital states as specified in the Digital States section (p. 9).
-
If the interface is running on a PI API node, define a proxy account for the machine the interface is running on (PI3 only). See the PI Data Archive manual for details.
-
When the PI2 system is shutdown, the points coming into the system should receive shutdown events. Modify the argument list for the program ShutdownEvents, which is executed from files ShutdownEvents.com and CheckForCrash.Com.
-
If the interface is running on a PI API node, set the ‘Shutdown’ field to OFF (0) for ALL of the tags defined for this interface (PI3 only).
-
Define an IORATE tag, e.g. SYYGWPSY (VAX and NT only) as described in the Event Counter Tags section (p. 6).
-
Stop and restart the IORates process (PI2 only).
VMS Installation
The following OBJ files are provided for building the interface and the associated test programs:
-
YGW_FUNC.OBJ
|
YGW_FMT.OBJ
|
YGI_COMMON.OLB
|
YGI_UNIINT.OBJ
|
YGI_TEST.OBJ
|
YGI_TESTB.OBJ
|
Ygw_Setup.com
This command file will copy all the necessary files to their appropriate places in PIBuild: and PISysExe:. It takes one argument which specifies the point source to set up certain files with. This is done so that each point source has a unique startup command file and unique initialisation files. The files Ygw__.com, YGW_OItem__.com and YGW_Msg__.com are copied to Ygw_#.com, YGW_OItem_#.com and YGW_Msg_#.com, where # is the point source. If these files already exist on the PI disk they will not be written over.
PIBuild:Link_Ygw.com
These link the object files to form the following executables:
Ygw_Int.exe
Ygi_Test.exe
Ygi_TestB.exe
PISysExe:Ygi_Setterm.com
This file sets up the serial port for TTY communication. It should be executed before starting the interface and supply a point source as a command line argument. Edit this file if you want to change the communication rate, parity or communication code.
PISysExe:Ygi_UnsetTerm.com
This file resets the serial port to its default state. Specify a port number when executing it.
PISysExe:Ygw_Detach.com
This file starts the interface as a detached process of PI. It checks a condition before and interface startup. The point source must be passed as a parameter to specify which PISysExe:Ygw_#.com file to execute. The name of the created process is YGW_INT_#.
The enclosed tape contains the backup save set Ygw_Int.bck which contains the interface. This saveset contains new object files. If the interface is being installed at the same time as PI, change the default directory to PIBuild: and proceed straight to step 6.
-
Unpack the saveset to a “safe” directory.
-
Go to the safe directory
-
Mount the tape by:
mount/over=id tape0:
or whatever the name of your tape drive is.
-
Copy the saveset from the tape to the safe directory by:
copy tape0:*.* *.*
-
Unpack the saveset by:
backup/verify/log ygw_int.bck/sav *.*
-
Execute the Ygw_Setup.com command file by:
@YGW_SETUP_#
where # is the point source to be used for the interface. This command file copies the necessary files from the default directory to PIBuild: and then adds the point source to certain files before copying them to PISysExe: directory.
If more than one copy of the interface will be running, execute this command once from PIBuild: for each additional interface substituting for # with a different point source for each.
-
Change the default directory to PIBuild: and link the interface by:
@Ygw_Link
The executables Ygw_Int.exe, Ygw_Test.exe and Ygw_TestB.exe will then get copied to PiSysExe:.
-
Complete the point database configuration as specified in this document.
-
Modify a copy of PiSysExe:Ygw_#.com for each interface point source.
-
Verify the Yokogawa Gateway operations as described in this document.
-
Start the interface by executing the command file
@PiSysExe:Ygw_Detach #
passing it the interface point source #.
This executes the command file PiSysExe:Ygw_#.com and creates a detached process called YGW_INT_#.
-
Verify that the interface version number in Ygi_#.out matches the version shown on the tape containing the interface.
Stopping the Interface
You can stop the interface by executing the command file
@PiSysExe:Stop Ygi_Int_#
where # is the point source for the interface.
Share with your friends: |