Begin Service of Processes

This Subprogram sets the Main Application Program into a default configuration whereby it can act as a Process Server. This Subprogram may be used as the basis of a more flexible Process Server than is possible with UI_INIT_SERVICE_PROCESSES etc.

Short Name Calling Sequence

STATUS = UIBSPC([READRQ])

Long Name Calling Sequence

STATUS = UI_BEGIN_SERVICE_PROCESSES(...)

Input Arguments \ READRQ (Logical) Read Request Flag (Optional)

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

Note:

1. This Subprogram must be called prior to calls to UI_SERVICE_PROCESSES and UI_END_SERVICE_PROCESSES.
2. This Subprogram sets the Application Program into a standard Server Configuration having no FORTRAN scroll region etc.
3. This Subprogram sets up an AST Handler for the Server Program such that subsequent requests by Client Processes for input or output will result in a call to SYS$WAKE to wake the Server process. The Server should then call UI_SERVICE_PROCESSES to service the I/O request.
4. The READRQ Argument is optional and, if present, may be used to determine whether Read Requests from the currently Client Process are serviced or not. If READRQ is omitted or set .TRUE. then the detection of a Read Request by the currently connected Client will cause the Server (see UI_SERVICE_PROCESSES) to issue an Asynchronous Input Request to the physical keyboard with the same prompt as issued by the Client. Setting READRQ to .FALSE. will cause the Server to only update the screen image with Output Requests from the Clients and not Input Requests.