バージョン 4.2.5
 —  ユーティリティ  —

option-setting

option-setting 節は、オブジェクトハンドラコマンドオプションのデフォルト値を変更するために使用します。

以下のセクションでは、option-setting 節に適用される構文を示して説明します。 構文図で使用しているキーワードおよび変数値は、デフォルト値の指定に使用されるパラメータを表します。 必要な場合、変数値をキーワードと一緒に指定する必要があります。


option-setting の構文

WHERE  

(option-workplan)
 
option-clause

option-workplan に適用される構文図については、「ワークプラン」セクションの「ワークプランの参照」を参照してください。

以下のセクションでは、option-clause の構文を示します。

option-clause の構文

REPLACE

ALL
OBSOLETE
EXCEPT

                 

transfer-options
internal-format-options

                   

NOREPORT
NEWREPORT [file-name]
REPORT [file-name]
BATCHREPORT

                   

NORESTART
RESTART [restart-text-member]

                   
[NUMBERPROCESS number]
[FIXEDLENGTH]
[FDIC (dbid,fnr,password,cipher)]
[FSEC (dbid,fnr,password,cipher)]

WORKFILETYPE
WFTYPE

DEFAULT
UTF-8

             

PC
NEWPC

[file-name]

               

PCCOMMANDFILENUMBER
PCCOM
PCCFN

command-file-number

               

セパレータ

FDIC および FSEC キーワードに続く各値の間に、または値がない場合に、セパレータとしてコンマを使用する必要があります。 例えば、FDIC (10,21,,2a) のように使用します。

セッションパラメータ ID(『パラメータリファレンス』ドキュメントの「ID - INPUT 区切り文字」を参照)がコンマに設定されている場合、値を区切るセパレータとしてスラッシュ(/)を使用します。

transfer-options

TRANSFER

CONVERSION-TABLE

SYSTEM-TABLE
USER-TABLE [conversion-program]

[SUBSTITUTE]
[INCLUDE-LINE-NUMBERS]
[UPPERCASE-TRANSLATION]
[INCORPORATE-FREE-RULES]
[LOAD-CODE-PAGE code-page-name]
[DA-FORMAT data-area-format]

internal-format-options

 

XREF

ON
OFF
DOC
FORCE
SPECIAL

[DELETEALLOWED]
[NOSYMBOLTABLE]
[VERSIONCHECK]

Top of page

option-setting のキーワードの説明

次のセクションでは、option-setting のキーワードおよび変数値(該当する場合)について説明します。

オプション 説明 利用可能なコマンド
REPLACE 指定されたオプションに従って、既存のオブジェクトを置き換えます。
ALL すべてのオブジェクト(デフォルト設定)。
OBSOLETE ロードファイル内のオブジェクトの日付より古い日付になっているすべてのオブジェクト。
EXCEPT ロードファイル内のオブジェクトの日付より新しい日付になっているオブジェクトを除いた、すべてのオブジェクト。

LOAD
LOADALL

TRANSFER 転送モードを設定します。

データは、転送フォーマットで読み込みおよび書き込みが行われます。 有効なオプションについては、「transfer-options のキーワードの説明」を参照してください。

UNLOAD
LOAD
SCAN

NOREPORT 以下のレポートファイル設定を指定します。

データはレポートファイルに記録されません。 これは、FIND および FINDLIB コマンドに対するデフォルト設定です。

 
NEWREPORT 以下のレポートファイル設定を指定します。

レポートデータは記録され、ワークプランライブラリに保存されている Natural テキストメンバに書き込まれます。 既存のファイルは上書きされます。

 
REPORT 以下のレポートファイル設定を指定します。

レポートデータは記録され、ワークプランライブラリに保存されている Natural テキストメンバに書き込まれます。 これは、UNLOADLOADLOADALLSCANSCANALL、および DELETE コマンドに対するデフォルト設定です。

 
BATCHREPORT

バッチ処理時または OBJHAPI アプリケーションプログラミングインターフェイスの使用時のレポート設定を指定します。

