jpqdbcond
形式
jpqdbcond [-h 論理ホスト名] [[-m] | [[-x][-k] [-d ディレクトリ名] [-p {出力先}]]| [[{-l|-L} [-a] [[-i {出力先}]| [-t {出力先,未使用領域サイズしきい値} [-v]]]] |[-t {出力先,未使用領域サイズしきい値} [-v]]]]
機能
-
ジョブ実行環境で使用するISAMファイルの未使用領域率が高くなった場合などに,無効領域を圧縮し,ファイルを再編成します。
-
ジョブ実行環境で使用するISAMファイルの未使用領域率や,データファイルフラグメント率および未使用領域サイズを標準出力に出力します。
ISAMファイルの未使用領域率については,ジョブ実行環境でISAMファイルを使用中の場合でも,情報を表示できます。
-
ジョブ実行環境で使用するISAMファイルの次に示す情報を,指定した出力先にメッセージとして出力します。
・再編成時の情報(開始・終了時刻,統計情報)
・未使用領域サイズ
・未使用領域サイズがしきい値に達していた
メッセージの出力先は,次の中から単独で指定することも,幾つか組み合わせて指定することもできます。
・標準エラー出力
・Windowsイベントログまたはsyslog
・JP1イベント
-
ジョブ実行環境で使用するISAMファイルの未使用領域サイズがしきい値に達しているかいないかを,このコマンドの戻り値に設定します。
-
ISAMファイルのフォーマットを変換します。
実行権限
Windowsの場合:Administrators権限
UNIXの場合:スーパーユーザー権限
引数
-h 論理ホスト名
処理対象とする論理ホスト名を指定します。
指定できる文字数は,1〜255(単位:バイト)です。
省略した場合,環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,自ホスト名が仮定されます。
-m
ジョブ実行環境データベースのISAMロックテーブルエントリー数とISAMファイルフォーマット(キー再利用機能が有効か無効か)を出力します。
このオプションは,-hオプション以外のオプションとは同時に指定できません。
-x
ジョブ実行環境で使用するISAMファイルのデータファイルおよびキーファイルを完全に再編成します。
-k
ジョブ実行環境を構成するすべてのISAMファイルをキー再利用機能が有効となるフォーマットに変換すると同時に,データファイルおよびキーファイルを完全に再編成します。
-d ディレクトリ名
ジョブ実行環境で使用するISAMファイルを再編成する場合に,キーソート時に使用するワークファイルのディレクトリ名を指定します。
省略した場合の扱いについては,マニュアル「JP1/Base 運用ガイド」のJiscondコマンドの説明を参照してください。
-p {出力先}
ジョブ実行環境で使用するISAMファイルの再編成開始および終了時にメッセージを出力します。
このオプションは,-xオプションと同時に指定します。
-
出力先
メッセージの出力先を,次の中から指定します。出力先は,単独で指定することも,幾つか組み合わせて指定することもできます。
e:標準エラー出力
s:Windowsイベントログまたはsyslog
j:JP1イベント
このオプションを指定したときの,メッセージの出力例を次に示します。
- (例1)再編成開始時
KAVU5980-I ジョブ実行環境のデータベース再編成を開始しました 20XX/10/01 01:05:40
- (例2)再編成正常終了時
KAVU5981-I ジョブ実行環境のデータベース再編成が正常終了しました 20XX/10/01 01:05:40 - 20XX/10/01 01:20:20 (00:14:40)
開始日時,終了日時,経過時間,実施前後の未使用領域サイズをあわせて出力します。
- (例3)再編成異常終了時
KAVS5982-E ジョブ実行環境のデータベース再編成が異常終了しました 20XX/10/01 01:05:40 - 20XX/10/01 01:20:20 (00:14:40)
{-l|-L}
ジョブ実行環境で使用するISAMファイルの未使用領域率を表示する場合に指定します。
このオプションを,-aオプションと同時に指定した場合,より詳細なISAMファイルの情報を表示します。
-
-l
ISAMファイルを占有して情報を取得します。
このオプションは,ファイルを占有して情報を取得するため,-Lオプションを指定した場合より正確な情報が取得できます。ただし,他プロセスがISAMファイルを使用中の場合は,エラーになります。
-
-L
ISAMファイルを占有しないで情報を取得します。
このオプションは,ファイルを占有しないため,ジョブ実行環境でISAMファイルを使用中でも情報を取得できます。ただし,並行してISAMファイルを更新しているプロセスがある場合,情報取得の瞬間のISAMファイル更新分については誤差が生じます。
-a
ジョブ実行環境で使用するISAMファイルの詳細な情報を出力します。
このオプションは,-lまたは-Lオプションと同時に指定すると,未使用領域率に加え,データファイルフラグメント率と未使用領域サイズを出力します。
-i {出力先}
ジョブ実行環境で使用するISAMファイルの未使用領域サイズをメッセージに出力します。
-
出力先
メッセージの出力先を,次の中から指定します。出力先は,単独で指定することも,幾つか組み合わせて指定することもできます。
e:標準エラー出力
s:Windowsイベントログまたはsyslog
j:JP1イベント
このオプションを指定したときの,メッセージの出力例を次に示します。
- (例)
KAVU5983-I ジョブ実行環境のISAM未使用領域サイズは 99MBです
-t {出力先},未使用領域サイズしきい値
ジョブ実行環境で使用するISAMファイルが,指定した未使用領域サイズしきい値に達していた場合,メッセージを出力します。
このオプションを使用して,ジョブを大量に実行するなどの繁忙期でないときに,JP1/AJS3のジョブとしてjpqdbcondコマンドをスケジュール実行することで,定期的にISAMファイルの状態を確認して,警告メッセージを出力できます。
-
出力先
メッセージの出力先を,次の中から指定します。
出力先は,単独で指定することも,幾つか組み合わせて指定することもできます。
e:標準エラー出力
s:Windowsイベントログまたはsyslog
j:JP1イベント
-
未使用領域サイズしきい値
ISAMファイルの未使用領域サイズしきい値を指定します。
指定できる値は,1〜1024(単位:メガバイト(MB),1MB=1,024×1,024バイト)です。
このオプションを指定したときの,メッセージの出力例を次に示します。
- (例)
KAVU5984-W ジョブ実行環境のISAM未使用領域サイズは101MBで,しきい値(100MB)に達しています
-v
未使用領域率に達していたかいないかを,このコマンドの戻り値(プロセス終了コード)に設定する場合に指定します。
このオプションは,-tオプションと同時に指定します。
このオプションの指定の有無と,jpqdbcondコマンドの戻り値の関係を次に示します。
-
-vオプションを指定しない場合の戻り値
0
正常終了。
0以外の値
異常終了。
-
-vオプションを指定した場合の戻り値
0
未使用領域サイズしきい値に達していない。
1
未使用領域サイズしきい値以上の未使用領域サイズがある。
100以上の値
異常終了。
注意事項
-
該当するファイルをバックアップして保存した上で,再編成を実施してください。jpqdbcondコマンドは,-dオプションで指定したディレクトリを作業ディレクトリとして使用します。-dオプションで指定したディレクトリがあるドライブまたはパーティションには,再編成対象のジョブ実行環境のISAMキーファイルの中で最もサイズが大きいキーファイルの2倍以上の空き容量が必要です。また,ジョブ実行環境データベースディレクトリがあるドライブまたはパーティションには,再編成対象のジョブ実行環境のISAMファイルの中で最もサイズが大きいファイルと同程度の空き容量が必要です。
-dオプションを指定しない場合は,OSの標準的なワークディレクトリを使用します。マニュアル「JP1/Base 運用ガイド」のJiscondコマンドについての説明を参照してください。
-
-x,-t,-l,-L,-k,-mオプションをすべて指定しない場合,-xオプションが仮定されます。
-
このコマンドに-xおよび-kオプションを指定した場合は,実行前(ISAMファイルを再編成する前)に,ファイルのバックアップを必ず取得してください。
-
このコマンドに-x,-lおよび-kオプションを指定した場合,ISAMファイルを閉じている状態で実行してください(ISAMファイルを閉じるには,JP1/AJS3を停止してください)。ファイルが開いている状態でこのコマンドを実行した場合,エラーになります。
-
このコマンドに-Lオプションを指定した場合,他プロセスが使用中のISAMファイルに対しても情報を取得できますが,並行してアクセスする他プロセスがISAMファイルを更新した場合,情報取得の瞬間のISAMファイル更新分については誤差が生じます。また,ISAMファイルの整合性を保つため,コマンド実行中は他プロセスのISAMファイルへのアクセスが待たされます。したがって,このコマンドを使用する場合は,ジョブを大量に実行するなどの繁忙期を避けてください。
-
-l,-Lオプションで出力される情報は,フラグメンテーションの割合ではなく,未使用領域率です。このため,ISAMファイル中にレコードがない場合や,レコードが非常に少ない件数の場合,まだ使用されていない予約済みの空き領域に対する未使用領域率として「100%」と出力されます。
-
ISAMファイルを再編成しても,未使用領域が完全に再編成されないで,多少残る場合があります。
-
このコマンドに-xオプション,または-kオプションを指定して実行する場合,jpqautocondコマンドおよびjajs_maintain -m managerコマンドを同時に実行しないでください。
-
このコマンドの-xオプションおよび-kオプションは同時に指定しないでください。
戻り値
0 |
正常終了。※ |
1 |
使用するISAMファイルに,未使用領域サイズしきい値以上の未使用領域サイズがある。 |
100 |
引数の指定が不適切である。 |
132 |
サブミットジョブ実行環境構成定義ファイルの記述内容が不適切である。 |
135 |
システム資源不足が発生した。 |
137 |
データベース格納ディレクトリがない。 |
138 |
データベースへのアクセス権限がない。 |
140 |
コマンドを実行する権限(Administrators権限(Windowsの場合),またはスーパーユーザー権限(UNIXの場合))がない。 |
141 |
環境設定が不適切である。または,論理ホスト名が不適切である。 |
145 |
メモリー不足が発生した。 |
146 |
ディスク容量不足が発生した。 |
147 |
内部的要因でエラーが発生した。 |
148 |
データベース再編成ISAM処理でエラーが発生した。 |
149 |
データベースのサイズが2ギガバイトを超えているため処理が行えない。 |
226 |
実行環境が不適切である。 |
- 注※
-
-tオプションと-vオプションを同時に指定している場合,ジョブ実行環境で使用するISAMファイルが,未使用領域サイズしきい値に達していないことを示します。
補足事項
-
-lおよび-Lオプション指定時の出力形式を,次に示します。
出力項目を次に示します。
- テーブル名
-
テーブル名称を表示します。
- レコード件数
-
レコード件数を表示します。
- データ
-
データファイルの未使用領域率を表示します。
- キー1
-
一つ目のキーファイルの未使用領域率を表示します。
- キー2
-
二つ目のキーファイルの未使用領域率を表示します。
キーファイルが一つだけの場合は,空白です。
なお,キーファイルが三つ以上の場合はありません。
-
-lおよび-Lオプションと同時に,-aオプションを指定した場合の出力形式を,次に示します。
各テーブルについて,2段で出力されます。上段は,-lオプションおよび-Lオプションと同じです。下段は,それぞれのファイルの未使用領域サイズ(単位:メガバイト(MB),1MB=1,024×1,024バイト)を出力します。
表示項目の説明を次に示します。
- テーブル名
-
テーブル名を表示します。
- レコード件数
-
レコード件数を表示します。
- データ
-
-aオプションを指定した場合は,各テーブルについて2段で出力を行い,上段は,-lまたは-Lオプションを単独で使用した場合と同じ出力です。下段は,未使用領域サイズを出力します。
- フラグメント率
-
可変長レコードでは,レコードを更新すると,ISAMファイル中のデータが,複数のブロックに分かれて格納されることがあります。この項目では,全レコードに対するレコード分割が発生しているレコード件数の割合を出力します。可変長のISAMファイルについてだけ出力し,該当しないテーブルは,「-(ハイフン)」が出力されます。
- キー1
-
-aオプションを指定した場合は,各テーブルについて2段で出力を行い,上段は,-lまたは-Lオプションを単独で使用した場合と同じ出力です。下段は,未使用領域サイズを出力します。
- キー2
-
-aオプションを指定した場合は,各テーブルについて2段で出力を行い,上段は,-lまたは-Lオプションを単独で使用した場合と同じ出力です。下段は,未使用領域サイズを出力します。
- 未使用領域サイズ
-
各ISAMファイルを構成しているデータファイルおよびキーファイルの未使用領域サイズの合計を出力します。
- 未使用領域サイズ合計
-
ジョブ実行環境で使用しているISAMファイルの未使用領域サイズの合計を出力します。
-
-mオプションを指定した場合の出力形式を,次に示します。
出力項目を次に示します。
- テーブル名
-
テーブル名を表示します。
- キー再利用
-
ISAMファイル形式のキー再利用機能が有効となっている場合は,「有効」が出力されます。
ISAMファイル形式が従来形式の場合は,「無効」が出力されます。
- セマフォ番号
-
セマフォ分割されている場合は,セマフォ番号を出力します。
セマフォ分割されていない場合は,「-(ハイフン)」が出力されます。
-
-p,-i,-tオプションの出力先として,j(JP1イベント)を指定した場合,次に示すJP1イベントが出力されます。
指定したオプション
イベントID
イベント名称
イベント発行契機
メッセージID
-p
00004160
ジョブ実行環境データベース再編成開始イベント
再編成が開始したとき
KAVU5980-I
-p
00004161
ジョブ実行環境データベース再編成正常終了イベント
再編成が正常終了したとき
KAVU5981-I
-p
00004162
ジョブ実行環境データベース再編成異常終了イベント
再編成が異常終了したとき
KAVU5982-E
-i
00004163
ISAM未使用領域サイズ情報イベント
ISAM未使用領域サイズ情報取得時
KAVU5983-I
-t
00004164
ISAM未使用領域サイズしきい値到達イベント
ISAM未使用領域サイズしきい値到達時
KAVU5984-W
-
データベースを再編成時に出力されるデータベース再編成ログを,次に説明します。
jpqdbcondコマンドを実行すると,データベース格納ディレクトリにCONDENSE{1|2}.logファイルを作成し,次に示す統計情報をデータベース再編成ログに出力します。
-
開始時刻,終了時刻,所要時間
-
データベース再編成前の未使用領域サイズ,総ファイルサイズ
-
データベース再編成後の未使用領域サイズ,総ファイルサイズ
出力形式は,HNTRログ形式です。ログのサイズは1面512キロバイト,面数は2面です。
データベース再編成時の統計情報は,メッセージKAVU5985-Iを使用して情報を埋め込み出力します。
出力例
KAVU5980-I ジョブ実行環境のデータベース再編成を開始しました 20XX/10/01 01:05:40 KAVU5985-I CONDENSE: データベース再編成前 未使用領域サイズ:102.020MB 総ファイルサイズ 542.245MB KAVU5985-I CONDENSE: データベース再編成後 未使用領域サイズ:0.100MB 総ファイルサイズ 440.225MB KAVU5981-I ジョブ実行環境のデータベース再編成が正常終了しました 20XX/10/01 01:05:40 - 20XX/10/01 01:20:20 (00:14:40)
-