Demo Program

Overview

Build the Demo program

Run the Demo program

Overview

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:

  1. 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.

  1. 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.

  1. 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

  1. 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.

More information

Alarm Viewer API getting started.