VLFDATA SUMMARY subcommand output

This report provides status information for each class specified in a COFVLFxx parmlib member. A VLF class is a collection of VLF-related objects, usually associated with a particular component, subsystem, or application. VLF classes are one of two types:

• PDS - A correspondence exists between the VLF major names for the class and partitioned data sets (PDS). The minor names for a class correspond to the members of a PDS. PDS classes are defined in a COFVLFxx parmlib member using the EDSN keyword for major names.
• Non-PDS - There is no correspondence between the VLF major names for the class and any data set structure. Non-PDS classes are defined in a COFVLFxx parmlib member using the EMAJ keyword for major names.

Enter either of the following IPCS subcommands to obtain this report:

VLFDATA
VLFDATA SUMMARY

*** ***    FORMAT DUMP OF VLF DATA    *** ***
BLS18077I VLFDATA processing may not be valid for a VIRTUAL dump


   VIRTUAL LOOKASIDE FACILITY (VLF)

   VLF ADDRESS SPACE = ASID(X'000B')


 *******************************************************************
 *                                                                 *
 *                       VLF Summary Report                        *
 *                                                                 *
 *******************************************************************

CLASS : CLASS2
CLASS TYPE   : NON-PDS
CLASS STATE  : Class has never been defined.

DATA SPACES OWNED
  Control data space                          : CCLASS2
  Object data space                           : DCLASS2

Number of eligible major names for this class :          2

USAGE STATISTICS
  Successful DEFINE requests                  :          0
  Available object storage used               :        N/A

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


                    CLASS : CLASS1
CLASS TYPE   : NON-PDS
CLASS STATE  : Class is defined.

DATA SPACES OWNED
  Control data space                          : CCLASS1
  Object data space                           : DCLASS1

Number of eligible major names for this class :          5

USAGE STATISTICS
  Successful DEFINE requests                  :          1
  Available object storage used               :        0.6 %

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

                    CLASS : IKJEXEC
CLASS TYPE   : PDS
CLASS STATE  : Class is defined.

DATA SPACES OWNED
  Control data space                          : CIKJEXEC
  Object data space                           : DIKJEXEC

Number of eligible major names for this class :          2

USAGE STATISTICS
  Successful DEFINE requests                  :          1
  Available object storage used               :        N/A


 MESSAGES:

COF11000I Report may be incomplete due to unavailable data.

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

*** ***    END OF VLF DATA    *** ***

CLASS: This is the name of a VLF class. A class name is specified in a COFVLFxx parmlib member.

CLASS TYPE: VLF classes may be either:

• A set of related PDSs as specified with the EDSN keyword in a COFVLFxx parmlib member.
• A named collection of data as specified with the EMAJ keyword in a COFVLFxx parmlib member.

CLASS STATE: The 5 recognizable VLF class states are:

• Defined - The class is active and available for use.
• Being Defined - The COFDEFIN macro has been invoked for this class, but has not completed processing.
• Being Purged - The COFPURGE macro has been invoked for this class, but has not completed processing.
• Previously Defined - The class was defined and purged, and has not been redefined.
• Never Defined - The class is listed as a VLF class in a COFVLFxx parmlib member, but has never been defined.

DATA SPACES OWNED: These are the names of the two data spaces used by the VLF class. Each name is comprised of a prefix followed by the class name. The prefix is one of the following values:

• C - Contains the control data for the class.
• D - Contains the user objects for the class.

USAGE STATISTICS: This section provides selected VLF statistics for the class. The possible statistics displayed are:

• Successful define requests - The number of times that the class has been successfully defined to VLF.
• Successful object RETRIEVE requests - The number of times objects have been retrieved from the class.
• Successful object CREATE requests - The number of times objects have been created for the class.
• Unsuccessful object CREATE requests - The number of times that requests to create an object failed for this class. The reasons for failure are the following:
  • No pending create - A RETRIEVE request was not done prior to the CREATE as required, the CREATE PENDING timed out, or a NOTIFY was received for the major and/or minor before the CREATE completed.
  • Major name not in search order - The major name specified for the CREATE is not in the user's search order.
• Oldest object stored - The time of last reference for the last recently used object at the time the object space was last reclaimed. The format is mm/dd/yy hh:mm:ss.
• Available object storage used - The percentage of object storage that is currently in use.