List command

The List command can be used to by a Formatting user exit to print storage areas from the analyzed fault environment.

Read syntax diagramSkip visual syntax diagram
Syntax

                                  .------------------------------------------------.   
                                  V                                                |   
>>-List--+---------------------+----+-ADDRESS--(--+-address-------------+--)-----+-+-><
         +-address-------------+    |             '-address--:--address-'        |     
         '-address--:--address-'    +-LENGTH--(--length--)-----------------------+     
                                    +-POSITIONs--(--+-position--------------+--)-+     
                                    |               '-position--:--position-'    |     
                                    '-DSECT--(--dsect_name--+---------------+--)-'     
                                                            '-data_set_name-'          

Parameters

address
start:end
Specifies either the start address, or an address range, as a positional parameter. This address is an alternative to using the ADDRESS keyword. See ADDRESS below for details about valid syntax.
ADDRESS(address)
ADDRESS(address:address)
Specifies the address of the storage to be printed. Specify either a single address or as an address range.

The address parameter is 64-bit enabled. For details, see Specifying 64-bit addresses. The address may optionally followed by a period (for example, "000176C0.").

LENGTH(length)
Specifies the number of bytes to be printed. Specify as a hexadecimal value (indicated by X'…') or as a decimal value (no indication required). If an address range is specified, then specification of LENGTH is ignored.
POSITIONs(position)
POSITIONs(position:position)
Specifies the offset from the start address to the first byte of storage to be printed. Specify as either a single offset or as an offset range. Both POSITION and POSITIONS are accepted.

All offsets must be either hexadecimal (indicated by X'…') or signed decimal (optionally indicated by F'…').

DSECT(dsect_name)
DSECT(dsect_name data_set_name)
Specifies the name of a DSECT mapping member to be used when formatting storage at the requested address.

If a data set name is not specified, then the DSECT must be available through the HFZDSECT DDname (for details, see DataSets). Otherwise, the DSECT must exist in the specified data set name.

If a parameter is specified multiple times, then only the last specification takes effect.

If the DSECT parameter is not specified, then storage is formatted with either 16 or 32 bytes per line (depending on preferred formatting width specification for the type of fault analysis being performed), showing both hexadecimal and EBCDIC values.

If the DSECT parameter is specified, then storage is shown formatted the same as if the DSECT command was used. For details, see Mapping storage areas using DSECT information.

Return codes

The List command provides the following return codes:
0
Command completed successfully.
4
An error occurred during DSECT formatting. An explanation of the error is written to the HFZTRACE DDname.
12
Command syntax error. An explanation of the error is written to the HFZTRACE DDname.

Example

Figure 1. List command example
/* REXX */

"LIST 0 LENGTH(128)"
The above example might produce the following output:
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...*