LISTEDT subcommand — format the eligible device table (EDT)

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.