[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
FN_EOJ()
EndOfJob
------------------------------------------------------------------------------
Syntax
fn_EOJ( [ <lProcesses> ] ) -> NIL
Arguments
<lProcesses> is a logical indicating whether the EOJ applies to
all processes on the workstation (.T.) or to the current process
only. If omitted the default is .F..
Returns
Nothing. Any errors can be detected with fn_error().
Description
This function cause an EndOfJob (EOJ) command to be sent to the
file server and causes the shell to reset all internal tables for
the application. The EOJ at the file server releases all resources
(open files, file and record locks, logical locks, semaphores, etc.)
allocated on the file server to the current task.
A program may issue this call whenever the need arises to reset the
network environment to a beginning-of-program state with no files
or records logged or locked. After issuing this call, a station
must not use any files without first reopening, relogging and
relocking them.
NOTE: The shell automatically generates the same EOJ action when
an application terminates, and control returns to COMMAND.COM
(all resources allocated to all tasks on the workstation are
released, same as setting <lProcesses> == .T.).
Examples
/* close all active files, locks and network resources */
fn_EOJ( .T. )
Source: N:\SRC\CONNWS\EOJ.PRG
Author: Steve Larsen
See Also:
fn_setEOJ()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson