8.9.4 unload文(アンロードデータファイルの情報の記述)
アンロードデータファイルの情報を指定します。
- <適用基準>
-
-k rorg,-k unld,及び-k reldの場合は,必ず指定してください。
- <規則>
-
unload文は,次の数だけ指定できます。
- 【HiRDB/シングルサーバの場合】
-
再編成の単位(表,又はRDエリア)に関係なく,unload文は一つだけ指定してください。
- 【HiRDB/パラレルサーバの場合】
-
横分割表を表単位に再編成する場合,unload文は表を格納したRDエリアがあるサーバ数分指定してください。
横分割表をRDエリア単位に再編成する場合,又は分割していない表の再編成の場合には,unload文は一つだけ指定してください。また,-gオプションを指定して一つのアンロードデータファイルにアンロードする場合にも,unload文は一つだけ指定してください。
(1) 形式
unload {〔{サーバ名:|ホスト名:}〕 アンロードデータファイル名〔,アンロードデータファイル名〕… |(uoc)} 〔{EasyMT情報|HiRDBファイル情報}〕 〔uoc情報〕
(2) 説明
(a) サーバ名
〜<識別子>((1〜8))
アンロードデータファイルを作成するサーバの名称を指定します。
- 【HiRDB/シングルサーバの場合】
-
HiRDB/シングルサーバの場合は指定しないでください。
- 【HiRDB/パラレルサーバの場合】
-
-
-gオプション指定なし
横分割表の表単位の再編成の場合,再編成する表を格納したRDエリアがあるサーバごとにサーバ名を指定してください。
横分割表のRDエリア単位の再編成,分割していない表の再編成,又はディクショナリ表の再編成の場合,サーバ名を指定する必要はありません。このとき,アンロードデータファイルは表を格納したRDエリアがあるサーバから出力されます。
-
-gオプション指定あり
-gオプションを指定して,一つのアンロードデータファイルにアンロードする場合には,アンロードデータファイルを作成するサーバ名を指定してください。
-
(b) ホスト名
〜<識別子>((1〜32))
アンロードデータファイルを作成するホストの名称を指定します。
- 【HiRDB/シングルサーバの場合】
-
アンロードデータファイルをユティリティ専用ユニットへ作成する場合は,そのホスト名を指定してください。
省略した場合,アンロードデータファイルはシングルサーバのあるユニットに作成されます。
- 【HiRDB/パラレルサーバの場合】
-
HiRDB/パラレルサーバの場合は,指定しないでください。
(c) アンロードデータファイル名
〜<パス名>
アンロードデータファイルの名称を絶対パス名で指定します。
アンロードデータファイルとして,次に示すファイルを使用できます。
-
通常ファイル
OSが提供するファイルシステム領域に作成できます。この場合,事前の準備は不要です。
-
キャラクタ型スペシャルファイル
pdfmkfsコマンドで作成したユティリティ用のHiRDBファイルシステム領域に作成してください。
-fオプションでアンロードデータファイル種別を指定した場合は,次のように指定してください。
- アンロードデータファイルがEasyMTの場合:
-
アンロードデータファイルは二つまで指定できます。
また,MTguideを使用する場合は,MTguideが管理する装置記号名,又は装置グループ名も指定できます。
- アンロードデータファイルがHiRDBファイルの場合:
-
-
アンロードデータファイル名は,167文字以内で指定してください。
-
HiRDBファイルを使用するには,あらかじめpdfmkfsコマンドで,HiRDBファイルシステム領域を作成しておく必要があります。この場合,-kオプションの使用目的にはUTLを指定してください。
-
pdfmkfsコマンドで,-k UTL以外を指定して作成したHiRDBファイルシステム領域上に作成したHiRDBファイルを指定した場合は,エラーとなります。
-
指定したアンロードデータファイル名がHiRDBファイルシステム領域上にない場合,HiRDBが新規にアンロードデータファイルを作成します。既存のアンロードデータファイル名を指定した場合は,上書きされます。
-
<アンロードデータファイルに関する注意事項>
-
-W bin -wオプションを指定して出力した表移行用アンロードファイルは,一つだけ指定できます。
-
表のデータが一つのアンロードデータファイルに入りきらない場合は,複数のファイルを指定できます。
-
アンロードデータファイルを複数指定する場合,次のことに注意してください。
-
NFSファイルは使用できません。
-
EasyMTを使用しないで直接テープ装置は使用できません。
また,次のようにファイル属性は同一である必要があります。
-
EasyMTの場合
すべてEMTVOL_EL(EasyMTラベル付きボリューム)として初期化しておく必要があります。
-
HiRDBファイルの場合
通常ファイルとキャラクタ型スペシャルファイルの混在はできません。必ずどちらかに統一してください。
-
(d) (uoc)
UOCを利用した再編成をする場合,UOC側でUOCデータファイルを作成する場合(pdrorg側ではアンロードデータファイルを出力しない場合)に指定します。
(uoc)は,-k unldの場合にだけ指定できます。また,(uoc)を指定した場合は,EasyMT情報及びHiRDBファイル情報は指定できません。
(e) EasyMT情報
〔file=ファイル名〕
〔{,vol=ボリューム名|,vol=(ボリューム名〔,ボリューム名〕…)}〕
〔,bufno=バッファ面数〕
〔,fileno={ファイル順序番号|ADD}〕
アンロードデータファイルがEasyMTの場合に指定します。
ファイル名,及びボリューム名を指定すると,ファイル,及びボリュームの名称が,ここで指定した名称と一致しているかどうかチェックできます。ファイル名,及びボリューム名のチェックをしない場合には,省略できます。
ファイル名を省略する場合は,先頭になった項目のコンマ(,)は指定しないでください。
- file=ファイル名 〜<英数字>((1〜17))
-
ファイルの名称を指定します。
- {,vol=ボリューム名|,vol=(ボリューム名〔,ボリューム名〕…)}
-
〜<英数字>((1〜6))
ファイルのボリューム名を指定します。ボリューム名は1行で記述できる範囲で255個まで指定できます。
- bufno=バッファ面数 〜<符号なし整数>((1〜256))《10》
-
EasyMTで使用するバッファの面数を指定します。
- fileno={ファイル順序番号|ADD}
-
MT内のアンロードデータファイルの作成位置を指定します。
- ファイル順序番号 〜<符号なし整数>((1〜199))《1》
-
-k rorg,又は-k unldの場合は,指定した位置にファイルを作成します。このとき,指定した位置以降のファイルは削除されます。
-k reldの場合は,指定した位置のファイルを読み込みます(filenoを省略した場合,次のファイルを読み込みます)。
- ADD
-
-k rorg,又は-k unldの場合は,ボリュームの最後にファイルを作成します。
-k reldの場合,ADDは指定できません。
(f) HiRDBファイル情報
〔init={初期割り当て領域サイズ
|(初期割り当て領域サイズ〔,初期割り当て領域サイズ〕…)}〕
〔,incr={増分割り当て領域サイズ
|(増分割り当て領域サイズ〔,増分割り当て領域サイズ〕…)}
アンロードデータファイルがHiRDBファイルの場合に指定します。HiRDBファイル情報は,必ず1行で指定してください。
initの指定を省略した場合,incrの前のコンマ(,)は指定しないでください。
- init={初期割り当て領域サイズ|(初期割り当て領域サイズ〔,初期割り当て領域サイズ〕…)}
-
〜<符号なし整数>((1〜1048574))《100》
HiRDBファイルへの書き込み時に割り当てる容量をメガバイト単位で指定します。
- <見積もり式>
-
初期割り当て領域サイズの計算方法については,マニュアル「HiRDB Version 9 システム導入・設計ガイド」のデータベース再編成ユティリティ(pdrorg)実行時のファイルの容量を参照してアンロードデータファイルのバイト数を求め,次の式で計算してください。
初期割り当て領域サイズ =↑(アンロードデータファイルのバイト数+1024)÷(1024×1024)↑ (単位:メガバイト)
- <規則>
-
-
初期割り当てサイズは,pdfmkfsコマンドでHiRDBファイルシステム領域作成時,-nオプションで指定した値より小さくなければなりません(システムが管理用に使用する領域が必要なため)。
-
pdfmkfsコマンドに-eオプションを指定しなかったり,-eオプションに0を指定したりすると,増分割り当てができないので,必ず指定してください。
-
どの程度の大きさの初期割り当てサイズが使用できるかは,pdfstatfsコマンドで確認してください。
-
割り当て領域サイズの指定は,unload文で指定したファイル名の数分指定します。両者に不一致があった場合,次のように解釈します。
関係
動作
ファイル数<指定
ファイル数分,指定を有効にして後は無視します。
ファイル数=指定
ファイルごとに指定を有効にします。
ファイル数>指定
指定の最後の領域サイズを足りない指定分繰り返します。
-
- incr={増分割り当て領域サイズ|(増分割り当て領域サイズ〔,増分割り当て領域サイズ〕…)}
-
〜<符号なし整数>((1〜1048574))《10》
HiRDBファイル書き込み時に,初期割り当て領域サイズで容量が不足した場合,拡張する割り当て領域の大きさを指定します。
次の場合にはHiRDBファイルの拡張ができません。
-
該当するHiRDBファイルシステム領域の増分回数指定を超えて拡張しようとしたとき
-
該当するHiRDBファイルが,個々のHiRDBファイルの増分回数の上限(23回固定)を超えて拡張しようとしたとき
したがって,実際の容量が見積もり容量を超える場合は,上記2項目の制限に掛からないように,増分割り当てサイズを指定する必要があります。増分割り当てサイズの制限を次の図に示します。図中のnの値は,上記2項目の制限を超えないようにしてください。
図8‒22 増分割り当てサイズの制限(unload文) HiRDBファイルシステム領域の増分回数は,新規にHiRDBファイルシステムを作成する場合,pdfmkfsコマンドの-eオプション指定で設定します。また,既存のHiRDBファイルシステム領域の状態を見る場合,pdfstatfsコマンドの出力結果の「available expand count」の値によって参照できます。
-
(g) UOC情報
〔uoc_lib=ライブラリ名称〔param='ユーザパラメタ'〕
UOC情報は,UOCを利用して再編成をする場合に指定してください。unlduoc文を指定する場合には,必ずUOC情報も指定してください(指定しないとエラーとなります)。
- uoc_lib=ライブラリ名称
-
〜<パス名>
UOCを格納している共用ライブラリの名称を,絶対パス名で指定します。
- param='ユーザパラメタ'
-
〜<文字列>((1〜1023))
UOCにパラメタを渡したい場合に,その内容をユーザパラメタに指定します(ユーザはUOCに対して,コマンドラインなどで直接パラメタを渡せないため)。
ここに指定した内容は,UOCインタフェース領域を介して,指定した内容のままUOCに渡されます。なお,ユーザパラメタに指定する文字列には,空白及びタブは指定できません。