DCE Application Programming Guide

NonStop DCE Jacket Functions
HP NonStop DCE Application Programming Guide—429551-003
C-9
SERVERCLASS_DIALOG_BEGIN_
Output
dialog_id
The identifier returned by this call, which must be used on subsequent
operations on this dialog.
message_buffer
On successful completion of the begin operation, the message_buffer con-
tains the reply from the server process.
actual_reply_len
(Optional) Returns a count of the number of bytes returned in the server
process reply.
sc_send_opnum
(Optional) Returns the server class operation number that has already
been completed. 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_BEGIN_ procedure. A value
of - 1 is returned for nowait beginthat are not initiated successfully.
DESCRIPTION
This function initiates the dialog and also sends the first message of the dialog to the server-
process in the Pathway server class. This procedure performs an I/O operation. The parame-
ters and semantics of this function are the same as those of the Guardian
SERVERCLASS_DIALOG_BEGIN_ procedure, which is described in the TS/MP Pathsend
and Server Programming Manual.
The flags parameter, if provided, must be 0 (zero) or 2 (two). If a value other than the above
mentioned values is provided, the operation fails with an error value of 233 (FEScError).
DCE_SERVERCLASS_SEND_INFO_() will show Pathsend error 909 (FEScInvalidFlag
Value) and File system error 2 (FEInvalOp).
If DCE_SERVERCLASS_DIALOG_BEGIN_() is called while the thread has a current
transaction, the transaction identifier is propagated to the server class process. If the begin is
to a server class configured with the TMF parameter OFF, then the begin finishes with return
error 233 (FEScError) and DCE_SERVERCLASS_SEND_INFO_() will show Pathsend
error 917 (FEScServerClassTmfViolation) and Guardian file-system error 0 (FEOK).
The thread is suspended for the duration of the begin operation. Other threads in the process
are scheduled to run. The timeout parameter can be used to specify that the begin be
canceled after a specified interval. Alternatively, pthread_cancel() can be used (by another
thread) to cancel the begin 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_BEGIN_ Guardian procedures, the program
Figure C-3. DCE_SERVERCLASS_DIALOG_BEGIN_(3) Reference
Page (page3of4)