Use the LISTEDT subcommand to display information from the eligible
device table (EDT). You can access the EDT in a dump data set or in
active storage.
The system can have two EDTs during a dynamic configuration change.
You must distinguish between formatting a primary EDT and a secondary
EDT.
Each EDT is divided into subtables, which you can format separately
with LISTEDT.
See the allocation/unallocation component in
z/OS MVS Diagnosis: Reference for
information about primary and secondary EDTs. Also, see
z/OS MVS™ Data
Areas in z/OS® Internet
Library at
http://www.ibm.com/systems/z/os/zos/bkserv/ for
information about the EDT.
- Syntax
LISTEDT
[ PRIMARY | SECONDARY ]
-------- Data Selection Parameters -------------------------
[ COMPGENS[(index-number-list)] ]
[ DETAIL ]
[ DEVNUM[(index-number-list)] ]
[ DEVPOOL[(index-number-list)] ]
[ GENERIC[(index-number-list)] ]
[ GROUP[(index-number-list)] ]
[ GRPMSK[(index-number-list)] ]
[ GRPPTR[(index-number-list)] ]
[ GRPCONV[(index-number-list)] ]
[ HEADER ]
[ LIBRARY[(index-number-list)] ]
[ LUV[(index-number-list)] ]
[ PREF[(index-number-list)] ]
[ SHOWDEVN(device-number-list) ]
[ SHOWGRPN[(group-number-list)] ]
[ SUMMARY[(unit-name-list)] | SHOWUNIT[(unit-name-list)] ]
[ TAPE ]
-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.
[ ACTIVE | MAIN | STORAGE ]
[ DSNAME(dsname) | DATASET(dsname) ]
[ FILE(ddname) | DDNAME(ddname) ]
[ PATH(path-name) ]
[ FLAG(severity) ]
[ PRINT | NOPRINT ]
[ TERMINAL | NOTERMINAL ]
[ TEST | NOTEST ]
- Parameters
- PRIMARY or SECONDARY
- Specifies the EDT that is to be formatted. The types of EDTs
are:
- Primary EDT: processes all current and new allocation
requests.
- Secondary EDT: processes all allocation requests issued
before a dynamic configuration change.
PRIMARY is the default. If you specify SECONDARY and no secondary
EDT exists in the source storage or dump, IPCS displays message IEF10010I
in the report.
- Data Selection Parameters
Use these parameters to limit
the scope of the data in the report. If you omit a data selection
parameter, the default is HEADER.
In the data selection parameter
descriptions, index-number-list is one or more
1- to 4-digit hexadecimal numbers, ranges of numbers, or both. Each
index number corresponds to an index for a sub-table entry. If you
omit index-number-list, IPCS formats the entire
sub-table.
The
index-number-list can be a
single number, a range of numbers, or a list of numbers. When you
specify a range, separate the first and last numbers in the range
with a colon. When you specify a list, separate the numbers with
commas. The number or numbers are enclosed in parentheses.
- COMPGENS
- Specifies that the compatible-generic section of the EDT appears
in the output. Generics are compatible when a data set can be allocated
to any generic.
- DETAIL
- Specifies that all the subtables in the EDT appear in the output.
- DEVNUM[(index-number-list)]
- Specifies that the device number section appears in the output.
- DEVPOOL[(index-number-list)]
- Specifies that the system-managed type library device pool entries
in the EDT appear in the output. Each pool represents a set of tape
drives within a library. In the output, look-up-value entry indexes
refer to the output of the LUV parameter of the LISTEDT subcommand.
- GENERIC[(index-number-list)]
- Specifies that the generic section of the EDT appears in the output.
- GROUP[(index-number-list)]
- Specifies that the group section of the EDT appears in the output.
- GRPCONV[(index-number-list)]
- With Version 4.2.0 or a later release, specifies that the group
mask conversion table appears in the output. This table exists only
after a dynamic configuration change.
- GRPMSK[(index-number-list)]
- Specifies that the group mask table appears in the output.
- GRPPTR[(index-number-list)]
- Specifies that the group pointer table of the EDT appears in the
output.
- HEADER
- Specifies that the EDT header appears in the output.
- LIBRARY[(index-number-list)]
- Specifies that the system-managed tape library entries in the
EDT appear in the output. The entries include indexes for the related
system-managed tape library device pool entries.
- LUV[(index-number-list)]
- Specifies that the look-up value section of the EDT appears in
the output.
- PREF[(index-number-list)]
- Specifies that the preference table appears in the output.
- SHOWDEVN(device-number-list)
- Lists the group number to which each device number in the device-number-list belongs. device-number-list must
be specified and should consist of one or more 1- to 4-digit hexadecimal
device numbers, ranges of numbers, or both.
- SHOWGRPN[(group-number-list)]
- Lists the unit names associated with each of the group numbers
in the group-number-list. The group-number-list is
one or more 1- to 4-digit hexadecimal numbers, ranges of numbers,
or both. If you do not supply group-number-list,
IPCS formats information for all the device groups in the system.
- SUMMARY[(unit-name-list)] | SHOWUNIT[(unit-name-list)]
- Produces a summary report for all the unit names in the unit-name-list.
The unit-name-list is one or more 1- to 8-character
alphanumeric unit names. Separate multiple list items with one or
more commas, blanks, or tab characters (X'05'). If you do
not supply unit-name-list, IPCS formats information
for all unit names in the system.
- TAPE
- Requests formatting of the tape maximum eligibility table. The
output includes tape device information such as density and device
type.
- Return Codes
See Standard subcommand return codes for
a description of the return codes produced by the LISTEDT subcommand.
- Example: Display
information for device numbers 0001 through 0006 and 0021 through
0028 in the secondary EDT.
- Action
COMMAND ===> listedt secondary devnum(0001:0006,0021:0028)
- Result
See the allocation/unallocation component in z/OS MVS Diagnosis: Reference for
an example of LISTEDT output.