RSC/MP 7.2 Programming Manual

API Function Descriptions
HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004
10-43
RscWriteRead [RSCWR]
RscWriteRead [RSCWR]
The RscWriteRead function issues a WRITEREAD I/O request to a server process on
the NonStop host. The request is issued on the session identified by ulSessionHandle
and can be issued as a waited or nowaited I/O request. 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 issued a waited I/O request, control returns to the application when the receiving
process replies to the WRITEREAD request. The maximum size of the reply must be
specified by the contents of puReplySize. The reply is copied to the storage location
indicated by pvReplyBuffer, and puReplySize is updated with the actual number of
characters in the reply.
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 meanings.
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.
Note. If a nowaited I/O request is issued, pvReplyBuffer and puReplySize must be NULL.
USHORT RscWriteRead
(ULONG ulOptionsHandle /* in */
,ULONG ulConnectionHandle /* in */
,ULONG ulSessionHandle /* in */
,CHAR *pcServerName /* in */
,SHORT nIoHandle /* in */
,VOID *pvRequestBuffer /* in */
,USHORT uWriteSize /* in */
,VOID *pvReplyBuffer /* out */
,USHORT *puReplySize /* in / out */
);