RSC/MP 7.2 Programming Manual

Sample Code Overview
HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004
F-2
C w/GUI Sample
operation, and others. RSCTEST displays a few statistics about performance, but
these are informational only and not suitable for benchmarking purposes.
RSCTEST is delivered as source code and the corresponding pre-built executable. It is
included with every RSC/MP client. On Windows clients, the source code is installed to
the source directory and the executable is installed to the bin directory. On UNIX
clients, both the source code and the executable are installed to the RSC/MP product
installation directory.
For information on using RSCTEST to test RSC/MP product configuration, see the
Remote Server Call (RSC/MP) Installation and Configuration Guide Appendix C.
For general information on compiling and linking C-language RSC/MP client
applications as well as information related to the sample makefile (rsctest.mak), see
Building an Application on page 6-4 and Linking the RSC/MP Libraries on page 6-4.
C w/GUI Sample
The C w/GUI sample is a Windows GUI-based utility which provides the same
functionality that the text-mode equivalent RSCTEST provides; it also serves the same
two purposes (test utility and code sample).
The C w/GUI sample is called RSCTESTW. It presents a basic Windows user interface
through which the user can cause a series of RscWriteRead operations to be run
against an echo server which runs on the NonStop host. The user configures such
parameters as message size, number of messages to be sent, waited/no-wait
operation, and others. RSCTESTW displays a few statistics about performance, but
these are informational only and not suitable for benchmarking purposes.
RSCTESTW is delivered as source code and the corresponding pre-built executable. It
is included with Windows clients only. The source code is installed to the source
directory and the executable is installed to the bin directory within the RSC/MP product
installation directory. Note that a single makefile (rsctest.mak) makes both RSCTEST
and RSCTESTW executables.
For information on using RSCTESTW to test RSC/MP product configuration, see the
Remote Server Call (RSC/MP) Installation and Configuration Guide Appendix C.
For general information on compiling and linking C-language RSC/MP client
applications as well as information related to the sample makefile (rsctest.mak), see
Building an Application on page 6-4 and Linking the RSC/MP Libraries on page 6-4.
Echo Server Sample
The echo server sample serves two purposes. As a test utility, it can be used to verify
correct configuration and operation of the RSC/MP product when used with any of the
client samples whose names start with “RSCTEST”. As a code sample it demonstrates
one way to write a server that can be used through RSC/MP either as a standalone
(named process) server or as a PATHWAY serverclass.