TS/MP Pathsend and Server Programming Manual (G06.24+, H06.03+)

Pathsend Procedure Call Reference
NonStop TS/MP Pathsend and Server Programming Manual–132500
5-24
Calls Within a TMF Transaction
•
SERVERCLASS_SEND_, SERVERCLASS_DIALOG_BEGIN_, and
SERVERCLASS_DIALOG_SEND_ return the server-class send operation number
in the scsend-op-num parameter. See Server-Class Send Operation Number
later in this section for more information about the server-class send operation
number.
For an example of issuing a nowait call to SERVERCLASS_SEND_, see the Pathsend
program example BREQ, Example B-1
on page B-2. In this TAL program, the
procedure Initiate^IO initiates a nowait SERVERCLASS_SEND_ call.
Calls Within a TMF Transaction
The following considerations apply when calling Pathsend procedures during a TMF
transaction:
•
If SERVERCLASS_SEND_, SERVERCLASS_DIALOG_BEGIN_, or
SERVERCLASS_DIALOG_SEND_ is called during a TMF transaction, the
transaction identifier is propagated to the server process in the same way as it is in
all interprocess communication (for example, calls to the WRITEREAD procedure).
As an application developer, you do not have to be concerned about the role of the
LINKMON process in the propagation of transaction identifiers.
•
For context-sensitive server-class send operations, two types of TMF protection are
available, depending on the setting of bit 14 in the flags parameter on the call to
SERVERCLASS_DIALOG_BEGIN_. For details, refer to the discussion of
context-sensitive requesters in Section 3, Writing Pathsend Requesters.
•
If a send is made to a server class that is configured with the TMF parameter set to
OFF while there is a currently active transaction identifier, the send is completed
with return error 233 (FEScError), Pathsend error 917
(FEScServerClassTmfViolation), and file-system error 0 (FEOK). See the
NonStop TS/MP System Management Manual for details about the TMF parameter
of the SET SERVER command.
Server-Class Send Operation Number
The server-class send operation number is returned in the scsend-op-num parameter
on the first successfully initiated nowait server-class send operation (through a call to
SERVERCLASS_SEND_, SERVERCLASS_DIALOG_BEGIN_, or
SERVERCLASS_DIALOG_SEND). The same value is returned on every subsequent
nowait send that is initiated successfully.
You can use the server-class send operation number in the following calls:
•
In calls to AWAITIOX to wait for completion of any SERVERCLASS_SEND_,
SERVERCLASS_DIALOG_BEGIN_, or SERVERCLASS_DIALOG_SEND_
operation
•
In calls to CANCEL and CANCELREQ to cancel an outstanding
SERVERCLASS_SEND_, SERVERCLASS_DIALOG_BEGIN_, or
SERVERCLASS_DIALOG_SEND_ operation
•
In calls to FILEINFO