レポートデータは、それぞれ SYSOUT に書き込まれるか、または画面に出力されます(レポートデータはファイルに書き込まれません)。

 
NORESTART 再スタート情報はファイルに書き込まれません。 LOAD
RESTART 再スタート情報は、ワークプランライブラリに保存されている Natural テキストメンバに書き込まれます。 LOAD
NUMBERPROCESS 処理するオブジェクトの数を指定します。

指定された数を処理した後、LOAD または SCAN コマンドは停止します。

LOAD
SCAN

FIXEDLENGTH アンロードワークファイルのフォーマットを固定サイズの最大レコード長に設定します。

内部フォーマットで書き込まれる場合、各データレコードには 256 バイトが含まれ、転送フォーマットでは 100 バイトが含まれます。

UNLOAD
FDIC 処理に使用するシステムファイル FDIC を指定します。

Adabas ファイルのデータベース ID(dbid)、ファイル番号(fnr)、パスワード(password)、およびサイファコード(cipher)。

値が指定されていない場合、または「0」が指定されている場合、現在の FDIC システムファイルが使用されます。

UNLOAD
LOAD
DELETE

FSEC 処理に使用するシステムファイル FSEC を指定します。

Adabas ファイルのデータベース ID(dbid)、ファイル番号(fnr)、パスワード(password)、およびサイファコード(cipher)。

値が指定されていない場合、または 0 が指定されている場合、現在の FSEC システムファイルが使用されます。

UNLOAD
LOAD
DELETE

WORKFILETYPE
または
WFTYPE

データがワークファイルに対して読み込みおよび書き込みされるときの Natural ワークファイル 1 のワークファイルタイプ。
DEFAULT デフォルトのバイナリワークファイル。
UTF-8 Unicode/UTF-F8 でエンコードされたバイナリワークファイル。
UTF-8 は、TRANSFER が指定されている場合にアンロード機能にのみ適用されます。
UTF-8 が指定されている場合、CONVERSION-TABLESUBSTITUTE、および INCORPORATE-FREE-RULES オプションは使用できません。

WORKFILETYPE が指定されていない場合、現在のタイプが使用されます。

UNLOAD

PC
NEWPC

適用されるのは、Entire Connection がインストールされている場合に限られます。

Entire Connection ワークファイルに対してデータの書き込みまたは読み込みを行います。 file-name は、Entire Connection ワークファイルに割り当てられている完全パス名を表します。 現在のシステム環境でバックスラッシュ(\)セパレータを使用できない場合は、代わりにスラッシュ(/)を使用します。 file-name を指定しないと、ワークファイル名の入力を求めるプロンプトが Entire Connection から表示されます。

NEWPC が指定されると、既存のワークファイルの内容がアンロードしたデータで上書きされるか、または新しいワークファイルが先頭から埋められます。 これに該当しない場合、データが追加されます。

ワークファイル」の「ワークファイルの割り当て」も参照してください。

UNLOAD
LOAD
SCAN

PCCOMMANDFILENUMBER
または
PCCOM
または
PCCFN

適用されるのは、Entire Connection がインストールされている場合に限られます。

Entire Connection コマンドの処理に使用されるワークファイルの番号を指定します。

デフォルト値はワークファイル 8 の 8 であり、このファイルを Entire Connection ワークファイルとして定義する必要があります。

ワークファイル」の「ワークファイルの割り当て」も参照してください。

UNLOAD
LOAD
SCAN

次のセクションでは、transfer-optionsinternal-format-options のキーワードおよび変数値(該当する場合)について説明します。

transfer-options のキーワードの説明

TRANSFER キーワードを使用する場合、次のオプションを指定できます。

オプション 説明 利用可能なコマンド
CONVERSION-TABLE 次のいずれかの変換テーブルを使用して、転送フォーマットで処理されたデータを変換します。

SYSTEM-TABLE

内部的な Natural 変換テーブル。

USER-TABLE

conversion-program が指定されている場合のユーザー定義変換テーブル。 このプログラムは、ライブラリ SYSOBJH またはその steplib の 1 つに保存されている必要があります。ライブラリ SYSOBJH にあるプログラム例 OTNCONAE および OTNCONEA を参照してください。

UNLOAD
LOAD
SCAN

SUBSTITUTE

転送フォーマットでのアンロード中に行参照をラベルで置き換えます。

