Previous Topic: LINK (Link to the CXX)Next Topic: How to Use

LINK (Link to the CXX) › When to Use

When to Use

intend to copy a data areaUse the LINK function to link each index area and each data area in one database to a CXX without performing the INIT function. This would only be appropriate if you rename the CXX or copy a data area using a utility other than DBUTLTY to move data from one CXX to another.

If you intend to copy a data area data set from one CXX to another using a utility other than DBUTLTY to backup/load the data area, it is still necessary to do the following:

  1. If the receiving CXX data area is set as not loaded, then you need to first use DBUTLTY to INIT and null load the area to a scratch data set to get the area to a loaded status in the receiving CXX.
  2. Next, use CXXMAINT OPTION=ALTER.DBID=?.AREA=?.DSN=? to update the data set name to the name you want.
  3. Then use the non-DBUTLTY utility to copy the data to the new name.
  4. Follow the sequence above by doing the DBUTLTY LINK.
  5. Use DBUTLTY RETIX to index the area data that was copied.

The LINK function opens tables in all areas of the specified database. Use this function only when all areas have been initialized and the data areas loaded.

The Accounting Facility tables must all be defined as closed during a MUF enable before the LINK function can perform properly. After enabling the MUF, you can perform the LINK function for the Accounting Facility PRM and data area database(s) and then open the desired tables.

You cannot use the LINK function to fix the Compound Boolean Selection Index Area. You must use the INIT function for the Compound Boolean Selection Index Area. See the CA Datacom/DB Database and System Administration Guide for more information.

With Simplify mode, the function can be executed in a DBUTLTY step with the MUF not enabled, for example immediately after a CXX is initialized with a different name and loaded from a backup. If MUF is enabled as is required without Simplify, the other rules apply about databases not being opened before the LINK is executed.

Each area of the database is attempted to be opened, and if the open is successful the LINK performs the action. For each individual area that cannot be opened and read, the action does not occur. A report then reports each area, the actions taken, and any error encountered.