OpenVMS マニュアル

DEFINE/KEY

ファンクション・キーに文字列を割り当てます。

注意 このコマンドは，デバッガへの HP DECwindows Motif for OpenVMS ユーザ・インタフェースでは使用できません。

形式

DEFINE/KEY key-name "equivalence-string"

パラメータ

key-name

文字列を割り当てるファンクション・キーを指定します。有効なキー名は次のとおりです。

キー名	LK201 キーボード	VT100型	VT52型
PF1	PF1	PF1	Blue
PF2	PF2	PF2	Red
PF3	PF3	PF3	Black
PF4	PF4	PF4
KP0--KP9	キーパッドの 0〜9	キーパッドの 0〜9	キーパッドの 0〜9
PERIOD	キーパッドのピリオド (.)	キーパッドのピリオド (.)
COMMA	キーパッドのコンマ (,)	キーパッドのコンマ (,)
MINUS	キーパッドのマイナス (-)	キーパッドのマイナス (-)
ENTER	Enter	ENTER	ENTER
E1	Find
E2	Insert Here
E3	Remove
E4	Select
E5	Prev Screen
E6	Next Screen
HELP	Help
DO	Do
F6--F20	F6--F20

LK201 キーボードでは，次のようになります。

• F1 から F5 のキーや矢印キー (E7 から E10) は定義できません。

• DCL コマンドの SET TERMINAL/NOLINE_EDITING を最初に入力していた場合にだけ F6 から F14 のキーは定義できます。入力していた場合には，左向き矢印キーと右向き矢印キー (E8 と E9) の行編集機能は使用できません。

equivalence-string