このオプションは、ソースコードの行番号がステートメント参照に使用されている場合にのみ適用されます。 その場合、参照された行の行番号および行番号参照はラベルで置き換えられます。 ソースはデータベースでは変更されません。

UNLOAD
INCLUDE-LINE-NUMBERS

転送フォーマットでのアンロード中に行番号を転送します。
デフォルトでは、Natural オブジェクトの行番号はアンロードされません

UNLOAD
UPPERCASE-TRANSLATION

転送フォーマットでのロード中にソースコードを大文字に変換します。
デフォルトでは、Natural オブジェクトのソースコードは変換されません

LOAD
INCORPORATE-FREE-RULES Predict がインストールされている場合、転送フォーマットでのアンロード中に、マップに連結されている Predict フリールールのソーステキストをマップソースに組み込みます。 UNLOAD
LOAD-CODE-PAGE

Unicode/UTF-8(Universal Transformation Format、8 ビット形式)でエンコードされたオブジェクトソースの変換に使用されるコードページを指定します。

このオプションを使用すると、UTF-8 でワークファイルにアンロードされたすべてのオブジェクトソースは、ワークファイルにロードされるときに指定のコードページで変換されます。

code-page-name として *CODEPAGE を指定するか、または code-page-name が指定されていないと、システム変数 *CODEPAGE に割り当てられている値が使用されます(『システム変数』ドキュメントを参照)。

LOAD-CODE-PAGE が指定されている場合、CONVERSION-TABLE および UPPERCASE-TRANSLATION オプションは使用できません。

LOAD
LOADALL

DA-FORMAT

データエリアソースのフォーマット変換を指定します。「設定」の「転送オプション」にある「Data area format」を参照してください。

UNLOAD
LOAD

internal-format-options のキーワードの説明

internal-format-options を使用する場合、次のオプションを指定できます。

オプション 説明 利用可能なコマンド
XREF
適用されるのは、Predict がインストールされている場合に限られます。

カタログされた Natural オブジェクトの XRef データをロードまたはアンロードします。 次の値のいずれかを指定できます。

   
ON UNLOAD
カタログ化オブジェクトとそのクロスリファレンスデータ(存在する場合)をアンロードします。

LOAD
クロスリファレンスがワークファイルに存在する場合は、カタログ化オブジェクトとそのクロスリファレンスデータをロードします。

   
OFF XRef データは処理されません。 これがデフォルトです。
   
DOC LOAD にのみ適用されます。

カタログ化オブジェクトをロードします。ただしそれは、そのオブジェクトの Predict エントリが FDIC システムファイル内に存在する場合に限られます。

   
FORCE LOAD にのみ適用されます。

カタログ化オブジェクトとそのクロスリファレンスデータをロードします。ただしそれは、クロスリファレンスがワークファイル内に存在し、そのオブジェクトの Predict エントリが FDIC システムファイル内に存在する場合に限られます。

   
SPECIAL LOAD にのみ適用されます。

カタログ化オブジェクトとそのクロスリファレンスデータ(存在する場合)をロードします。

LOAD
UNLOAD

DELETEALLOWED オブジェクトを内部フォーマットでロードするときに、ユーティリティ NATUNLD によって作成されたワークファイルから削除命令を処理します。 LOAD
NOSYMBOLTABLE

カタログされた Natural ライブラリオブジェクトを、対応する内部的な Natural シンボルテーブルなしでアンロードします。

これにより、必要なディスクストレージの量が削減されます。 ただし、これは実稼動環境においてのみ役立ちます。実稼動環境では、シンボルテーブルを必要とする複数のアプリケーション開発機能が使用できず、またプロファイルパラメータ RECAT=ON(『パラメータリファレンス』ドキュメントを参照)が適用されないからです。

UNLOAD
VERSIONCHECK

ロードするカタログ化オブジェクトの Natural バージョンをチェックします。 オブジェクトをカタログしワークファイルに書き込んだ Natural バージョンが現在の Natural バージョンと比較されます。 現在よりも上位のバージョンの Natural でカタログされたオブジェクトは拒否されます。

VERSIONCHECK は、データを内部フォーマットでロードする場合(つまり、TRANSFER オプションが指定されていない場合)にのみ使用できます。

LOAD

Top of page