Open System Services System Calls Reference Manual (G06.25+, H06.03+)

System Functions (s and S) SPT_SERVERCLASS_DIALOG_BEGIN_(3)

NOTES

The message_buffer parameter should refer to static or heap-allocated storage. It should not be

automatic storage and should not be stack-allocated storage for a TNS process. If stack-allocated

storage for a TNS process is speciﬁed, an error value 233 (FEScError) is returned;

SPT_SERVERCLASS_SEND_INFO_()

reports Pathsend error 912 (FEScParameterBoundsEr-

ror).

The message buffer is modiﬁed by the server reply. Therefore, the same buffer area should not

be used concurrently by more than one thread. The threads package does not check for this con-

dition; it is the responsibility of the programmer who is using threads.

Multiple SPT_SERVERCLASS_DIALOG_BEGIN_()

operations can be in progress in

different threads within a process. The maximum number of concurrent calls is determined by

the number of threads and the Pathsend limit of 512 for each LINKMON.

RETURN VALUES

Possible return values are the following Guardian ﬁle-system error numbers:

0 (zero) The SPT_SERVERCLASS_DIALOG_BEGIN_()

operation completed suc-

cessfully.

70 (FEContinue)

The server is ready for the next message in the dialog.

233 (FEScError)

You can call the SPT_SERVERCLASS_SEND_INFO_() function to get

detailed information about this error.

ERRORS

This function does not set errno.

RELATED INFORMATION

Functions: SPT_SERVERCLASS_DIALOG_ABORT_(3),

SPT_SERVERCLASS_DIALOG_END_(3), SPT_SERVERCLASS_DIALOG_SEND_(3),

SPT_SERVERCLASS_SEND_INFO_(3).

527186-003 Hewlett-Packard Company 7−189