RSC/MP 7.2 Programming Manual

API Function Descriptions

HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004

10-3

RscBeginSession [RSCBGS]

The RscBeginSession function begins a session with the TDP after a connection has

been established. This call creates the context within RSC/MP for matching I/O replies

with requests, for transaction control, and for UMS message routing. Use

RscBeginSession before issuing I/O requests or using the transaction management

facility. If the function is successful, the function places a session handle in the variable

pointed to by pulSessionHandle. Use this handle to refer to the session in all

subsequent I/O requests.

ulOptionsHandle

The handle of an existing options structure created through the RscCreateOptions

function call. Placing RSC_DEFAULT_OPTIONS in this field indicates that the

default options should be used. See Appendix D, API Option Definitions, for

applicable options.

ulConnectionHandle

The handle of an existing connection created through the RscConnect function

call.

uSessionType

The value of this parameter must be set to RSC_ST_IDS or

RSC_ST_INTERPROCESS.

uWaitOption

The value of this parameter must be set to RSC_BEGIN_WAITED.

pulSessionHandle

A pointer to the variable that receives the session handle.

USHORT RscBeginSession

(ULONG ulOptionsHandle /* in */

,ULONG ulConnectionHandle /* in */

,USHORT uSessionType /* in */

,USHORT uWaitOption /* in */

,ULONG *pulSessionHandle /* out */

);