Recover 関数

構文

mfims imsdbu RECV {database-name|filename}
     [PITR(YYMMDDhhmmssmm)]
     [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

The name of a database on which the function operates.

filename

The name of a file containing a list of databases on which the function operates.

PITR

特定の時点に回復。

サブパラメーター

YYMMDDhhmmssmm

データベースを回復する特定の時点。年、月、日、時、分、秒、マイクロ秒をそれぞれ 2 桁ずつで示します。区切り文字はオプションであり、合計で 25 文字までの制限に収まっていれば、数や位置に制限はありません。 有効にするには、指定した日時が TLOG ファイルに記録されている commit comp の date time と一致している必要があります。この情報を TLOG ファイルで確認する方法については、「TLOG ファイル」のトピックを参照してください。

ABEND

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

デフォルト：

ABEND(NO)

サブパラメーター

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

CLS

Clears the screen before starting the utility. NOCLS prevents the initial clear screen and can be helpful when you are running a series of utilities in a command file.

Default:

NOCLS

ECHO

Controls the display of and interaction with the messages displayed by IMSDBU.

Default:

ECHO(MSGS,4,8)

Sub-parameters

keyword	The category of information displayed. One of the following: ALL Always displays processing messages, input source or detail information and the ending message. Warning and error messages are displayed and stop for user input if the message level is equal to or greater than the msglvl and stoplvl values. MSGS Always displays processing messages and the ending message. No source or detail information is displayed. Warning and error messages are displayed and stop for user input if the message level is equal to or greater than the msglvl and stoplvl values. ERREND Always displays the utility ending message. Warning and error messages are displayed and stop for user input if the message level is equal to or greater than the msglvl and stoplvl values. ENDMSG Displays ending message only if the utility ending return code is equal to or greater than msglvl. A "Press any key to continue" message is displayed and stops for input if the utility ending return code is equal to or greater than the stoplvl. Enter a msglvl and/or stoplvl value of zero to display and/or stop on every ending message. COND Both the warning/error and ending messages are conditional on the msglvl and stoplvl values. Warning and error messages are displayed and stop for user input if the message level is equal to or greater than the msglvl and stoplvl values. The ending message is displayed if the ending return code is equal to or greater than msglvl. You see the message "Press any key to continue" which requires input if the utility ending return code is equal to or greater than the stoplvl. ERRORS You see warning and error messages which require input if the message level is equal to or greater than the msglvl and stoplvl. You do not see the ending message.
msglvl	A value from 4 through 20 to indicate the severity of messages to display.1
stoplvl	A value from 4 through 20 to indicate the severity of messages to stop for user input. 1

¹ Can take the following values:

Value	Category	Example Cause
4	General warning message	A minor coding error in DBD source which DBDGEN can make an assumption about and continue.
6	IMS specific warning message	A warning that a keyword or statement is not supported and is ignored - processing can continue.
8	General severe error	An incorrect coding in DBD source which cannot be compensated for, such as 'no DBD statement'.
10	IMS Option specific severe error	An unsupported feature was defined which cannot be compensated for, such as 'Exceeded some maximum'.
12	Severe error - possible temporary condition	A temporary I/O error such as a 'file locked' or 'database locked' status.
16	Severe error- permanent - likely installation problem	A permanent I/O error, such as an invalid data set name or member name, was input to a utility or an environment variable is not set correctly.
20	Severe error - permanent	An unrecoverable I/O error or some other unexpected error.

INI

Specifies the default directives file.

Default:

None

Sub-parameter

filespec

The name and location of the .INI file containing directives that override the IMSDBU programmed defaults.

Syntax Rules

1. filespec can include a drive and/or directory if required. If you do not specify a drive or directory, IMSDBU looks for the named .INI file in the current directory.
2. Directives listed in the .INI file override the IMSDBU programmed defaults.
3. Directives entered on the command line or interactive screen override directives in the .INI file.
4. Specifying NOINI prevents any .INI file from overriding the programmed defaults.
5. If you specify an .INI file that does not exist, the programmed default directives are used as if NOINI were specified.

General Rules

1. An .INI file is an ASCII text file containing a heading, [IMSDBU] on line 1, starting in column 1, followed by a list of mfims imsdbu directives; one directive per line. A line is terminated by a return or an end-of-file. Comment lines are indicated by an asterisk (*) or semi-colon (;) in column 1. For example:

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

LIST

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

デフォルト：

RECOVER(*.LST)

サブパラメーター

filespec

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

構文規則

1. filespec には、必要に応じてドライブまたはディレクトリ、あるいはその両方を含めることができます。ドライブやディレクトリを指定しない場合、IMDBU は現在のディレクトリにリスティング ファイルを作成します。
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

Controls the open disposition of the detail listing file.

Default:

LISTOPEN(NEW)

Sub-parameter

disp	The disposition to use. One of: NEW Creates a new listing file or overwrites an existing one. MOD Appends the list output to an existing file or creates a new listing if one does not exist. MOD allows you to maintain a detailed historical record of database functions.

Syntax Rules

1. LISTOPEN is ignored when NOLIST is specified.

LOG

Specifies the IMSDBU activity log, which shows the ending message status for each function.

Default:

LOG(IMSDBU.LOG)

Sub-parameter

filespec

The name and location of the file to use as the IMSDBU activity log.

Syntax Rules

1. filespec can include a drive and/or directory if required. If you do not specify a drive or directory, the listing is created in the current directory.
2. Specifying NOLOG suppresses the log file output.

General Rules

1. The log file is created if it does not exist.
2. The log file is historical with the most recent entries written to the end of the file.
3. As the log file grows in size over time, it might require deletion periodically.

SERVER

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

デフォルト：

なし

サブパラメーター

server-name

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

TLOGPATH

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

デフォルト：

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

サブパラメーター

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