|
Dieses Gerät hat auch andere Anweisungen:
Anleitung Zusammenfassung
NonStop DCE Jacket Functions
SERVERCLASS_DIALOG_SEND_
Figure C-4. DCE_SERVERCLASS_DIALOG_SEND_(3) Reference
Page (page 2 of 3)
Output
message_buffer
On successful completion of the send operation, it contains the reply from the server
process.
actual_reply_len
(Optional) Contains the number of bytes returned in the server process reply.
sc_send_opnum
(Optional) Returns the server class send operation number. Note that the operation
number has no relevance in this case as it has been completed and is returned only for
compatibility with the Guardian SERVERCLASS_DIALOG_SEND_ procedure. A value of
-1 is returned for nowait send that are not initiated successfully.
DESCRIPTION
This function sends the message within the dialog to the server process in the Pathway server
class. This procedure performs an I/O operation. The parameters and semantics of this function are
the same as those of the Guardian SERVERCLASS_DIALOG_SEND_ procedure, which is
described in the TS/MP Pathsend and Server Programming Manual.
The flags parameter, if provided, must be 0 (zero). If a value other than the above mentioned value
is provided, the operation fails with an error value of 233 (FEScError).
DCE_SERVERCLASS_SEND_INFO_() will show Pathsend error 909 (FEScInvalidFlagsValue) and
File system error 2 (FEInvalOp).
The thread is suspended for the duration of the send operation. Other threads in the process are
scheduled to run. The timeout parameter can be used to specify that the send be canceled after a
specified interval. Alternatively, pthread_cancel() can be used (by another thread) to cancel the
send operation in progress in a thread. The cancel exception generated by pthread_cancel() can
be subsequently handled by the thread. As with the CANCELREQ and
SERVERCLASS_DIALOG_SEND_ Guardian procedures, the program cannot determine whether
the canceled message was sent or canceled before the server process finished processing
the request. If the send is canceled because of expiration of the timeout parameter, then the
function returns with an error value of 233 (FEScError); DCE_SERVERCLASS_SEND_INFO_() will
show Pathsend error 918 (FEScSendOperationAborted) and Guardian file-system error 40
(FETimedOut).
The message_buffer parameter should refer to static or heap-allocated storage. Also, it is possible to
pass the same input pointer to the call because the input pointer (parameter to the RPC call) is in the
heap storage. Also, since Native DCE threads follow the static model, thread stacks (including
thread stack variables) reside in the heap. When the RPC parameter (input) is passed to the function
and output is received in the same buffer, there is no effect on the input parameter because it refers
to the same heap storage before and after the thread switch. But the application writer needs to
ensure that enough heap storage is available to receive the output from the function. This will NOT
be detected by the threads runtime.
RETURN VALUES
The function returns the following Guardian file-system error numbers:
0 (zero) (FEOK)
The DCE_SERVERCLASS_DIALOG_SEND_( ) operation completed successfully.
HP NonStop DCE Application Programming Guide — 429551-003
C -13
...Dieses Handbuch ist für folgende Modelle:
PC Desktops - HP Integrity NonStop J-Series (499.14 kb)
PC Desktops - HP NonStop G-Series (499.14 kb)
PC Desktops - HP NonStop L-Series (499.14 kb)