Recover関数

構文

mfims imsdbu RECV {database-name|filename}
     [ABEND(NO|YES)]
     [[NO]CLS] 
     [ECHO(keyword,msglvl,stoplvl
     [[NO]INI(filespec)]
     [[NO]LIST(filespec)]
     [LISTOPEN(disp)]
     [[NO]LOG(filespec)]
     SERVER(server-name)
     [TLOGPATH(path)]

パラメータ

database-name

関数を実行するデータベースの名前。

filename

関数を実行するデータベースのリストを含んでいるファイルの名前。

ABEND

Recoverログ・ファイルで日付の不一致が検出された場合の動作を決めます。

デフォルト：

ABEND(NO)

サブパラメータ

NO	Recoverログ・ファイルで日付の不一致が検出された場合でも、Recover処理は続行します。
YES	Recoverログ・ファイルで日付の不一致が検出された場合に、Recoverは中止されます。

CLS

ユーティリティの起動前に画面をクリアします。NOCLS を使用すると、初期クリア画面は防止されます。NOCLS は、コマンド・ファイルで一連のユーティリティを実行している場合に役立ちます。

デフォルト：

NOCLS

ECHO

IMSDBU によって表示されるメッセージの表示とそれらのメッセージとの対話を制御します。

デフォルト：

ECHO(MSGS,4,8)

サブパラメータ

keyword	表示される情報のカテゴリ。次のいずれかを指定します。 ALL 処理メッセージ、入力ソースまたは詳細情報、および終了メッセージを常に表示します。メッセージ・レベルが msglvl および stoplvl 値以上の場合は、警告およびエラー・メッセージが表示され、ユーザ入力を求めて停止します。 MSGS 処理メッセージと終了メッセージを常に表示します。ソースや詳細情報は表示されません。メッセージ・レベルが msglvl および stoplvl 値以上の場合は、警告およびエラー・メッセージが表示され、ユーザ入力を求めて停止します。 ERREND ユーティリティ終了メッセージを常に表示します。メッセージ・レベルが msglvl および stoplvl 値以上の場合は、警告およびエラー・メッセージが表示され、ユーザ入力を求めて停止します。 ENDMSG ユーティリティ終了戻りコードが msglvl 以上の場合のみ終了メッセージを表示します。ユーティリティ終了戻りコードが stoplvl 以上の場合は、「Press any key to continue」というメッセージが表示され、入力を求めて停止します。すべての終了メッセージで表示および/または停止するには、msglvl および/または stoplvl の値としてゼロを入力します。 COND 警告/エラー・メッセージと終了メッセージは、どちらも msglvl および stoplvl 値を条件としています。メッセージ・レベルが msglvl および stoplvl 値以上の場合は、警告およびエラー・メッセージが表示され、ユーザ入力を求めて停止します。終了戻りコードが msglvl 以上の場合は、終了メッセージが表示されます。ユーティリティ終了戻りコードが stoplvl 以上の場合は、入力を求める「Press any key to continue」というメッセージが表示されます。 ERRORS メッセージ・レベルが msglvl および stoplvl 以上の場合は、入力を求める警告およびエラー・メッセージが表示されます。終了メッセージは表示されません。
msglvl	表示するメッセージの重大度を示す 4～20 の値。1
stoplvl	ユーザ入力を求めて停止するメッセージの重大度を示す 4～20 の値。 1

¹ 次の値を取ることができます。

値	カテゴリ	原因例
4	一般的な警告メッセージ	DBDGEN が仮設を立てて続行することができる DBD ソース内のマイナーなコーディング・エラー
6	IMS 固有の警告メッセージ	キーワードまたは文がサポート対象外で無視されるという警告 - 処理は続行可能
8	一般的な重大エラー	補正できない DBD ソース内の不正なコーディング ('no DBD statement' など)
10	IMS Option 固有の重大エラー	補正できないサポート対象外の機能が定義されている ('Exceeded some maximum' など)
12	重大エラー - 起こりうる一時的なステータス	一時的な I/O エラー ('file locked' または 'database locked' ステータスなど)
16	重大エラー - 永続的 - インストールの問題と考えられる	永続的な I/O エラー (無効なデータ・セット名やメンバー名がユーティリティに入力された場合や、環境変数が正しく設定されていない場合など)
20	重大エラー - 永続的	Recover不能な I/O エラーまたは他の予期しないエラー

INI

デフォルトの指令ファイルを指定します。

デフォルト：

なし

サブパラメータ

filespec

IMSDBU プログラム・デフォルトをオーバーライドする指令を含んだ .INI ファイルの名前と場所。

構文規則

1. filespec には、必要に応じてドライブやディレクトリを含めることができます。ドライブやディレクトリを指定しない場合、IMSDBU は指定された .INI ファイルを現在のディレクトリで検索します。
2. .INI ファイルにリストされた指令は、IMSDBU プログラム・デフォルトをオーバーライドします。
3. コマンド・ラインまたは対話式画面で入力された指令は、.INI ファイル内の指令をオーバーライドします。
4. NOINI を指定すると、.INI ファイルによってプログラム・デフォルトがオーバーライドされることはなくなります。
5. 存在しない .INI ファイルを指定した場合は、NOINI が指定されたかのようにプログラム・デフォルトの指令が使用されます。

一般規則

1. .INI ファイルは ASCII テキスト形式のファイルで、見出し [IMSDBU] を行 1 に含み、列 1 から始まり、1 行に 1 つの指令が含まれる mfims imsdbu 指令のリストが続きます。行は改行またはファイル終わりによって終了します。コメント行は、列 1のアスタリスク (*) またはセミコロン (;) によって示されます。IMSDBU 指令の例を次に示します。

   [IMSDBU]
   PROGRESS(1000)
   ;use local log
   LOG(C:\MYDIR\MYDB.LOG)

LIST

各Recoverログが処理されるごとに、詳細リスティング・ファイルの場所と名前を制御します。このファイルには、データベースごとに適用される更新数に関係するRecover統計が含まれています。

デフォルト：

RECOVER(*.LST)

サブパラメータ

filespec

リスティング・ファイルに使用する名前と場所。

構文規則

1. filespec には、必要に応じてドライブやディレクトリを含めることができます。ドライブやディレクトリを指定しない場合、IMSDBU は現在のディレクトリにリスティング・ファイルを作成します。
2. NOLIST はリスティング・ファイルの作成を抑制します。
3. パスを指定するために、パスを表す環境変数名の冒頭にドル記号 ($) を置く表記法を使用できます。例えば、LIST($ENVVAR\*.DOC) を使用すると、ENVVAR 環境変数によって指定されたディレクトリに dbdname.DOC のリスト・ファイルが作成されます。
4. LIST(*.LST) または LIST(*.RPT) を指定すると、プロジェクト・リスティング・ディレクトリにリスティング・ファイルが作成されます。
5. パスを指定しない場合、リスティング・ファイルは現在のディレクトリに作成されます。
6. filespec のベース名をアスタリスク (*) として指定した場合、そのアスタリスクは DBD 名に置き換えられます。これにより、IMSDBU は、複数のデータベースに作用することができる関数の個別レポートを提供できるようになります。また、これは DBD 名による履歴詳細レポートの管理にも役立ちます。
7. LIST を filespec なしで指定するのは、LIST(*.LST) を指定するのと同じです。

LISTOPEN

詳細リスティング・ファイルのオープン・ディスポジションを制御します。

デフォルト：

LISTOPEN(NEW)

サブパラメータ

disp	使用するディスポジション。次のいずれかになります。 NEW 新しいリスティング・ファイルを作成するか、または既存のリスティング・ファイルを上書きします。 MOD リスト出力を既存のファイルに追加します。既存のファイルがない場合は、新しいリスティングを作成します。MOD を指定すると、データベース関数の詳細履歴レコードを管理することができます。

構文規則

1. NOLIST が指定されている場合は、LISTOPEN は無視されます。

LOG

各関数の終了メッセージ・ステータスを示す IMSDBU アクティビティ・ログを指定します。

デフォルト：

LOG(IMSDBU.LOG)

サブパラメータ

filespec

IMSDBU アクティビティ・ログとして使用するファイルの名前と場所。

構文規則

1. filespec には、必要に応じてドライブおよび/またはディレクトリを含めることができます。ドライブやディレクトリを指定しない場合は、現在のディレクトリにリスティングが作成されます。
2. NOLOG を指定すると、ログ・ファイル出力は抑制されます。

一般規則

1. ログ・ファイルが存在しない場合は、ログ・ファイルが作成されます。
2. ログ・ファイルは、ファイル終わりまで記述されている直近のエントリを含んでいる履歴ファイルです。
3. ログ・ファイルのサイズが次第に増大すると、状況により定期的に削除が必要になります。

SERVER

エンタープライズ・サーバの名前を指定します。

デフォルト：

なし

サブパラメータ

server-name

Recoverログ・ファイルの作成時にアクティブだったエンタープライズ・サーバの名前。

TLOGPATH

Recoverログ・ファイルの場所を指定します。

デフォルト：

最初に現在のディレクトリ、次に ES_IMS_TLOG_PATH 環境変数によって指定されたパスをチェックします。

サブパラメータ

path	Recoverログ・ファイルがある場所へのパス。