RSC/MP 7.2 Programming Manual

API Functions and Options
HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004
3-3
Using Option Definition Files
There are two ways to manipulate options structures, using the following functions:
Method 1 is easier to program but has limitations related to the way the default options
are shared (see Using Default Options on page 3-4).
Method 2 provides greater control. The application creates an option set which can
then be loaded from disk or filled in programmatically, and which is shared only among
the RSC/MP API functions to which the application provides the same
ulOptionsHandle.
The RscLoadOptions function call reads options from two files:
•
The workstation’s RSC.INI file.
OR
•
The application-specific INI file. See Using Option Definition Files on page 3-3 for
more information.
The application uses an options structure until it calls the RscDestroyOptions function
(see Clearing and Destroying Options on page 3-4).
Using Option Definition Files
An option definition file is a text file that has the extension INI and contains one or
more RSC/MP options that are specific to an application. The options are organized
into sections identified by section names in square brackets, for example
[MYSECTION]. A new section name ends the previous section and begins a new one.
The section named RSC is the default. See the Remote Server Call (RSC/MP)
Installation and Configuration Guide for the sample RSC.INI file provided with RSC/MP
software.
Method 1 Method 2
RscConnect
(RSC_DEFAULT_OPTIONS,
...)
RscCreateOptions (ulOptionsHandle)
RscBeginSession
(RSC_DEFAULT_OPTIONS,
...)
RscLoadOptions (ulOptionsHandle,
"MYRSCAPP.INI", "MYSECTION")
RscConnect (ulOptionsHandle, ...)
RscSetOption (ulOptionsHandle,
"PATHMON_NAME", "$RSCP", NULL )
RscBeginSession (ulOptionsHandle)
...
...
RscDestroyOptions(ulOptionsHandle)