NonStop SQL/MP Reference Manual

Table Of Contents
NonStop SQL/MP Reference Manual142115
U-13
Examples—UPGRADE CATALOG
another process has one of the tables in the catalogs open when you execute
UPGRADE CATALOG. In addition, all indexes, views, and programs registered in
the catalogs must be available for read access.
For performance reasons, SQLCI sometimes keeps catalog files open for five
minutes after the SQLCI command or statement that uses them finishes. This
strategy can interfere with a subsequent UPGRADE CATALOG operation in the
SQLCI session. If such interference occurs, exit SQLCI and start a new SQLCI
session.
Partial failure situations
Unless UPGRADE CATALOG executes within a user-defined transaction, an error
that causes the upgrade of one catalog specified in catalogs to fail does not
necessarily cause the upgrades of other catalogs specified in catalogs to fail.
(Use GET VERSION if you want to check the version of a specific catalog.)
Program invalidation
UPGRADE CATALOG invalidates any program that refers to a catalog table in the
upgraded catalogs, but does not invalidate a program merely because it is registered
in an upgraded catalog or because it accesses objects registered in an upgraded
catalog.
Examples—UPGRADE CATALOG
The following command converts the current default catalog to the same version as
the current NonStop SQL/MP software:
>> UPGRADE CATALOG;
Either of the following commands converts the catalog on subvolume $VOL.SVOL
to version 320:
>> UPGRADE CATALOG $VOL.SVOL TO 320;
>> UPGRADE CATALOG $VOL.SVOL TO A320;
The following command converts all catalogs (except the system catalog) on the
current default node to the same version as the current NonStop SQL/MP software:
>> UPGRADE CATALOGS $*.*;
UPGRADE SYSTEM CATALOG Command
UPGRADE SYSTEM CATALOG is an SQLCI utility command that allows a user with
super ID authority to convert the system catalog on the local node to support a newer
version of NonStop SQL/MP.
TO version
specifies the catalog format version for the upgraded system catalog.
UPGRADE SYSTEM CATALOG [ TO version ] ;