RSC/MP 7.2 Programming Manual

API Functions and Options
HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004
3-2
API Options
API Options
Option parameters let you customize these API function calls:
•
RscBeginSession
•
RscConnect
•
RscWrite
•
RscWriteRead
Customizing Functions Using Options
API functions are customized by setting options. Each function that you can customize
has an options handle parameter, which refers to an options structure that is internal to
RSC/MP. An options structure contains option values that are referred to by their
corresponding option selectors. For example, PATHMON_NAME is an option selector
(see Appendix D, API Option Definitions, for a complete list). An option selector and its
value are referred to collectively as an option. You should create and set options
before making calls to the corresponding function.
You must create an options structure by using the RscCreateOptions function call.
Options structures are subsequently referred to by the options handle returned from
the RscCreateOptions function.
To set individual options programmatically, use the RscSetOption function call. To load
a set of options from an existing disk file, use the RscLoadOptions function call.
Error
Processing
RscErrorInfo [RSCERI] Obtains the description of an error
returned from an RSC/MP function.
Unsolicited
Messages
RscNotifySem [RSCSEM]
RscNotifyThread [RSCNOTH]
RscNotifyWin [RSCNOT]
RscUmsCheck [RSCUCHK]
RscUmsReply [RSCUREP]
Receives and replies to unsolicited
messages sent to an RSC/MP
application.
Data
Formatting
RscSwapShort [RSCSI]
RscSwapLong [RSCSL]
Reverses the byte order of data.
Time RscTime [RSCTIM]
Retrieves the current time from the host.
Multithreaded
Application
Support
RscRegisterThread
[RSCRTHD]
RscUnregisterThread
[RSCUTHD]
Registers and unregisters a thread with
the RSC/MP API library.
Table 3-1. Functions Listed by Group (page 2 of 2)
Functional
Group
C Language Function Name
[Name in Other Languages] Usage