RSC/MP 7.2 Programming Manual

API Function Descriptions

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

10-40

RscWrite [RSCW]

The RscWrite function issues a WRITE I/O request to a server process on the NonStop

host. This function is intended specifically for interprocess sessions to a Guardian

process that does not issue replies; it is unsupported for the IDS session type. The

request is issued on the session identified by ulSessionHandle and can be issued as a

waited or nowaited I/O request. You can use the supplied nIoHandle to complete the

I/O request using the RscIoCheck function. The data referenced by pvWriteBuffer is

written to the receiving server indicated by pcServerName.

If you issue a nowaited I/O request, control is immediately returned to the application,

and the I/O must be completed with a call to the RscIoCheck function. When using

nowaited WriteRead operations, there is a limit of 65530 concurrent (outstanding)

nowaited I/Os for each TERM object.

If you issue a waited I/O request, control returns to the application when the receiving

process reads the data.

ulOptionsHandle

The handle of an existing options handle 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 a list

of options and their meaning.

ulConnectionHandle

The handle of an existing connection created through the RscConnect function

call.

ulSessionHandle

The handle of an existing session created through the RscBeginSession function

call.

USHORT RscWrite

(ULONG ulOptionsHandle /* in */

,ULONG ulConnectionHandle /* in */

,ULONG ulSessionHandle /* in */

,CHAR *pcServerName /* in */

,SHORT nIoHandle /* in */

,VOID *pvWriteBuffer /* in */

,USHORT uWriteSize /* in */

);