Obtaining information from the control data sets

Use the LIST command to obtain information from the control data sets. Information can be about:

In obtaining the information, you can receive it in any of three ways: as a printed listing, as a DASD data set, or as terminal output. For small amounts of data, such as DFSMShsm host serialization information or user-authorization information, terminal output is satisfactory. However, the LIST command is capable of producing very large amounts of information, for example, when you request information about all migration volumes. For such requests, you want to be sure to direct the output to either a printed listing or a DASD data set that you can edit or print later.

The parameters that control the destination for the LIST command output are the same for any request. In showing the forms of the command for each type of output, all other parameters (such as request) are being identified.

The form of the command for obtaining terminal output is:
LIST (request) TERMINAL
The form of the command for obtaining a printed listing is:
LIST (request) SYSOUT

LIST (request) SYSOUT(class)

The first form of the command directs the printed output to the SYSOUT class specified with the SETSYS command. The second form of the command specifies a SYSOUT class to which the output is directed.

The form of the command to direct the output to a DASD data set is:
LIST (request) OUTDATASET(dsname)

dsname is the fully qualified name of the data set to which you want the LIST command output sent. If the data set exists, DFSMShsm places the report at the end of the existing data set. If the data set does not exist, DFSMShsm dynamically allocates and catalogs an output data set.

Related reading

For more information about the LIST command, see LIST command: Listing information from the MCDS, BCDS, and OCDS.