Message Return Area

LSPACE returns information to a 30-byte message return area ( Figure 1). If you provide a message return area with the MSG option, LSPACE returns EBCDIC text, qualified by return codes as shown in Table 1.

Figure 1. DADSM LSPACE Free Space Information MF=(D,MSG)

LSPMSG   DSECT           Message Area
LSPMTEXT DS    CL30      Message Text

Table 1. DADSM LSPACE Message Return Area Contents
Return Code	Description
0(X'00')	For MSG keyword (30 byte area): Text: SPACE=aaaa,bbbb, cccc/dddd,eeee where: Free space statistics from the entire volume: aaaa = Total number of free cylinders bbbb = Total number of additional free tracks cccc = Total number of free extents dddd = Number of cylinders in largest free extent eeee = Number of additional tracks in largest free extent For aaaa, bbbb, and cccc, the maximum value indicated is 9999 even if the actual value is greater. Use EXPMSG to avoid use of the maximum 9999. For EXPMSG keyword (40 byte area): Text: SPACE=aaaaaa,bbbbbb, cccccc/dddddd,eeeeee where: Free space statistics from the entire volume: aaaaaa = Total number of free cylinders bbbbbb = Total number of additional free tracks cccccc = Total number of free extents dddddd = Number of cylinders in largest free extent eeeeee = Number of additional tracks in largest free extent For aaaaaa, bbbbbb, cccccc, and dddddd, the maximum value indicated is 999999 even if the actual value is greater. Use XEXPMSG to avoid use of the maximum 999999. For XEXPMSG keyword (95 byte area): Text: SPACE=aaaaaaaaa,bbbbbbbbb, ccccccccc/ddddddddd,ee, fffffffff,gggggggggg,hhhhhhhhhh/iiiiiiiii,jj where: Free space statistics from the entire volume: aaaaaaaaa = Total number of free cylinders bbbbbbbbbb = Total number of additional free tracks cccccccccc = Total number of free extents ddddddddd = Number of cylinders in largest free extent ee = Number of additional tracks in largest free extent Free space statistics from the track-managed space of the volume. For a volume without cylinder-managed space, these statistics will be equivalent to the total volume statistics above: fffffffff = Total number of free cylinders gggggggggg = Total number of additional free tracks hhhhhhhhh = Total number of free extents iiiiiiiii = Number of cylinders in largest free extent jj = Number of additional tracks in largest free extent Leading zeroes for each value will be set to ‘blanks’ in the returned message area.
4(X'04')	Text: LSPACE—PERMANENT I/O ERROR
4(X'04')	Text: LSPACE—I/O TIMEOUT ERROR
8(X'08')	Text: LSPACE—NON-STANDARD OS VOLUME. The volume does not have a VTOC index and free space information is not available. Either an operating system other than z/OS® has allocated or freed space on the volume or the volume does not have a format 5 or 7 DSCB chain.
12(X'0C')	Text: LSPACE—UCB NOT READY
	Text: LSPACE—UCBVTOC IS ZERO
	Text: LSPACE—INVALID PARAMETER
	Text: LSPACE—NOT A DIRECT ACCESS VOL
16(X'10')	No text returned (invalid parameter list or SMF indicator) This return code indicates a parameter list error, which can be a bad parameter list storage key, parameter list ID is invalid (not set to ‘LSPA’), or the parameter list size is not sufficient.
20 (X'14')	No text returned (processing error in LSPACE)