Manualshelf

RSC/MP 7.2 Programming Manual

ManualsBrandsHP ManualsServerHP NonStop G-Series
31323334353637383940
API Functions and Options
HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004
3-4
Loading Options
An application can load different sections of the same INI file by using the
RscLoadOptions function (see Loading Options on page 3-4) to change its operation.
For example, one section might be appropriate for deposit transactions and another for
withdrawals.
If options have no preceding section name, they make up the NULL section. When
default options are used, RSC/MP first attempts to load the RSC section. If the RSC
section does not exist, the NULL section is loaded.
Loading Options
Applications can use the RscLoadOptions or RscLoadOptionsEx function to load a
group of options (a section) from a definition file by specifying the appropriate section
name in the pcSection parameter.
Clearing and Destroying Options
The RscClearOption function resets an option to the default defined by RSC/MP. The
RscDestroyOptions function destroys an option structure by releasing the space
allocated to it.
Using Default Options
Instead of using an options handle you created, you can specify that your applications
use a special handle, RSC_DEFAULT_OPTIONS, which refers to an options structure
that is automatically created by RSC/MP and loaded from the RSC.INI file.
For Win-32 applications, the first API call using the RSC_DEFAULT_OPTIONS option
causes RSC/MP to look for the RSC.INI file in the following locations (in the order
specified):
1. The application’s current directory.
2. The root directory of drive C.
3. The directories specified in the PATH environment variable.
4. The root directory of drive A.
For UNIX applications, the first API call using the RSC_DEFAULT_OPTIONS option
causes RSC/MP to look for the RSC.INI file in the following locations (in the order
specified):
1. The application’s current directory.
2. The directories specified in the PATH environment variable.
Note. To avoid unpredictable behavior, you should not use the RscSetOption call with the
special handle RSC_DEFAULT_OPTIONS.