Copyright © Cloud Software Group, Inc. All rights reserved.
Copyright © Cloud Software Group, Inc. All rights reserved.


Chapter 1 Introduction : The TIBCO iProcess User Validation API Sample Application

The TIBCO iProcess User Validation API Sample Application
The SDK for the TIBCO iProcess User Validation API provides a sample application that supports all of the UVAPI interfaces. The package is supplied as a single module (swuvamod.c) with the swuvapi.h header file and a makefile.
The user database for the example is a text file (exuvapi.dat) which defines the iProcess users, their descriptions and passwords. There is one entry per line with fields separated by the \ character. The example text file needs to be located in your SWDIR\util directory.
Build Instructions
The following sections describe how to build the UVAPI example application and test application.
UNIX Platforms
To build the example UVAPI package and test utility, enter the following command in the directory where your files are located:
make -f uvapiunx.mak
This produces the following files:
uvapi.so (the UVAPI package as a shared library)
tstuvapi (the test utility executable).
The build environment requires modifications for different UNIX platforms. The uvapiunx.mak makefile contains a section that sets up the environment for the target platform. Edit this section as appropriate for your target platform. Examples for Solaris and AIX are given as comments in the makefile.
To run the test utility, the UVAPI package must be locatable as a shared library (LD_LIBRARY_PATH environment variable on Solaris, LIBPATH environment variable on AIX). For the example UVAPI package, the SWDIR environment variable must also be set, and the file SWDIR/util/exuvapi.dat must exist (see the UVAPI developers documentation for details of the example UVAPI package).
The test utility only calls the Initialisation and Termination interfaces in the UVAPI package as all other interfaces require iProcess encrypted strings to be passed in or returned.
Windows Platforms
To build the example UVAPI package and test utility, set up the environment for the Microsoft Visual Studio V6 C compiler and enter the following command:
nmake -f uvapiw32.mak
This produces the following files:
uvapi.dll (the UVAPI package as a Dynamic Link Library)
tstuvapi.exe (the test utility executable).
To run the test utility, the UVAPI package must be locatable as a DLL (on the PATH or in the current directory). For the example UVAPI package, the tstuvapi.exe utility and uvapi.dll components must be located in the util sub-directory of an iProcess installation. The file SWDIR\util\exuvapi.dat must exist.
The test utility only calls the Initialisation and Termination interfaces in the UVAPI package as all other interfaces require iProcess encrypted strings to be passed in or returned.
 

Copyright © Cloud Software Group, Inc. All rights reserved.
Copyright © Cloud Software Group, Inc. All rights reserved.