Overview |
|
Build the Demo program |
|
Run the Demo program |
A sample Microsoft Visual C++ makefile, makefile, is provided to build the sample program. Use this makefile as a basis for constructing makefiles for your own applications.
Note: Depending on how you installed Visual C++, the INCLUDE, LIB, and PATH environment variables may not be automatically set when you install MSDEV. If they are not set, you will have to set them manually or run the following to set them before building any user programs.
\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat
When you run the demo program, it requests class, resource and alarm data from the AMRP, then displays the requested information.
Build the Demo Program
To build the sample program, do the following:
From the CIMPLICITY Configuration Cabinet for your project, select Command Prompt from the Tools menu.
This will ensure that your environment variables (in particular %BSM_ROOT% and %SITE_ROOT%) are set correctly.
In the Command Prompt window, issue the following commands:
cd <drive>
cd %BSM_ROOT%\api\amvtest
Where <drive> is the disk where your CIMPLICITY software is installed.
If the environment variables are not set automatically, issue the following command to set them:
\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat
Now build the executable:
nmake
Run the Demo Program
The API process name must be stored in the PRCNAM environment variable for the program to run. The name is an arbitrary character string of up to 10 characters. To create PRCNAM, enter the following command in the Command Prompt window:
set PRCNAM=<name>
where <name> is the API process name.
To run the sample program, enter the following command in the Command Prompt window:
amvtest
You will be prompted for a project name and asked if you want to run in dynamic mode.
Once a connection to the AMRP has been formed, the test program will print out the Classes and Resources for which alarms will be processed. It will then request a list of current alarms from AMRP and print them out.
If running in dynamic mode, the program will wait for updates from AMRP and print them out as they are received.
To end the sample program, type EXIT and press return.
Alarm Viewer API getting started. |