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    *** ***

The report contains the following information:

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

Note: An A-I prefix indicates an IBM-supplied class.

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.

Note: If the class is not in any of the above states, the report contains a message.

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.

Note: The last two statistics, oldest object stored and object storage used, are data space related statistics. If the control space for the class is not found in the dump, the statistics each read N/A.