DLFDATA subcommand — format data lookaside facility data

Use the DLFDATA subcommand to generate diagnostic reports about activity by the data lookaside facility (DLF). Use the report type parameters to choose the information you want to see.

    DLFDATA

                { CLASS(classname)[OBJECT(objname)]    }
                { EXCEPTION }
                { STATS(classname) }
                { STORAGE(classname) }
                { SUMMARY }
                { USER(classname) }

                [ ASIDLIST(list) ]
                [ CURRENT ]
                [ ERROR ]
                [ TCBERROR ]
                [ JOBLIST(list)|JOBNAME(list) ]

              [ ACTIVE | MAIN | STORAGE          ]
              [ DSNAME(dsname) | DATASET(dsname) ]
              [ FILE(ddname) | DDNAME(ddname)    ]
              [ PATH(path-name)     ]
              [ FLAG(severity) ]
              [ PRINT | NOPRINT ]
              [ TERMINAL | NOTERMINAL  ]
              [ TEST | NOTEST ]

• Report Type Parameters

  Use these parameters to select the type of report. If you omit a report type parameter, the default is SUMMARY.

  Note: In the parameter values, classname is 1 through 7 characters, which are alphanumeric or the following:

  $  (X'5B')
  #  (X'7B')
  @  (X'7C')

  CLASS(classname)

  Produces a report with information pertaining to the DLF class specified by classname.

  OBJECT(objname)

  Is an optional CLASS report parameter. Specify OBJECT to produce information about an object stored in DLF.

  EXCEPTION

  Produces messages related to any inconsistencies IPCS finds in the DLF data.

  STATS(classname)

  Produces a report with statistics about DLF activity. If you specify classname, only statistics for the specified class are produced.

  STORAGE

  Produces a report with information about the storage management of DLF data spaces. If you specify a classname, only storage management information for the specified class is produced.

  SUMMARY

  Produces a report with overall information for each of the classes known to DLF. This is the default report.

  USER(classname)

  Produces a report with information relating to an address space that was using DLF facilities. If you specify classname, only information related to the specified class is produced.

• Address Space Selection Parameters
  Use these parameters to obtain data from particular address spaces, which you specify by their address space identifiers (ASIDs). If you omit these parameters, the default is CURRENT. For more information, see the select ASID service in z/OS MVS IPCS Customization.

  ASIDLIST(asidlist)

  Specifies a list of ASIDs for the address spaces to be included in the report. The asidlist can be a single ASID or a list of noncontiguous ASIDs. When you specify a list, separate the list members with commas.

  CURRENT

  Specifies that address spaces considered to be current by the select ASID exit service are to be included in the report.

  ERROR

  Specifies processing for any address space with an error indicator or containing a task with an error indicator.

  TCBERROR

  Specifies processing for any address space containing a task with an error indicator. Entries for address spaces with an error indicator are not formatted.

  JOBLIST(list) or JOBNAME(list)

  Specifies a list of job names whose associated address spaces are to be included in the report. Use commas to separate the job names in the list; do not enclose job names in apostrophes; and do not specify a range of job names.

• Return Codes

  See Standard subcommand return codes for a description of the return codes produced by the DLFDATA subcommand.

• Example

  See the virtual lookaside component in z/OS MVS Diagnosis: Reference for examples of the DLFDATA subcommand output.