INPL ユーティリティは、Software AG が提供する Natural オブジェクトおよび共有リソースを処理します。
次の図は、INPL 機能を簡単な図で示したものです。
Natural オブジェクトおよび共有リソースは、ワークファイル 1 に割り当てられたインストールまたは更新ファイルとして提供されます。 INPL ユーティリティは、ワークファイル 1 の Natural オブジェクトおよび共有リソースを Natural システムファイルにロードします。
Natural オブジェクトおよび共有リソースには、Natural システムファイル FNAT および FUSER 内のライブラリに含まれている、カタログ化オブジェクトおよびソースオブジェクトがあります。
INPL ユーティリティは、Natural オブジェクトおよび共有リソースのロード機能だけでなく、ワークファイル 1 に割り当てられたファイルをチェックするスキャン機能、Natural Security 環境を初期化する Natural Security リカバー機能も提供します。
カタログ化オブジェクトを Natural システムファイルにロードする場合、INPL ユーティリティが使用する同一バッファプール内に名前が同じカタログ化オブジェクトが含まれていると、そのオブジェクトのすべてのバッファプールエントリが削除されます。
INPL の実行中にエラーが発生すると、INPL は中断され、コンディションコード 40 で異常終了します。
このドキュメントでは、次のトピックについて説明します。
処理できるのは、"SAG システム INPL ファイル" としてマークされたファイルだけです。
INPL を Natural Security 環境で実行する場合、Natural ダイナミックプロファイルパラメータ STACK
を使用して INPL コマンドを指定できます。
INPL ユーティリティを呼び出すには
次の Natural システムコマンドを入力します。
INPL
次のような INPL ユーティリティウィンドウが表示されます。
ロードするファイルおよび INPL レポート(次を参照)を書き込むファイルを選択します。 詳細については、「使用可能なオプション」を参照してください。
[OK]を押してエントリを確定します。
[Function]メニューで、次のいずれかの方法を選択します。
これらの機能の詳細については、該当するセクションを参照してください。
[Options]ダイアログボックスの[Options]ボタンを選択し、この機能の実行時に適用するパラメータを入力します。
詳細については、「使用可能なオプション」を参照してください。
バッチモードで INPL を実行するとき、またはダイレクトコマンドモードを使用する場合、INPL コマンドに関連して使用する入力データは、次の UNIX 環境の INPL メニューで示されるように、キャラクタユーザーインターフェイスで提供されるフィールドに適用するコードと値に対応します。「使用可能なオプション」の説明を参照してください。 例えば、セッションパラメータ ID
がコンマ(,
)に設定されていると仮定すると、特定のDDMをロードする手順は次のようになります。
INPL D,,,ddm-name
11:04:48 ***** NATURAL INPL UTILITY ***** 2001-11-09 User: SAG Library: SYSTEM Code Function L Load Libraries Only D Load DDMs Only E Load Error Messages Only B Load All Objects S Scan INPL File R Natural Security Recover ? Help . Exit Code ........ B Replace ..... Y (Y/N/O) Load Except . N (Y/N) DDM Name .... Library ..... Object Name . Date ........ (YYYY-MM-DD) Check Date .. N (Y/N) Number ...... 0 File Type ... D (D/P) Load File ... $NATWORK/SAGLOAD.sag Report File . $HOME/report.txt |
次のセクションでは、INPL で使用するファイルおよび INPL 機能のオブジェクト選択条件として 1 つまたは複数のパラメータを指定できる INPL ユーティリティのダイアログボックスのテキストボックスについて説明します。この選択条件は、[Function]メニューで選択します。 使用するパラメータは、関連するドキュメントのセクションで説明するように、機能によって異なります。
項目 | 説明 | ||||
---|---|---|---|---|---|
Load file | ロードするファイルの名前。 | ||||
File type
(バッチまたはダイレクトコマンドのみ) |
INPL では、バイナリやポータブルなど、ロードファイルのタイプが自動的に認識されます。 ただし、INPL をバッチモードまたはダイレクトコマンドモードで実行する場合は、互換性を保持するために File type パラメータを指定する必要があります。このパラメータは評価されません。
|
||||
Report file | INPL レポート(次を参照)が書き込まれるファイルの名前。 | ||||
Library | ライブラリの名前または名前の範囲。
アスタリスク(*)で終わる値を入力すると、指定した値で始まる名前を持つ各ライブラリが処理されます。 [Object name]を指定する場合、ライブラリ名は必須です。 |
||||
Object name | Natural オブジェクト(DDM 以外)の名前または名前の範囲。
値がアスタリスク(*)で終わる場合は、指定した値で始まる名前を持つ各オブジェクトが処理されます。 このフィールドが空の場合は、[Library]テキストボックスで指定したライブラリに含まれるすべてのオブジェクトが処理されます。 |
||||
DDM name | DDM の名前または名前の範囲。
アスタリスク(*)で終わる値を入力すると、指定した値で始まる名前を持つ DDM が処理されます。 アスタリスク(*)のみを入力した場合、またはこのテキストボックスが空の場合は、すべての DDM が処理されます。 |
||||
Date start | このテキストボックスに入力した日付以降に保存されたか、またはカタログされた Natural オブジェクトおよび共有リソースだけを処理します。
日付は、YYYY-MM-DD(YYYY = 年、MM = 月、DD = 日)の形式で入力する必要があります。 |
||||
Number | Natural オブジェクトおよび共有リソースの処理を指定の数に制限します。 指定した選択条件に基づいてロードまたはスキャンされるすべてのオブジェクトがカウントされます。
処理された Natural オブジェクトの数が[Number]テキストボックスに入力した値に達すると、処理は終了し、対応するメッセージが表示されます。 |
||||
Replace | 処理される Natural オブジェクトおよび共有リソースを、すでにシステムファイルに存在するものと置き換えるかどうかを指定します。
可能な設定:
ロードする Natural オブジェクトおよび共有リソースより古い Natural オブジェクトおよび共有リソースだけを置き換える場合は、「Check date before replace」も参照してください。 |
||||
Check date before replace |
既存の Natural オブジェクトおよび共有リソースをタイムスタンプに基づいて置き換えるかどうかを指定します。 [Replace]が選択されていない場合、このパラメータは影響を与えません。 可能な設定:
|
||||
Load except |
Natural オブジェクトおよび共有リソースを処理から除外するかどうかを指定します。 このパラメータはエラーメッセージには適用されません。 可能な設定:
ロード除外の例:
ライブラリ ABC を除くすべてのライブラリがロードされます。 接頭辞が XY 以外のすべての DDM がロードされます。 接頭辞が AB 以外のライブラリに含まれるすべてのオブジェクトと、接頭辞が CD 以外のすべての DDM がロードされます。 |
||||
Natural Security recover object | Natural Security リカバー機能を選択した場合にのみ適用されます。
オンにすると、指定した Natural オブジェクトのオーナー情報がリセットされます。 |
選択した INPL 機能が完了すると、対応する INPL レポートがリストボックスに表示されます(オンラインモード)。