RSC/MP 7.2 Programming Manual

API Function Descriptions
HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004
10-44
RscWriteRead [RSCWR]
pcServerName
A pointer to a NULL-terminated string or blank-padded string containing the name
of the server to which the WRITEREAD I/O request should be issued. This
parameter should point to a character string no longer than the constant
RSC_FILENAME_SIZE (including the terminator) in the RSC.H header file. The
name can be a stand-alone process name (for example, $TDD) or a Pathway
server class (for example, TDDSVR).
nIoHandle
The I/O handle to assign to this I/O request. This parameter determines whether
the I/O is issued as waited or nowaited. If the value of nIoHandle is
RSC_IO_WAITED, a waited I/O request is issued. If the value of nIoHandle is
greater than zero, a nowaited I/O is issued, and the request is tagged with the
supplied nIoHandle. This handle is subsequently used to complete the I/O request
using the RscIoCheck function.
pvRequestBuffer
A pointer to the buffer that contains the data to be written. This parameter should
point to a buffer of size uWriteSize.
uWriteSize
The size of the buffer referenced by pvWriteBuffer. When writing to a named
server, uWriteSize can be no greater than 56000 bytes. When writing to a Pathway
server through Pathsend, uWriteSize has a maximum value of 31000 bytes. When
writing to a Pathway server through the IDS router, uWriteSize can be no larger
than 8192 bytes.
pvReplyBuffer
A pointer to the buffer that receives the reply. This parameter should point to a
buffer of the size stored in the integer pointed to by puReplySize. For nowaited
operations, set pvReplyBuffer to NULL.
puReplySize
On input, this field points to an integer containing the size of the buffer referenced
by pvReplyBuffer. On output, this field points to the actual number of bytes read.
For nowaited operations, set puReplySize to NULL.