LIST コマンド
LIST コマンドは、フォーマット・ユーザー出口で、分析後の障害環境からストレージ域を印刷するために使用できます。
パラメーター
- アドレス 開始:終了
- 定位置パラメーターとして、開始アドレスまたはアドレス範囲のいずれかを指定します。このアドレスは、ADDRESS キーワードの使用に代わる方法です。有効な構文の詳細については、次の ADDRESS を参照してください。
- ADDRESS(アドレス) ADDRESS(アドレス:アドレス)
- 印刷されるストレージのアドレスを指定します。単一のアドレスまたはアドレス範囲のいずれかを指定します。
address パラメーターは 64 ビット対応です。詳しくは、64 ビット・アドレスの指定を参照してください。アドレスには、オプションでその後にピリオドを追加できます (例えば「000176C0.」)。
- LENGTH(長さ)
- 印刷されるバイト数を指定します。16 進数の値 (インディケーターを X'…' で付加) または 10 進数の値 (インディケーターは不要) のいずれかで指定します。アドレスの範囲が指定されている場合、LENGTH の指定は無視されます。
- POSITIONs(位置) POSITIONs(位置:位置)
- 開始アドレスから、印刷されるストレージの最初のバイトまでのオフセットを指定します。単一のオフセットまたはオフセット範囲のいずれかで指定します。POSITION と POSITIONS の両方が有効です。
オフセットはすべて、16 進数 (インディケーターを X'…' で付加) または符号付 10 進数 (オプションで、インディケーターを F'…' で付加) のいずれかで指定する必要があります。
- DSECT(dsect_name) DSECT(dsect_name data_set_name)
- 要求されたアドレスでストレージをフォーマットする際に使用される DSECT マッピング・メンバーの名前を指定します。
データ・セット名を指定しない場合、IDIDSECT DDname 名で DSECT が使用可能である必要があります (詳細については、DataSetsを参照してください)。または、DSECT が指定されたデータ・セット名の中に存在する必要があります。
- ALIGN(AUTO | LEFT)
- 16 進データの位置合わせを指定します。
- AUTO
- 位置合わせは、リストされたアドレスと使用可能なレポート幅によって決まります。これはデフォルトです。
- LEFT
- 16 進データは無条件に左寄せされます。
あるパラメーターが複数回指定された場合、最後に指定されたパラメーターのみが有効になります。
DSECT パラメーターが指定されなかった場合、ストレージは (実行中の障害分析タイプで優先されるフォーマット幅に依存して) 1 行 16 バイトまたは 32 バイトでフォーマットされ、16 進と EBCDIC の両方の値が表示されます。
DSECT パラメーターが指定された場合、ストレージは DSECT コマンドが使用されたときと同様にフォーマットされて表示されます。詳しくは、DSECT 情報を使用したストレージ域のマッピングを参照してください。
戻りコード
LIST コマンドでは以下の戻りコードが使用されます。
- 0
- コマンドは正常に終了しました。
- 4
- DSECT フォーマット処理中にエラーが発生しました。エラーの説明が IDITRACE DDname に書き込まれます。
- 12
- コマンド構文エラーです。エラーの説明が IDITRACE DDname に書き込まれます。
例
/* REXX */
"LIST 0 LENGTH(128)"
上記の例によって、下記のような出力が作成されます。
Address Offset Hex EBCDIC
00000000 040C0000 810692C8 00000000 00000000 *....a.kH........*
00000010 +10 00FC7F08 00000000 070C1000 85532492 *..".........e..k*
00000020 +20 078D0000 00FC7F5A 078D1000 8775BB42 *......"!....g...*
00000030 +30 00000000 00000000 070C0000 85532496 *............e..o*
00000040 +40 00000000 00000000 00000000 00FC7F08 *..............".*
00000050 +50 00000000 00000000 040C0000 810676D0 *............a..}*
00000060 +60 040C0000 80FFB080 00080000 BF286880 *................*
00000070 +70 00080000 BF287940 040C0000 81068A00 *......` ....a...*