指定のキーを押したときに処理する文字列を指定します。通常，これは 1 つまたは複数のデバッガ・コマンドになります。文字列にスペースまたは英数字以外の文字 ( たとえば，2 つのコマンドを分けるセミコロン ) が含まれている場合には，文字列を二重引用符 (") で囲んでください。

修飾子

/ECHO (省略時の設定)

/NOECHO

キーが押されたあとにコマンド行を表示するかどうかを制御します。 /NOTERMINATE を指定する場合は，/NOECHO は使用できません。

/IF_STATE=(state-name[,...])

/NOIF_STATE ( 省略時の設定 )

キー定義が適用される 1 つまたは複数の状態を指定します。 /IF_STATE 修飾子は指定された状態にキー定義を割り当てます。 DEFAULT や GOLD などの定義済み状態またはユーザ定義状態を指定できます。状態名は適切な英数字文字列にすることができます。 /NOIF_STATE 修飾子を使用すると，キー定義が現在の状態に割り当てられます。

/LOCK_STATE

/NOLOCK_STATE (省略時の設定)

指定のキーを押したあと，/SET_STATE で設定された状態がどれだけの間有効であり続けるかを制御します。/LOCK_STATE 修飾子を指定すると，状態は ( たとえば SET KEY/STATE コマンドにより ) 明示的に変更されるまで有効のままです。/NOLOCK_STATE 修飾子を指定すると，次の終了文字が入力されるまで，または次の定義済みファンクション・キーが押されるまでの間だけしか状態は有効ではありません。

/LOG (省略時の設定)

/NOLOG

キー定義が正常に作成されていることを示すメッセージを表示するかどうかを制御します。/LOG 修飾子を指定すると，メッセージが表示されます。/NOLOG 修飾子を指定すると，メッセージは表示されません。

/SET_STATE=state-name

/NOSET_STATE (省略時の設定)

キーを押して現在のキー状態を変化させるかどうかを制御します。 /SET_STATE 修飾子を指定すると，キーを押したときに現在の状態が指定の状態に変化します。/NOSET_STATE 修飾子を指定すると，現在の状態がそのまま有効になります。

/TERMINATE

/NOTERMINATE (省略時の設定)

キーを押したときに指定の文字列を終了 (処理) するかどうかを制御します。 /TERMINATE 修飾子を指定すると，キーを押したときに文字列が終了します。 /NOTERMINATE 修飾子を指定すると，Return キーを押して文字列を終了する前に他のキーを押すことができます。

説明

このコマンドを使用する前にキーパッド・モードが使用できる状態 (SET MODE KEYPAD) に設定しておかなければなりません。省略時の設定では，キーパッド・モードは使用可能です。

DEFINE/KEY コマンドを使用すれば，ファンクション・キーに文字列を割り当て，そのキーにバインドされている定義済みの機能を上書きできます。そのあと，そのキーを押すと，デバッガは現在対応づけられている文字列をコマンド行に入力します。 DEFINE/KEY コマンドは DCL コマンドのDEFINE/KEY に似ています。

定義済みのキー機能のリストについては，「CI のキーパッド定義」オンライン・ヘルプ・トピックを参照してください。

VT52 シリーズと VT100 シリーズの端末では，ユーザが使用できるファンクション・キーは数値キーパッド・キーです。これより新しい端末やワークステーションには LK201 のキーボードが備っています。 LK201 のキーボードで使用できるファンクション・キーとしては，数値キーパッド・キー全部，編集キーパッドの矢印以外のキー (Find，Insert Here など )，キーボードの上部にある F6 から F20 のキーなどがあります。

キー定義は，そのキーが再定義されるか，そのキーに対して DELETE/KEY コマンドが入力されるか，デバッガが終了されるまで有効です。デバッガ初期化ファイルなどのコマンド・プロシージャにはキー定義を含めることができます。

/IF_STATE 修飾子を使用すれば，端末で使用できるキー定義の数を増加できます。各定義が異なる状態に対応づけられているかぎり，同じキーにいくつでも定義を割り当てられます。

省略時の状態では，現在のキー状態は "DEFAULT" 状態です。現在の状態は SET KEY/STATE コマンドを使用するか，状態を変更するキー (DEFINE/KEY/LOCK_STATE/SET_STATE で定義されたキー ) を押すことにより変更できます。

関連コマンド

DELETE/KEY
(SET,SHOW) KEY

例

DBG> SET KEY/STATE=GOLD
%DEBUG-I-SETKEY, keypad state has been set to GOLD
DBG> DEFINE/KEY/TERMINATE KP9 "SET RADIX/OVERRIDE HEX"
%DEBUG-I-DEFKEY, GOLD key KP9 has been defined

この例では，SET KEY コマンドは現在のキー状態として GOLD を設定しています。/DEFINE/KEY コマンドは SET RADIX/OVERRIDE HEX コマンドを現在の状態 (GOL D) のキーパッド・キー 9 (KP9) に割り当てます。このコマンドは KP9 キーが押されると処理されます。

DBG> DEFINE/KEY/IF_STATE=BLUE KP9 "SET BREAK %LINE "
%DEBUG-I-DEFKEY, BLUE key KP9 has been defined

このコマンドは，未完成のコマンド文字列 "SET BREAK%LINE" を BLUE 状態のキーパッド・キー 9 に割り当てます。BLUE-KP9 を押したあと，行番号を入力して Return キーを押せば，SET BREAK コマンドを終了して処理することができます。

DBG> SET KEY/STATE=DEFAULT
%DEBUG-I-SETKEY, keypad state has been set to DEFAULT
DBG> DEFINE/KEY/SET_STATE=RED/LOCK_STATE F12 ""
%DEBUG-I-DEFKEY, DEFAULT key F12 has been defined

この例では，SET KEY コマンドは現在の状態として DEFAULT を設定します。DEFINE/KEY コマンドは (LK201 キーボード上の ) F12 キーを状態キーにします。DEFAULT 状態にあるときに F12 キーを押すと，現在の状態が RED になります。キー定義は終了されず，他に何の作用も持ちません ( 空文字列が F12 に割り当てられたことになります )。F12 キーを押したあと， RED 状態に対応づけられている定義を持つキーを押せば， "RED" コマンドを入力できます。

DEFINE/PROCESS_SET

シンボリック名をプロセス指定のリストに割り当てます。

形式

DEFINE/PROCESS_SET process-set-name =process-spec[,...]

パラメータ

process-set-name

プロセス指定のリストに割り当てるシンボリック名を指定します。シンボリック名は英数字とアンダスコアで構成することができます。デバッガは英小文字を英大文字に変換します。先頭文字は数字でなければなりません。シンボリック名は 31 文字を超えてはなりません。

process-spec

現在デバッガの制御下にあるプロセスを指定します。次のいずれかの形式で指定します。

[%PROCESS_NAME] process-name	スペースや小文字を含まないプロセス名。プロセス名にはワイルドカード文字 (*) を含めることができる。
[%PROCESS_NAME] " process-name"	スペースまたは小文字を含むプロセス名。二重引用符 (") の代わりに，一重引用符を (') 使用することもできる。
%PROCESS_PID process_id	プロセス識別子 (PID，16 進数)。
[%PROCESS_NUMBER] process-number (または %PROC process-number)	デバッガの制御下に入ったときにプロセスに割り当てられた番号。新しい番号は，1 から順番に各プロセスに割り当てられる。 EXIT コマンドまたは QUIT コマンドによってプロセスが終了した場合，そのデバッグ・セッション中にその番号が再割り当てされることがある。プロセス番号は SHOW PROCESS コマンドの実行で表示される。プロセスは，組み込みシンボル %PREVIOUS_PROCESS および %NEXT_PROCESS によってインデックスづけできるように，循環リスト内に順序づけされる。
process-set-name	DEFINE/PROCESS_SET コマンドで定義された，プロセスのグループを表すシンボル。
%NEXT_PROCESS	デバッガの循環プロセス・リスト中で可視プロセスの次のプロセス。
%PREVIOUS_PROCESS	デバッガの循環プロセス・リスト中で可視プロセスの前のプロセス。
%VISIBLE_PROCESS	シンボル，レジスタ値，ルーチン呼び出し，ブレークポイントなどの検索時に現在のコンテキストになっているスタック，レジスタ・セット，およびイメージを持つプロセス。

プロセスを指定しないと，シンボリック名は作成されますが，プロセス・エントリは含まれません。

説明

DEFINE/PROCESS_SET コマンドはプロセス指定のリストにシンボルを割り当てます。割り当てたシンボルは，プロセス指定のリストが許されているコマンドであればどの中でも使用できます。

DEFINE/PROCESS_SET コマンドは指定されたプロセスの有無を調べません。このため，まだ存在していないプロセスでも指定できます。

DEFINE/PROCESS_SET コマンドで定義されたシンボルを表示するには， SHOW SYMBOL/DEFINED コマンドを使用します。 DEFINE/PROCESS_SET コマンドで定義されたシンボルを削除するには， DELETE コマンドを使用します。

関連コマンド

DELETE
(SET,SHOW) DEFINE
SHOW SYMBOL/DEFINED

例

all> DEFINE/PROCESS_SET SERVERS=FILE_SERVER,NETWORK_SERVER
all> SHOW PROCESS SERVERS
 Number  Name         Hold  State   Current PC 
*    1 FILE_SERVER          step    FS_PROG\%LINE 37 
     2 NETWORK_SERVER       break   NET_PROG\%LINE 24
all>

この DEFINE/PROCESS_SET コマンドはシンボリック名 SERVERS を FILE_SERVER と NETWORK_SERVER で構成されるプロセス・グループに割り当てます。SHOW PROCESS SERVERS コマンドは SERVERS グループを構成するプロセスについての情報を表示します。

all> DEFINE/PROCESS_SET G1=%PROCESS_NUMBER 1,%VISIBLE_PROCESS
all> SHOW SYMBOL/DEFINED G1
defined G1 
    bound to: "%PROCESS_NUMBER 1, %VISIBLE_PROCESS" 
    was defined /process_set
all> DELETE G1

この DEFINE/PROCESS_SET コマンドはシンボリック名 G1 をプロセス 1 と可視プロセス ( プロセス 3) で構成されるプロセス・グループに割り当てます。SHOW SYMBOL/DEFINED G1 コマンドは定義されたシンボル G1 を表示します。DELETE G1 コマンドは DEFINE シンボル・テーブルからそのシンボルを削除します。

all> DEFINE/PROCESS_SET A = B,C,D
all> DEFINE/PROCESS_SET B = E,F,G
all> DEFINE/PROCESS_SET E = I,J,A
%DEBUG-E-NORECSYM, recursive PROCESS_SET symbol definition 
     encountered at or near "A"

この一連の DEFINE/PROCESS_SET コマンドは DEFINE/PROCESS_SET コマンドの無効な用法と有効な用法を示しています。

DELETE

DEFINE コマンドで設定されたシンボル定義を削除します。

形式

DELETE [symbol-name[,...]]

パラメータ

symbol-name

その定義を DEFINE シンボル・テーブルから削除するシンボルを指定します。ワイルドカード文字のアスタリスク (*) は使用できません。代わりに /ALL 修飾子を使用してください。/ALL を使用する場合は，シンボル名は指定できません。/LOCAL 修飾子を使用する場合，指定するシンボルは DEFINE/LOCAL コマンドで事前に定義されていたものでなければなりません。/LOCAL を指定しない場合には，指定されるシンボルは /LOCAL を指定しないで DEFINE コマンドで事前に定義されていたものでなければなりません。

修飾子

/ALL

すべてのグローバル DEFINE 定義を削除します。 /ALL/LOCAL を使用すると，現在のコマンド・プロシージャに対応づけられたローカルな DEFINE 定義はすべて削除されます ( グローバル DEFINE 定義は削除されません )。

/LOCAL

指定されたシンボルの ( ローカル ) 定義を現在のコマンド・プロシージャから削除します。指定するシンボルは DEFINE/LOCAL コマンドで事前に定義されていたものでなければなりません。

説明

DELETE コマンドはグローバルな DEFINE シンボルまたはローカルな DEFINE シンボルを削除します。グローバルな DEFINE シンボルは /LOCAL 修飾子を指定せずに DEFINE コマンドにより定義されたシンボルです。ローカルな DEFINE シンボルは DEFINE/LOCAL コマンドによりデバッガ・コマンド・プロシージャで定義されたシンボルです。そのため，その定義はそのコマンド・プロシージャ内に限定されます。

関連コマンド

DECLARE
DEFINE
SHOW DEFINE
SHOW SYMBOL/DEFINED

例

DBG> DEFINE X = INARR, Y = OUTARR
DBG> DELETE X,Y

この例では，DEFINE コマンドは X と Y をそれぞれ INARR と OUTARR に対応するグローバル・シンボルとして定義します。 DELETE コマンドはこの 2 つのシンボル定義をグローバル・シンボル・テーブルから削除します。

DBG> DELETE/ALL/LOCAL

このコマンドはすべてのローカル・シンボル定義を現在のコマンド・プロシージャから削除します。

DELETE/KEY

DELETE/KEY コマンドで設定されたキー定義および省略時にデバッガによって設定されたキー定義を削除します。

注意 このコマンドは，デバッガへの HP DECwindows Motif for OpenVMS ユーザ・インタフェースでは使用できません。

形式

DELETE/KEY [key-name]

パラメータ

key-name

キー定義を削除するキーを指定します。ワイルドカード文字のアスタリスク (*)は使用できません。代わりに /ALL 修飾子を使用してください。 /ALL を指定する場合は，キー名は指定できません。有効なキー名は次のとおりです。

キー名	LK201 キーボード	VT100型	VT52型
PF1	PF1	PF1	Blue
PF2	PF2	PF2	Red
PF3	PF3	PF3	Black
PF4	PF4	PF4
KP0--KP9	Keypad 0--9	Keypad 0--9	Keypad 0--9
KP0--KP9	キーパッドの 0〜9	キーパッドの 0〜9	キーパッドの 0〜9
PERIOD	キーパッドのピリオド (.)	キーパッドのピリオド (.)
COMMA	キーパッドのコンマ (,)	キーパッドのコンマ (,)
MINUS	キーパッドのマイナス (-)	キーパッドのマイナス (-)
ENTER	Enter	ENTER	ENTER
E1	Find
E2	Insert Here
E3	Remove
E4	Select
E5	Prev Screen
E6	Next Screen
HELP	Help
DO	Do
F6--F20	F6--F20

修飾子

/ALL

指定された状態のキー定義をすべて削除します。状態を指定しないと，現在の状態のキー定義がすべて削除されます。1 つまたは複数の状態を指定するには，/STATE=state-name を使用します。

/LOG (省略時の設定)

/NOLOG

指定されたキー定義が削除されていることを示すメッセージを表示するかどうかを制御します。/LOG 修飾子 ( これが省略時の設定 ) を指定すると，メッセージが表示されます。/NOLOG 修飾子を指定すると，メッセージは表示されません。

/STATE=(state-name [,...])

/NOSTATE (省略時の設定)

キー定義を削除したい状態を選択します。/STATE 修飾子を指定すると，指定した状態に対するキー定義が削除されます。 DEFAULT や GOLD などの定義済みキー状態またはユーザ定義状態を指定できます。状態名は適切な英数字文字列にすることができます。 /NOSTATE 修飾子を指定すると，現在の状態に対するキー定義だけが削除されます。

---

目次

索引