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

PUT_SERVERCLASS_DIALOG_SEND_(3) OSS Library Calls Reference Manual
actualreplybytes
(Optional) If provided, returns the number of bytes returned in the server process
reply and stored in the area pointed to by messagebuffer.
scsoperationnumber
(Optional) If provided, returns the value -1. This parameter is provided only for
compatibility with the Guardian SERVERCLASS_DIALOG_SEND_ procedure.
DESCRIPTION
This function is used to send a message within the specified 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_SEND_ procedure, which is described in the NonStop
TS/MP Pathsend and Server Programming Manual.
This function differs from the Guardian SERVERCLASS_DIALOG_SEND_ procedure in that it |
provides only a waited (to the thread) interface. Three optional parameters (flags, scsoperation- |
number, and tag) are used to specify nowait operations. These parameters should usually be |
omitted.
The flags parameter, if provided, must be 0 (zero). If a value other than zero is provided, the
operation fails with an error value of 233 (FEScError).
PUT_SERVERCLASS_SEND_INFO_( ) reports Pathsend error 909 (FEScInvalid-FlagsValue)
and file-system error 29 (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, the pthread_cancel( ) function 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 CANCEL 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 func-
tion returns with an error value of 233 (FEScError); PUT_SERVERCLASS_SEND_INFO_( )
reports Pathsend error 918 (FEScSend-OperationAborted) and Guardian file-system error 40.
To use this function on systems running J06.10 or later RVUs or H06.21 or later RVUs, you must
perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library.
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use |
this function with 32-bit or 64-bit applications.
To use this function in a 32-bit application on systems running H06.24 or later RVUs or J06.13 or |
later RVUs, perform the same tasks (described above) used to enable the function on systems |
running H06.21/J06.10 or later RVUs.
To use this function in a 64-bit application on systems running H06.24 or later RVUs or J06.13 or |
later RVUs, you must perform all of the following tasks:
• Include the pthread.h header file in the application. |
5−108 Hewlett-Packard Company 527187-017