バージョン 6.3.3
 —  ツールおよびユーティリティ  —

INPL ユーティリティ - はじめに

INPL ユーティリティは、Software AG が提供する Natural オブジェクトおよび共有リソースを処理します。

次の図は、INPL 機能を簡単な図で示したものです。

graphics/inpl_gen_winux.png

Natural オブジェクトおよび共有リソースは、ワークファイル 1 に割り当てられたインストールまたは更新ファイルとして提供されます。 INPL ユーティリティは、ワークファイル 1 の Natural オブジェクトおよび共有リソースを Natural システムファイルにロードします。

Natural オブジェクトおよび共有リソースには、Natural システムファイル FNAT および FUSER 内のライブラリに含まれている、カタログ化オブジェクトおよびソースオブジェクトがあります。

INPL ユーティリティは、Natural オブジェクトおよび共有リソースのロード機能だけでなく、ワークファイル 1 に割り当てられたファイルをチェックするスキャン機能、Natural Security 環境を初期化する Natural Security リカバー機能も提供します。

カタログ化オブジェクトを Natural システムファイルにロードする場合、INPL ユーティリティが使用する同一バッファプール内に名前が同じカタログ化オブジェクトが含まれていると、そのオブジェクトのすべてのバッファプールエントリが削除されます。

INPL の実行中にエラーが発生すると、INPL は中断され、コンディションコード 40 で異常終了します。

このドキュメントでは、次のトピックについて説明します。


制限

処理できるのは、"SAG システム INPL ファイル" としてマークされたファイルだけです。

Top of page

特別な場合

INPL を Natural Security 環境で実行する場合、Natural ダイナミックプロファイルパラメータ STACK を使用して INPL コマンドを指定できます。

Top of page

INPL の呼び出し

Start of instruction set INPL ユーティリティを呼び出すには

  1. 次の Natural システムコマンドを入力します。

    INPL

    次のような INPL ユーティリティウィンドウが表示されます。

  2. ロードするファイルおよび INPL レポート(次を参照)を書き込むファイルを選択します。 詳細については、「使用可能なオプション」を参照してください。

  3. [OK]を押してエントリを確定します。

  4. [Function]メニューで、次のいずれかの方法を選択します。

    これらの機能の詳細については、該当するセクションを参照してください。

  5. [Options]ダイアログボックスの[Options]ボタンを選択し、この機能の実行時に適用するパラメータを入力します。

    詳細については、「使用可能なオプション」を参照してください。

Top of page

バッチおよびダイレクトコマンドモード

バッチモードで 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

Top of page

使用可能なオプション

次のセクションでは、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-DDYYYY = 年、MM = 月、DD = 日)の形式で入力する必要があります。

Number Natural オブジェクトおよび共有リソースの処理を指定の数に制限します。 指定した選択条件に基づいてロードまたはスキャンされるすべてのオブジェクトがカウントされます。

処理された Natural オブジェクトの数が[Number]テキストボックスに入力した値に達すると、処理は終了し、対応するメッセージが表示されます。

Replace 処理される Natural オブジェクトおよび共有リソースを、すでにシステムファイルに存在するものと置き換えるかどうかを指定します。

可能な設定:

Checked すべての既存 Natural オブジェクトおよび共有リソースが置き換えられます。 これはデフォルト設定です。
Unchecked 既存の Natural オブジェクトおよび共有リソースは置き換えられません

ロードする Natural オブジェクトおよび共有リソースより古い Natural オブジェクトおよび共有リソースだけを置き換える場合は、「Check date before replace」も参照してください。

Check date before replace

既存の Natural オブジェクトおよび共有リソースをタイムスタンプに基づいて置き換えるかどうかを指定します。

[Replace]が選択されていない場合、このパラメータは影響を与えません。

可能な設定:

Checked 同じ名前の Natural オブジェクトまたは共有リソースより古いオブジェクトのみが置き換えられます。 ロードされる前に保存またはカタログ化されたオブジェクトが古いオブジェクトです。
Unchecked すべてのオブジェクトが置き換えられます。 これはデフォルト設定です。
Load except

Natural オブジェクトおよび共有リソースを処理から除外するかどうかを指定します。

このパラメータはエラーメッセージには適用されません。

可能な設定:

Checked [DDM Name][Library][Object Name]の各テキストボックスで指定したオブジェクトを除くすべての Natural オブジェクトおよび共有リソースが処理されます。
Unchecked 除外なしの場合は、すべての Natural オブジェクトおよび共有リソースが処理されます。 これはデフォルト設定です。
ロード除外の例:

ライブラリ ABC を除くすべてのライブラリがロードされます。
Function = Load Libraries Only
Library = ABC

接頭辞が XY 以外のすべての DDM がロードされます。
Function = Load DDMs Only
DDM Name = XY*

接頭辞が AB 以外のライブラリに含まれるすべてのオブジェクトと、接頭辞が CD 以外のすべての DDM がロードされます。
Function = Load All Objects
Library = AB*
DDM Name = CD*

Natural Security recover object Natural Security リカバー機能を選択した場合にのみ適用されます。

オンにすると、指定した Natural オブジェクトのオーナー情報がリセットされます。

Top of page

INPL レポート

選択した INPL 機能が完了すると、対応する INPL レポートがリストボックスに表示されます(オンラインモード)。

Top of page