この機能は、Natural オブジェクトが中断されたときにデバッガ内で変数を表示および変更するために使用します。
[Variable maintenance]機能では、中断された Natural オブジェクトに関して、ユーザー定義変数、グローバル変数、データベース関連システム変数の *COUNTER
、*ISN
、*NUMBER
に加えて、Natural のデータフォーマット、データ長、内容が表示されます。
このセクションでは、次のトピックについて説明します。
このセクションでは、すべての変数のリストを表示する[Display Variables](概要)画面や、特定の変数の詳細をすべて表示する[Display Variable](詳細)画面を表示する手順を説明します。
ユーザー定義変数、グローバル変数、およびデータベース関連システム変数の概要を表示するには
デバッグメインメニューまたは[Debug Break]ウィンドウで、ファンクションコード「V
」を入力します。
または:
次のダイレクトコマンドを入力します。
DISPLAY VARIABLE variable,variable,...
[Display Variables](概要)画面には、中断された Natural オブジェクトに指定された変数のリストが表示されます。 長い値は、切り捨てた状態で画面に表示される場合があります。 配列の場合、最初のオカレンスの内容のみが表示されます。
変数の内容の表示形式を英数字と 16 進表記で切り替えるには、PF10(Alpha)キーを押すか、PF11(Hex)キーを押します。
切り捨てられた変数が表示される形式と、グループ名、変数名、インデックス(存在する場合)で構成された完全な名前が表示される形式で、表示を切り替えるには、PF5(Zoom)キーを押します。
個々の変数を完全に表示するには
[Display Variables](概要)画面で、行コマンド DI
で変数をマークして選択します。
または:
次のダイレクトコマンドを入力します。
DISPLAY VARIABLE variable
または:
[List Object Source]画面の[Source]列で、変数名にカーソルを置いて PF18(Di Va)キーを押します。
PF18(Di Va)キーを押す場合、次の制限が適用されます。
変数名(配列のオカレンスを含む)が複数行にまたがる場合は、最初の行の内容のみが評価されます。
array (3,2,6) のように、配列のインデックスが定数である場合は、このオカレンスのみが表示されます。
array (i,j) または array (3:i) のように、配列のインデックスが変数である場合、配列全体が表示されます。
[Display Variable](詳細)画面が開いて、特定の変数に関連するすべての指定が表示されます。
256 バイトの長さを超えるラージ変数の場合、画面にはデフォルトで最初の 256 バイトが表示されます。
変数の内容全体を表示するには、または値の中を移動するには
前のページに戻るには PF22 キーを、次のページに進むには PF23 キーを押します。
または:
特定の位置で表示を開始するには、[Position]フィールドに数値を入力します。
PF10(Alpha)キーと PF11(Hex)キーを押すと、変数の内容の表示形式を、英数字と 16 進表記の間で切り替えることができます。
画面の機能を使用して配列のすべてのオカレンスを表示するには
[Display Variables]画面で、行コマンド DI
で変数をマークして選択します。
または:
PF7(-)および PF8(+)キーを押して、個々のオカレンスの間でページを移動します。
ダイレクトコマンドを使用して配列の 1 つ以上のオカレンスを表示するには
次のダイレクトコマンドを使用します。
DISPLAY VARIABLE variable-name(index-specification)
variable-name
は変数の名前です。index-specification
は、次元のすべてのオカレンスに対して、インデックス表記、インデックス範囲、アスタリスク(*)のいずれかを示します。
例:
DISPLAY VARIABLE ARRAY1(*) |
1 次元配列:
1 次元配列 ARRAY1 のすべてのオカレンスを表示します。 |
DISPLAY VARIABLE ARRAY1(1)
または
|
1 次元配列:
1 次元配列 ARRAY1 の第 1 オカレンスを表示します。 |
DISPLAY VARIABLE ARRAY2(2,3:4) |
2 次元配列:
2 次元配列 ARRAY2 で、1 次元の第 2 オカレンスと、2 次元のインデックス表記を表示します。 |
DISPLAY VARIABLE ARRAY3(1,3:4,*) |
3 次元配列:
3 次元配列 ARRAY3 で、1 次元の第 1 オカレンス、2 次元のインデックス表記、3 次元のすべてのオカレンスを表示します。 |
システム変数(データベース関連システム変数を除く)を表示するには
次のダイレクトコマンドを入力します。
SYSVARS
[System Variables]画面が開いて、システム変数の制限セットが表示されます。
Handle タイプの変数の場合、Handle が参照するインスタンスのクラスの名前が、英数字表記で表示されます。 クラス名が使用できない場合、グローバルユニーク ID(GUID)が代わりに表示されます。 クラスが Natural 内で定義された場合、クラス名または
GUID に接尾辞の(NAT)
が追加されます。
クラスインスタンスのプロパティの内容は、デバッガでは表示できません。
この機能は、システム変数には適用されません。
この機能は、ユーザー定義変数、グローバル変数、およびデータベース関連システム変数の値を変更するために使用します。
[Modify Variable]画面から変数の内容を変更するには
変数を行コマンド MO
でマークして、[Modify Variable]画面を表示します。
または:
[Display Variable]画面で、PF5(Mod)キーを押します。
[Modify Variable]画面の[Contents]フィールドで、変数の値を変更します。
デバッガ内では変数のフォーマットを変更できないので、新しい内容が、変更する変数の Natural データフォーマットに対して有効である必要があります。
[Modify Variable]画面では、PF10(Alpha)と PF11(Hex)キーを使用して、英数字と 16 進表記の間で、変数値の表示を切り替えることができます。
ダイレクトコマンドで変数の内容を変更するには
次のダイレクトコマンドを入力します。
MODIFY VARIABLE variable = new value
変数値の変更を確認するメッセージが表示されます。
注意:
[Modify Variables]機能または MODIFY VARIABLE
コマンドを Natural Security で禁止できます。『Natural Security』ドキュメントの「Components of an Environment Profile」に説明があります。