DLFDATA CLASS subcommand output

The CLASS reports provide status information pertaining to the requested DLF class. This topic shows reports for the following subcommands:

DLFDATA CLASS(class)
DLFDATA CLASS(class) OBJECT(name)

DLFDATA CLASS(COFGSDO) produces the following report.

  BLS18077I DLFDATA processing may not be valid for a VIRTUAL dump

  *** ***    FORMAT DLFDATA    *** ***

     Data Lookaside Facility (DLF)

     DLF address space = ASID(X'000F')

  DLFDATA subcommand

  ****************************************************************
  *                                                              *
  *                     DLF Class Report                         *
  *                                                              *
  ****************************************************************

    Class: COFGSDO

    Class state: Class is defined.

    Maximum expanded:                   524288
    Current expanded:                        0
    Current largest object:                256

    Connect exit:                     COFMCXIT
    Current connects:                        0
    Maximum active connects:                 1
    Failed  connects:                        0

Shared objects in the class:                        Connects
      C'SHARED 1MB RETAINED OBJECT CONNSPMR'                  18

    Total number of objects found :          1

  *** ***    END OF DLFDATA    *** ***

The following information appears in the report:

CLASS: This is the name of the DLF class. A class name is 7 alphanumeric characters and is specified in a COFDLFxx parmlib member. COFGSDO is the only valid DLF class.

CLASS STATE: There is only one DLF class state:

Defined - The class is active and available for use.

STATISTICS: This section of the report provides selected DLF statistics for the class.

Maximum expanded - The maximum number of 4-kilobyte blocks of expanded storage that may be used by DLF.
Current expanded - The number of 4-kilobyte blocks of expanded storage that is assigned to DLF and that currently contains cached data.
Current largest object - The size of the largest object that has been connected since DLF was started. This object is not necessarily currently connected.

Note: The above maximum values are specified in the COFDLFxx parmlib member.

CONNECT EXIT: This section of the report provides selected DLF connect statistics for the class.

Current connects - The number of objects currently connected.
Maximum connects - The peak number of concurrent connects to all objects.
Failed connects - The number of connect requests that have been unsuccessful.

SHARED OBJECTS: This is a list of the currently connected or retained shared objects that belong to the class.

If the object name can be translated to characters, it appears in the report as C‘shared object name’.
If the object name cannot be translated to characters, it is converted to hexadecimal and appears in the report as X‘converted shared object name’.

The total number of shared objects found in the dump is shown at the end of the report.

DLFDATA CLASS(COFGSDO) OBJECT(‘SHARED 1MB RETAINED OBJECT CONNSPMR’) produces the following report.

  BLS18077I DLFDATA processing may not be valid for a VIRTUAL dump

  *** ***    FORMAT DLFDATA    *** ***

     Data Lookaside Facility (DLF)

     DLF address space = ASID(X'000F')

  DLFDATA subcommand

  ****************************************************************
  *                                                              *
  *                  DLF Class Object Report                     *
  *                                                              *
  ****************************************************************

  Class: COFGSDO

    Class state: Class is defined.

    Maximum expanded:                   524288
    Current expanded:                        0
    Current largest object:                256

    Connect exit:                     COFMCXIT
    Current connects:                        0
    Maximum active connects:                 1
    Failed  connects:                        0

  OBJECT:

  C'SHARED 1MB RETAINED OBJECT CONNSPMR'

  Object is shared

    Total users of the object:    18

    Object size in blocks:          256
    Object status:           Connected
    Access mode:             Update
    Storage key:                 0
    Disconnect with RETAIN:  Allowed
    Control data space name: Not requested

    Hiperspaces containing the object:
                             00000COF

******************************************************************

                                ASID: X'000E'

      No objects found for specified ASID

  ****************************************************************

                                ASID: X'000F'

      No objects found for specified ASID

  ****************************************************************

  *** ***    END OF DLFDATA    *** ***

The following information appears in the report:

OBJECT: This is the object name that was specified on the DLFDATA subcommand for which information is requested.

If the object name can be translated to characters, it appears in the report as C‘object name’.
If the object name cannot be translated to characters, it is converted to hexadecimal and appears in the report as X‘converted object name’.

OBJECT SIZE: This is the size of the space obtained for the DLF object in 4-kilobyte blocks.

OBJECT STATUS: There are three DLF object states:

Connected - The object is currently connected.
Connect in progress - The COFCONNE macro has been issued for this object, but has not completed processing.
Disconnect in progress - The COFDISCO macro has been issued for this object, but has not completed processing.

ACCESS MODE: There are two types of access modes:

Update - The user requested UPDATE access.
Read - The user requested READ access.

STORAGE KEY: This is the storage key of the space or spaces that comprise the data object.

RETAIN® OPTION: This field indicates whether the installation-defined Resource Access Control Facility (RACF®) profile has been set up to allow the DELOPT=RETAIN option on a disconnect of the object. If the field is:

Allowed - RETAIN is allowed on a disconnect.
Not allowed - RETAIN is not allowed on a disconnect.

CONTROL SPACE: If the CNTLDSPC(YES) option was specified on the COFCONNE macro, this field contains the name of the requested control data space. If CNTLDSPC(NO) was specified, then this field contains Not Requested.

SPACES CONTAINING OBJECT: This is a list of the Hiperspace™ names of the storage spaces that contain the object.