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

OSS Library Calls (n - r) PUT_SERVERCLASS_DIALOG_BEGINL_(3)
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_BEGINL_ procedure.
tag (Optional) If specified, this parameter is ignored. This parameter is provided for
compatibility with the Guardian SERVERCLASS_DIALOG_BEGINL_ pro-
cedure.
Output
dialogid Contains the identifier returned on successful completion of this call that can be
used on subsequent operations on this dialog.
readbufferL (Optional) On successful completion of the send operation, contains the reply
from the server class. If defaulted, the Guardian write-buffer and PFS buffers
will be used.
actualreplybytes
(Optional) If specified, returns the number of bytes returned in the server pro-
cess reply and stored in the area pointed to by readbufferL.
scsoperationnumber
(Optional) If specified, returns the value -1. This parameter is provided only for
compatibility with the Guardian SERVERCLASS_DIALOG_BEGINL_ pro-
cedure.
DESCRIPTION
This function is the same as the PUT_SERVERCLASS_DIALOG_BEGIN_ function except:
• This function can be used for messages up to 2 megabytes long if
Expand-over-ServerNet is used. (This function is not supported when Expand-over-IP is
used.)
• The optional parameter readbufferL is supported.
• The dialogid, requestbytes, maximumreplybytes, actualreplybytes, and timeout parame-
ters are type int.
• The tag parameter is type long long.
• The Guardian file-system error 4184 (EVERSION) can be returned.
You can use this function with 32-bit applications or 64-bit applications on systems running
H06.24 or later H-series RVUs or J06.13 or later J-series RVUs.
To use this function in a 32-bit application, 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.
To use this function in a 64-bit application, you must perform all of the following tasks:
• Include the pthread.h header file in the application.
527187-017 Hewlett-Packard Company 5−103