z/OS DFSMSdfp Advanced Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Data Return Area

z/OS DFSMSdfp Advanced Services
SC23-6861-01

If you provide a data return area with the DATA or EXPDATA keywords, LSPACE returns the information shown below. The expanded data return area is provided only when EXPDATA is specified. EXPDATA is the recommended keyword for returning binary data from LSPACE.
Table 1. LSPACE Data Return Area Format
Name Offset Bytes Description
LSPDRETN 0(X'00') 1 Return area status byte
LSPDSPAC   1 . . . . . . . Returned space information
LSPDF0CN   . 1 . . . . . . Returned F0 DSCB count
LSPDVRCN   . . 1 . . . . . Returned free VIR count
LSPDFRGI   . . . 1 . . . . Returned fragmentation index
LSPDCYLM   . . . . 1 . . . Returned data is for a volume with cyl-managed space
LSPDRRES   . . . . . x x x Reserved
LSPDSTAT 1(X'01') 1 Volume status byte
LSPDIXDS   1 . . . . . . . Index exists for VTOC
LSPDIXAC   . 1 . . . . . . Index VTOC active
LSPDSRES   . . x x x x x x Reserved
LSPDRSV1 2(X'02') 2 Reserved
       
Beginning of the base data return area: For DATA and EXPDATA requests, the following 32 bytes if requested or defaulted by the DATATYPE keyword will be returned. They represent statistics that describe the entire volume. LSPDFOS and LSPDVIRS are not applicable to volume statistics.
LSPDEVFS: Free space statistics from the entire volume. For volumes with cylinder-managed space (LSPDCYLM = '1') these statistics represent space from both the track and cylinder- managed space on the volume. See LSPDTMFS for statistics from the track-managed space on the volume.
       
LSPDEVFS 4(X'04') 20 Total volume free space
LSPDNEXT 4(X'04') 4 Number of free extents
LSPDTCYL 8(X'08') 4 Total free cylinders
LSPDTTRK 12(X'0C') 4 Total addition free tracks
LSPDLCYL 16(X'10') 4 Number of cylinders in largest free extent
LSPDLTRK 20(X'14)' 4 Number of additional tracks in largest free extent
LSPDF0S 24(X'18') 4 Format 0 count
LSPDVIRS 28(X'1C') 4 Free VIR count
LSPDFRAG 32(X'20') 4 Fragmentation count
       
End of the base data return area.
       
Beginning of the expanded data return area: For EXPDATA requests, the following 32 bytes of statistics if requested or defaulted by the DATATYPE keyword will be returned.
LSPDTMFS: Free space statistics from track-managed space on a volume for a volume with cylinder-managed space (LSPDCYLM ='1'). For volumes with no cylinder-managed space (LSPDCYLM ='0') than these statistics are equivalent to the total volume statistics described above.
       
LSPDTMFS 36(X'24') 24 Track-managed free space
LSPDVNXT 36(X'24') 4 Number of free extents
LSPDVTCL 40(X'28') 4 Total free cylinders
LSPDVTTK 44(X'2C' 4 Total additional free cylinders
LSPDVLCL 48(X'30') 4 Number of cylinders in the largest free extent
LSPDVLTK 52(X'34') 4 Number of additional free tracks in the largest free extent
LSPDVFRG 56(X'38') 4 Fragmentation index
       
Volume size information
       
LSPDVOLI 60(X'3C') 8 Volume size information
LSPDTRKS 60(X'3C') 4 Total number of tracks on volume
LSPDTRKM 64(X'40' 4 Total number of tracks in track-managed space when LSPDCYLM='1'. Set to the value of LSPDTRKS otherwise.

When LSPDCYLM='1', this value is also the first track address where cylinder managed space begins.

LSPDRSV8 68(X'44') 60 Reserved

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014