Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

SPT_SERVERCLASS_DIALOG_BEGIN_(3) OSS Library Calls Reference Manual
flags (Optional) If specified, this parameter must contain 0 (zero) for a single TMF
transaction per dialog or 2 for multiple TMF transactions per dialog. This flag
value (0 or 2) also indicates that this operation is always waited. This parameter
is provided for compatibility with the Guardian
SERVERCLASS_DIALOG_BEGIN_ procedure.
tag (Optional) If specified, this parameter is ignored. This parameter is provided for
compatibility with the Guardian SERVERCLASS_DIALOG_BEGIN_ pro-
cedure.
Output
dialogId Contains the identifier returned on successful completion of this call that can be
used on subsequent operations on this dialog.
message_buffer
On successful completion of the send, contains the reply returned by the server
process.
actual_reply_len
(Optional) If specified, returns the number of bytes returned in the server pro-
cess reply and stored in the area pointed to by message_buffer.
scsend_op_num
(Optional) If specified, returns the value -1. This parameter is provided only for
compatibility with the Guardian SERVERCLASS_DIALOG_BEGIN_ pro-
cedure.
DESCRIPTION
This function is used to initiate the dialog and send the first message of the dialog to the server
instance in the Pathway serverclass. The parameters and semantics of this function are the same
as those of the Guardian SERVERCLASS_DIALOG_BEGIN_ procedure, which is described in
the NonStop TS/MP Pathsend and Server Programming Manual.
This function differs from the Guardian SERVERCLASS_DIALOG_BEGIN_ procedure in that
it provides only a waited (to the thread) interface. Three optional parameters (flags, scsend-op-
num, and tag) are used to specify nowait operations. These parameters should usually be omit-
ted.
The flags parameter, if provided, must be 0 (zero) or 2. If a value other than zero or two is pro-
vided, the operation fails with an error value of 233 (FEScError).
STP_SERVERCLASS_SEND_INFO_( ) reports Pathsend error 909 (FEScInvalid-FlagsValue)
and file-system error 29 (FEInvalOp).
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 send be canceled after a
specified interval. Alternatively, the pthread_cancel( ) function 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 CANCEL and
SERVERCLASS_DIALOG_BEGIN_ Guardian procedures, the program cannot determine
whether the canceled message was sent or canceled before the server process finished processing
the request. If the begin is canceled because of expiration of the timeout parameter, then the
function returns with an error value of 233 (FEScError);
SPT_SERVERCLASS_SEND_INFO_( ) reports Pathsend error 918 (FEScSend-
OperationAborted) and Guardian file-system error 40.
6−96 Hewlett-Packard Company 527187-017