LIST LOGSTREAM keywords and parameters

The LIST LOGSTREAM specification requests that an entry for a log stream be listed in SYSPRINT output. The keywords are explained as follows:

NAME(streamname)

Specifies the name of the log stream you want to list. You will get the log stream definition from the LOGR policy in the output. NAME is required.

A log stream name can be specified with wildcards. See Using wildcards with the LIST request.

DETAIL(NO)

DETAIL(YES)

Specifies whether you want detailed information about the log stream from the LOGR policy.

If you specify DETAIL(NO), which is the default, the output will only include the log stream definition.

If you specify DETAIL(YES) the output will include the log stream data as well as the definition.

LISTCAT

Specifies that LISTCAT output messages should be provided in the output for each log stream offload data set. Use this option when DETAIL(YES) is specified. If DETAIL(NO) is used, the LISTCAT parameter is ignored. When the LISTCAT parameter is used, system logger requests the equivalence of the following command from IDCAMS system services VSAM utility:

LISTCAT ENTRIES(log-stream-data-set-name) ALL

The combined logger and catalog information in the SYSPRINT output allows for easier determination of data sets that need attention or correction by the systems programmer. For samples and description of the output, see the LISTCAT (IDCAMS) messages for offload data sets topic in z/OS MVS Diagnosis: Reference.

It is recommended that you use wildcards on the NAME keyword only if necessary because the LISTCAT option can produce a large amount of output for each log stream offload data set.