VLFDATA CLASS subcommand output

The CLASS reports provide status information pertaining to the requested VLF class. The level of detail included in the reports is determined by the other keywords specified.

The reports produce a header containing class-related information and usage statistics. This is followed by more detailed information regarding major names and minor names in the class, depending on the options specified on the VLFDATA subcommand.

Examples of how you can request various reports for a single class are:

VLFDATA CLASS(CLASS1) SHORT
VLFDATA CLASS(CLASS1) MAJOR(X'TESTMAJ1')
VLFDATA CLASS(CLASS1) MAJOR(MAJ1) MINOR(MIN0)
VLFDATA CLASS(CLASS1) MINOR(MIN0)
VLFDATA CLASS(CLASS1) ALL

Note: The VLF summary report can be used to view a summary of all VLF classes.

VLFDATA CLASS(CLASS1) ALL produces the following report:

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

                    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
  Successful object RETRIEVE requests         :         35
  Successful object CREATE requests           :         35
  Unsuccessful object CREATE requests
        No pending create                     :          0
        Major name not in search order        :          0
  Oldest object stored (timestamp)            : 01/27/90 15:57:36
  Available object storage used               :        0.6 %


 Major/minor pairs currently existing in VLF for class CLASS1

MINOR :

     C'BCDE'

N O     Major names associated with minor name
------------------------------------------------------------------
 | |
 | |    C'TestMaj1'

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

MINOR :

     C'CDEF'


N O     Major names associated with minor name
-------------------------------------------------------------------
 | |
 | |    C'TestMaj2'

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

MINOR :

     C'MIN0'

N O     Major names associated with minor name
-------------------------------------------------------------------
 | |
 | |    C'TestMaj1'
 | |
 | |    C'TestMaj2'
 | |
 | |    C'MAJ1'
 | |
 | |    C'MAJ2'

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

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

For descriptions of the following fields, see VLFDATA SUMMARY subcommand output.

CLASS
CLASS TYPE
CLASS STATE
DATA SPACES OWNED
USAGE STATISTICS

The following information also appears in this report:

I T M USERS: This table appears for the SHORT option or the default. The table lists all major names that are eligible to have objects placed into VLF for this class. An * in one of the ITM columns indicates a problem was found with the major name listed to the right. A ? in one of the ITM columns indicates the information is not available. The following columns appear in the table:

I (A valid major name entry does not exist for the class.)
T (The major name entry for the class does not match the class type.)
M (The major name entry for the class does not relate to a major name known to VLF.)
USERS (The number of identified users of the major name.)

MAJOR: These are the major names that are found in the identified user's search order.

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

MINOR: The minor name specified on the VLFDATA subcommand.

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

OBJECT STATISTICS: This section appears when both the MAJOR and MINOR keywords are specified on the VLFDATA subcommand. It provides selected statistics for a VLF object that represents the specified major/minor name pair for the given class.

Object Size (The size of the VLF object in bytes.)
Time of Last Retrieve (The time that the object was last retrieved from VLF. If the object has never been retrieved, then it is the time that the object was created. The form is mm/dd/yy hh:mm:ss).

R N O TABLE: This table appears if only the MAJOR keyword is specified on the VLFDATA subcommand. The table lists all the minor names associated with the specified major name for the given class. An * in one of the columns has the following meanings for the associated major/minor name pair:

R (The object has never been retrieved from VLF.)
N (The pointer to the object is null.)
O (he pointer to the object contains a value outside the range of object storage addresses.)

N O TABLE: This table appears if the ALL keyword or only the MINOR keyword is specified on the subcommand. The table lists all majors that are associated with the specified minor name for the given class. An * in one of the columns indicates a problem was found with the associated major/minor name pair.

N (The pointer to the object is null.)
O (The pointer to the object contains a value which is outside the range of object storage addresses.)