Methods, Backup – Echelon OpenLNS User Manual
Page 552
OpenLNS Programmer's Reference
515
•
•
Methods
The
Network object
contains the following methods
.
•
•
•
•
•
•
•
•
•
•
•
Backup
Summary
Make a backup copy of the network database, and exports it
to a specified directory.
The System
object must be open when you invoke this
method. If the System
object is not open, the LCA #67
lcaErrSystemNotOpen exception will be thrown.
You can backup the network database with this method at
any time while the network is open and while clients are
attached to it. However, if a remote Full client accesses the
Networks collection while the database is being backed up,
and that remote Fulll client does not already have open the
network being backed-up, that network will not appear in the
network collection.
In addition, if a remote Full client attempts to open a
network while it is being backed-up, the open may fail,
whereas Local and Lightweight clients will simply wait for
the backup to complete in this case. OpenLNS calls made by
clients already connected to the database when a backup is
initiated may not return until the backup is complete, and
requests to modify the database will be suspended until the
backup is complete.
You should use this method to backup the network database
before validating the database with the Validate method. You
can then archive the backed-up database before performing
any repairs that are discovered by the database validation
procedure.
Availability
Local clients.
Syntax
network.Backup systemPath
Element
Description