データベース・マネージャーは必要に応じてユーザー出口プログラムを呼び出し、 それにパラメーターの集まりを渡します。 これらのパラメーターのデータ型は、文字ストリングまたは文字です。
呼び出し形式は、次の項目で記述されているように、ご使用の操作環境によって異なります。
次は、OS/2 ユーザー出口プログラムを呼び出す場合のデータベース・マネージャー形式です。
action drive db_alias log_path log_file indicator
RESTORE の場合、このパラメーターには、データベースが復元されるドライブが入ります。
ARCHIVE および RETRIEVE の場合、このパラメーターには、 データベースがあるドライブが入ります。
このパラメーターの形式は、ドライブ文字の後にコロンが続くものです (たとえば C:)。
RESTORE の場合、このパラメーターには、 復元されるファイルのリストとなる応答ファイルの完全修飾名が入ります。 リスト内の各ファイル名は完全修飾名で、ワイルドカードを含めることができます。 ドライブ文字とパスは、 データベース・ファイルがバックアップされたときのソース・ドライブおよびパスです。 たとえば、C:\SQLUTIL\dbname.MH1 が応答ファイルに含まれていれば、 dbname.MH1 ファイルが C:\SQLUTIL からバックアップされたことを意味します。
ARCHIVE および RETRIEVE の場合、 このパラメーターにはログ・パス・ディレクトリーが入ります (たとえば、C:\SQL00001\SQLOGDIR\)。
RESTORE の場合、このパラメーターには、 ファイルが復元されるデータベース・サブディレクトリーのパス名が入ります。 ドライブ文字は含まれません。その理由は、 この文字は drive パラメーターに示されているからです。 形式は、\SQLnnnnn\ です。
ARCHIVE および RETRIEVE の場合、 このパラメーターにはログ・ファイル名が入ります (たとえば、S0000001.LOG)。
ユーザー出口プログラムは、バックアップか復元の操作中に複数回呼び出されます。 最初の呼び出しは、 媒体ヘッダー・ファイル (.MHn ファイル) のバックアップか復元を行い、 2 番目の呼び出しは、データベース・ファイルの集まり全体のバックアップか復元を行います。
ARCHIVE および RETRIEVE の場合、このパラメーターは使用されません。
次に示すのは、データを保存または検索するための、 UNIX ベースまたは Windows NT オペレーティング・システムのユーザー出口プログラムを呼び出すためのデータベース・マネージャー形式です。
db2uext2 -OS<os> -RL<db2rel> -RQ<request> -DB<dbname> -NN<nodenum> -LP<logpath> -LN<logname> -AP<adsmpasswd> -SP<startpage> -LS<logsize>
注: