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

PUT_SERVERCLASS_DIALOG_BEGIN_(3) OSS Library Calls Reference Manual
• 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. |
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent |
compiler command option.
• Compile the application using the -Wlp64 compiler command option. |
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll). |
NOTES
The messagebuffer 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 specified, an error value 233 (FEScError) is returned;
PUT_SERVERCLASS_SEND_INFO_( ) reports Pathsend error 912 (FEScParameterBoundsEr-
ror).
The message buffer is modified 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 PUT_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 file-system error numbers:
0 (zero) The PUT_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 PUT_SERVERCLASS_SEND_INFO_( ) function to get
detailed information about this error.
ERRORS
This function does not set errno.
5−100 Hewlett-Packard Company 527187-017