mutex サブコマンド (dbx 用): アクティブの相互排他オブジェクトのリストを表示する

形式

mutex [number …]
mutex lock
mutex unlock
mutex wait
mutex nowait

説明

mutex サブコマンドは、アプリケーション・プログラムのアクティブの相互排他オブジェクトのリストを表示します。リストしたい相互排他オブジェクトを指定するために number パラメーターを使用しない限り、すべての相互排他オブジェクトがリストされます。lock、unlock、wait、または nowait オプションを使用することによって、ロックされている相互排他オブジェクトまたはロックされていない相互排他オブジェクトあるいは、待ち付きまたは待ちなしの相互排他オブジェクトだけを選択することができます。

mutex 変数を獲得するためには、mutex 変数が作成される前に、dbx がプログラムをデバッグ中でなければなりません。アプリケーションは、以下のいずれかの方法でコーディングされている必要があります。

C プログラムの先頭に、以下の行を追加します。
```
#pragma runopts(TEST(ALL))
```
または、
CEEXOPT マクロを呼び出すために、TEST(ALL) を指定したアセンブラー・プログラム CEEUOPT をコーディングします。このプログラムのコーディング例については、「z/OS Language Environment プログラミング・ガイド」を参照してください。

使用上の注意

mutex サブコマンドは、dbx デバッグ・プログラムの実行中にのみ実行できます。

例

すべての相互排他オブジェクトを表示するには、以下のように入力します。
```
mutex
```
相互排他オブジェクト番号 1 および番号 4 を表示するには、以下のように入力します。
```
mutex 1 4
```
ロックされている相互排他オブジェクトをすべて表示するには、以下のように入力します。
```
mutex lock
```
ロックされていない相互排他オブジェクトをすべて表示するには、以下のように入力します。
```
mutex unlock
```
待ち付きの相互排他オブジェクトをすべて表示するには、以下のように入力します。
```
mutex wait
```
待ちなしの相互排他オブジェクトをすべて表示するには、以下のように入力します。
```
mutex nowait
```