TEST—LIST subcommand operands

address

specifies the location of data that you want displayed at your terminal or placed into a data set.

address:address

specifies that you want the data located between the specified addresses displayed at your terminal or placed into a data set.

(address)

specifies several addresses of data that you want displayed at your terminal or placed into a data set. The data at each location is retrieved. If the first address of a range is a register, the second address must also be the same type of register (floating-point, general, or vector). The list of addresses must be enclosed within parentheses, and the addresses must be separated by standard delimiters (one or more blanks or a comma).

If a range of addresses is specified on LIST and the ending address is in fetch protected storage, you are prompted (if in PROMPT mode) to reenter the address. If you want a range of addresses, you must reenter the range, not just the ending address.

You can create a load module that contains more than one DSECT or CSECT within the same symbolic name. When you list an unqualified symbolic address in a load module, the LIST command displays the area associated with the first occurrence of the symbol. Use the fully-qualified name, ‘module_name.csect.symbol_name’, to display occurrences other than the first.

For address, address:address, (address), specify address as:

An absolute address
A symbolic address
A relative address
An indirect address
An address expression
A module name and entry name (separated by a period)
An entry name (preceded by a period)
A general register
A floating-point register
A vector register
A vector register element
An access register
The vector mask register.

data_type

specifies the type of data that is in the specified location. Indicate the type of data using one of the following codes:

Code	Type of data	Maximum length (Bytes)
C	Character	256
X	Hexadecimal	256
B	Binary	256
I	Assembler instruction	256
H	Fixed point binary (halfword)	8
F	Fixed point binary (fullword)	8
E	Floating point (single precision)	8
D	Floating point (double precision)	8
P	Packed decimal	16
Z	Zoned decimal	16
A	Address constant	4
S	Address (base + displacement)	2
Y	Address constant (halfword)	2
XC	Hexadecimal and EBCDIC	256

All accepted data_types allow the specified address to be aligned on a byte boundary even though certain data_types cannot be assigned to a byte boundary. The default for data_type is hexadecimal.

The XC data_type indicates that you want to display, side-by-side, the hexadecimal and EBCDIC contents of storage. The contents are displayed in hexadecimal first, followed by EBCDIC.

A general register is displayed in decimal format if the F data_type is used. Otherwise, regardless of the type specified, a general register is displayed in hexadecimal. Floating-point registers are listed in floating-point format if data_type is not specified. However, floating-point registers can be listed in hexadecimal format by using the X data_type. If any data_type other than D, E, or X is specified for floating-point registers, data_type is ignored and the register is listed in floating-point format.

For vector registers, if you do not specify the data_type, then LIST displays them in floating-point format. You can display vector registers in hexadecimal for both single (V) and double (W) precision registers. You can also display single precision (V) registers in fixed-point binary. If you specify another data type, LIST ignores it. For more information about programming considerations for using the Vector facility, see z/OS TSO/E Programming Guide.

Specify 0m to display the vector mask register. It can be displayed in hexadecimal or binary format.

Access registers (A) are displayed in decimal if you specify the F data_type. Otherwise, they are displayed in the default data_type, hexadecimal.

If an area is to be displayed using the I data_type and the area contains a not valid op code, only the area up to that not valid op code is displayed.

ALET(alet_value)

specifies that the contents of storage in an alternate address/data space are to be displayed. You can specify from 1 to 8 hexadecimal characters to represent the alet_value.

The alet_value used to reference storage appears at the far right of the display of storage. If you display storage in the primary address space, the alet_value is zeros. If you display storage in an alternate address/data space, the alet_value is the hexadecimal value you specified. ALET and AR are mutually exclusive.

Note: The alet_value is displayed whenever storage is listed, not only when you specify the ALET or AR keywords.

AR(register_number)

specifies the access register number used to reference data in an alternate address/data space. Valid register numbers for AR are 0 through 15.

The alet_value in the access register used to reference storage appears at the far right of the display of storage. If you display storage in the primary address space, the alet_value is zeros. If you display storage in an alternate address/data space, the alet_value is the hexadecimal value of the data in the access register. AR and ALET are mutually exclusive.

Note: The alet_value is displayed whenever storage is listed, not only when you specify the AR or ALET keywords.

LENGTH(integer)

indicates the length, in bytes, of the data that is to be listed. If you use a symbolic address and do not specify LENGTH, the value for the LENGTH operand is retrieved from the internal TEST symbol table or from the length associated with a symbol in a program. Otherwise, the following default values apply:

Type of data	Default length (bytes)
C,B,P,Z	1
H,S,Y	2
F,E,A,X	4
D	8
I	variable
XC	4

When the data_type is I, either LENGTH or MULTIPLE can be specified, but not both. If both are specified, the MULTIPLE operand is ignored, but no error message is printed.

MULTIPLE(integer)

Use with the LENGTH operand. It gives you the following options:

The ability to format the data to be listed (see Example 8).
A way of printing more than 256 bytes at a time. The value you specify for the integer determines how many lengths or multiples of data_type you want listed. The value supplied for the integer cannot exceed 256.

For I type data, the value supplied for MULTIPLE defines the number of instructions to be displayed. If you use a symbolic address and do not specify either LENGTH or MULTIPLE, the length retrieved from the internal TEST symbol table or from the program is used and multiplicity is ignored.

PRINT(data_set_name)

specifies the name of a sequential data set to which the data is directed. If you omit this operand, the data is directed to your terminal.

The data format is blocked variable-length records. Old data sets with the fixed standard record format and block size are treated as NEW, if they are being opened for the first time. Otherwise, they are treated as data sets being modified.

If PRINT(data_set_name) is specified, use the following table to determine the format of the output.

If the data_set_name is not specified within quotation marks, the descriptive qualifier TESTLIST is added.

If your record type was:	Fixed, fixed blocked, or undefined		Variable or variable-blocked
Then it is changed to variable-blocked with the following attributes:	Recordsize 125	Blocksize 1629	Recordsize 125	Blocksize 129

Record and block sizes greater than those specified in the preceding table are unchanged.

The specified data set is kept open until:

The TEST session is ended by a RUN or END subcommand, or
A LIST, LISTDCB, LISTDEB, LISTMAP, LISTPSW, LISTTCB, or LISTVSR subcommand is entered specifying a different PRINT data set. In this case, the previous data set is closed and the current one is opened.

Notice that "P" is not a valid truncation for the PRINT operand on the LIST subcommand because the single letter "P" may be used as a data_type specifying that the data to be listed is in packed decimal format. See also Example 6.