GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-71
^SERVERCLASS_DIALOG_SEND_
The syntax, condition code settings, and considerations regarding this procedure are the
same as given for the Pathway SERVERCLASS_DIALOG_END_ procedure in the
NonStop TS/MP Pathsend and Server Programming Manual.
^SERVERCLASS_DIALOG_SEND_
The ^SERVERCLASS_DIALOG_SEND_ pseudo context-sensitive Pathway procedure
allows USCODE to communicate directly with server classes in a context-sensitive
manner.
Except for the following considerations, the syntax, condition code settings, and
considerations regarding this procedure are the same as given for the Pathway
SERVERCLASS_DIALOG_SEND_ procedure in the NonStop TS/MP Pathsend and
Server Programming Manual.
Considerations
•
Because the working stack images of tasks are swapped to and from an extended
data segment during I/O operations, the I/O must be performed to and from
extended buffers.
•
When calling the ^SERVERCLASS_DIALOG_SEND_ procedure in the waited
mode, processing is returned to the calling USCODE after a reply is received from
the server. This calling method causes all user tasks to wait until a reply is received.
•
When calling the ^SERVERCLASS_DIALOG_SEND_ procedure in the nowaited
mode with the PROCNOWAIT configuration parameter set to 0, TSCODE calls
^AWAITIOX to complete the I/O, waits for the reply, and then sends the reply to the
user task. Only the user task that called the ^SERVERCLASS_DIALOG_SEND_
procedure waits for the reply. All other user tasks continue processing.
•
When calling the ^SERVERCLASS_DIALOG_SEND_ in the nowaited mode with
the PROCNOWAIT configuration parameter set to 1, USCODE must call
^AWAITIOX instead of ^AWAITIO to complete the I/O. Do not use WAIT^EVENT
and ^LISTEN to complete the I/O.
Calling ^SERVERCLASS_DIALOG_SEND_ in the nowaited mode allows
USCODE to continue processing while ^SERVERCLASS_DIALOG_SEND_ is
executing.
•
A trace record is written before and after a successful call to
^SERVERCLASS_DIALOG_SEND_ if bit 3 of trace^control^flags in DCCBDECS
is set to 1. The trace records contain the calling task number, PATHMON name,
server class name, buffer, server class send operation number and the dialog ID used
with this procedure.
^SERVERCLASS_SEND_
This procedure allows USCODE to communicate directly with NonStop TS/MP server
classes through LINKMON. See Appendix D for an example of using this procedure.