The ENABLE-ONLINE-COPY statement enables the online backup capability for all realms of the database.
This statement is also permitted for a shadow database.
The online backup capability for a database cannot be enabled for an original unless the AFIM logging function is active or the START-LOG statement is issued beforehand. Since a consistent database is a prerequisite for the START-LOG statement, an UPDATE-DATABASE statement may also be required.
To create online backups of databases or individual realms, you should use the corresponding HSMS or ARCHIVE statements.
When COPY-FILE is used to generate an online copy, the system does not check whether all requirements for "online backup capability" are fulfilled for the database concerned. In this case you must ensure that AFIM logging is enabled so that the online copy can be made consistent later by applying the changes.
It is never permissible to generate online copies while modifying utility routines are running.
The online backup capability of a database is recorded both in the UDS/SQL administration data and in the DMS catalog entries for the database files. When a database is copied either with COPY-FILE or with HSMS/ARCHIVE, the specifications relating to the online backup capability in the DMS catalog may be lost depending on the selected parameters.
Therefore, before using a copy of a database from an original for which the online backup capability was active, you must ensure that this property remains consistent, for example by running the BMEND utility routine again with the statement ENABLE-ONLINE-COPY.
ENABLE-ONLINE-COPY |
This statement has no operands.