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

ManualsBrandsHP ManualsServerHP NonStop G-Series

1171

OSS Library Calls (s) SPT_SERVERCLASS_DIALOG_BEGINL_(3)

flags (Optional) If speciﬁed, this parameter must contain 0 (zero) for a single TMF

transaction per dialog or 2 for multiple TMF transactions per dialog. This ﬂag

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 speciﬁed, this parameter is ignored. This parameter is provided for

compatibility with the Guardian SERVERCLASS_DIALOG_BEGINL_ pro-

cedure.

Output

dialogid Contains the identiﬁer 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 speciﬁed, returns the number of bytes returned in the server pro-

cess reply and stored in the area pointed to by readbufferL.

scsoperationnumber

(Optional) If speciﬁed, 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 SPT_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 read_bufferL is supported.

• The dialogid, requestbytes, maximumreplybytes, actualreplybytes, and timeout parame-

ters are type long.

• The tag parameter is type long long.

• The Guardian ﬁle-system error 4184 (EVERSION) can be returned.

NOTES

This function is supported on systems running J06.13 and later J-series RVUs and H06.24 and

later H-series RVUs, and must be used instead of the

SPT_SERVERCLASS_DIALOG_BEGIN_( ) function when the messages are larger than 32

kilobytes long. This function can also be used for shorter messages.

RETURN VALUES

See the SPT_SERVERCLASS_DIALOG_BEGIN_(3) reference page.

In addition to the errors listed there, this function can also return this Guardian ﬁle-system error:

4184 (EVERSION)

The function was called from a system that is running a J-series RVU earlier

than J06.13 or an H-series RVU earlier than H06.24.

527187-017 Hewlett-Packard Company 6−99