LIST コマンド

LIST コマンドは、フォーマット・ユーザー出口で、分析後の障害環境からストレージ域を印刷するために使用できます。

1. Syntax

1  List
2.1 address
2.1  address : address
2.1+ 
2.1  ADDRESS (
2.2.1 address
2.2.1  address : address
2.1 )
2.1  LENGTH ( length )
2.1  POSITIONs (
2.2.1 position
2.2.1  position : position
2.1 )
2.1  DSECT ( dsect_name? data_set_name )
2.1  ALIGN (
2.2.1 AUTO
2.2.1 LEFT
2.1 )

パラメーター

アドレス 開始:終了
定位置パラメーターとして、開始アドレスまたはアドレス範囲のいずれかを指定します。このアドレスは、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 に書き込まれます。

2. LIST コマンドの例
/* 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...*