Array parameters are optional. They indicate whether the data consists of a single item (SCALAR) or consists of adjacent, similar items (ENTRIES).
[ ENTRIES(xx[:yy]) ]
[ [DIMENSION(nnn) | MULTIPLE(nnn)] [ENTRY(xx)] ]
[ SCALAR ]
The number of elements in the array can range from -263 to 263-1. The difference between the lower and the upper values can be no more than 15 decimal digits.
If you specify an array whose size exceeds the upper limit for the addressing mode, the subcommand changes the array to a scalar and adjusts its length to include the last valid address for that addressing mode. If you specify ENTRY or ENTRIES and SCALAR, the subcommand uses the SCALAR parameter and ignores ENTRY or ENTRIES.
list 7FFFD018. length(4) entries(6:10)
Result: Assuming that you have located a segment table at X‘7FFFD000’, LIST displays five segment table entries beginning at X‘7FFFD018’ (each segment table entry is four bytes). The total length of the five entries is 20 bytes.
If you specify an array whose size exceeds the upper limit for the addressing mode, the subcommand changes the array to a scalar and adjusts its length to include the last valid address for that addressing mode.
equate sgt001 5d7c00. absolute length(4) dimension(256)
Result: Assuming that the master segment table is located at X‘5D7C00’ in absolute storage with a length of 4 and a dimension of 256, EQUATE defines the master segment in the symbol table with these attributes.
If you specify SCALAR and either ENTRY or ENTRIES, the subcommand uses the SCALAR parameter and ignores ENTRY or ENTRIES.
list a72f4. asid(1) length(x'50') area scalar
Result: LIST displays the storage as a single entity of non-repeating fields, beginning at the absolute address X‘A72F4’ for a length of 80 (X‘50’) bytes.