GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-70
^SERVERCLASS_DIALOG_BEGIN_
The syntax, condition code settings, and considerations regarding this procedure are the
same as given for the Pathway SERVERCLASS_DIALOG_ABORT_ procedure in the
NonStop TS/MP Pathsend and Server Programming Manual.
^SERVERCLASS_DIALOG_BEGIN_
The ^SERVERCLASS_DIALOG_BEGIN_ pseudo context-sensitive Pathway procedure
allows USCODE to initiate a dialog with a server process in a server class and to send
the first message to it.
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_BEGIN_ 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_BEGIN_ 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_BEGIN_ 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_BEGIN_
procedure waits for the reply. All other user tasks continue processing.
•
When calling the ^SERVERCLASS_DIALOG_BEGIN_ 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_BEGIN_ in the nowaited mode allows
USCODE to continue processing while ^SERVERCLASS_DIALOG_BEGIN_ is
executing.
•
A trace record is written before and after a successful call to
^SERVERCLASS_DIALOG_BEGIN_ 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_DIALOG_END_
The ^SERVERCLASS_DIALOG_END_ pseudo context-sensitive Pathway procedure
allows USCODE to end a dialog initiated by a previous call to the
^SERVERCLASS_DIALOG_BEGIN_ procedure.