The format of the list form of the LSPACE macro is:

>>-+-------+--LSPACE--MF=-+-L-----------+----------------------->
   '-label-'              +-(L,MSG)-----+   
                          +-(L,EXPMSG)--+   
                          +-(L,XEXPMSG)-+   
                          +-(L,DATA)----+   
                          '-(L,EXPDATA)-'   

>--+--------------------+--+----------------+------------------->
   +-,MSG=-+-addr-+-----+  '-,SMF=-+-TEST-+-'   
   |       '-0----'     |          +-YES--+     
   +-,EXPMSG=-+-addr-+--+          '-NONE-'     
   |          '-0----'  |                       
   +-,XEXPMSG=-+-addr-+-+                       
   |           '-0----' |                       
   +-,EXPDATA=-+-addr-+-+                       
   |           '-0----' |                       
   '-,DATA=-+-addr-+----'                       
            '-0----'                            

>--+-------------------+--+--------------------------+---------->
   '-,F4DSCB=-+-addr-+-'  |            .-ALL-------. |   
              '-0----'    '-,DATATYPE=-+-FRAGINDEX-+-'   
                                       +-INDEX-----+     
                                       +-VOLUME----+     
                                       '-VTOC------'     

>--+--------------------------------+--------------------------><
   |            .-IMPLIED_VERSION-. |   
   '-,PLISTVER=-+-plistver--------+-'   
                '-MAX-------------'     

MF=L or (L,MSG) or (L,EXPMSG) or (L,EXPMSG) or (L,DATA) or (L,EXPDATA)

Specifies the list form of the LSPACE macro.

L

Generates the required constants in the calling program. You can then issue the execute form of the macro, which uses these constants.

(L,MSG)

Generates the required message return area constants in the calling program. No other parameters are allowed.

(L,EXPMSG)

Generates the required expanded message return area constants in the calling program. No other parameters are allowed.

(L,XEXPMSG)

Generates the required extended expanded message return area constants (95-bytes) in the calling program. No other parameters are allowed. Use this keyword to obtain the message data area for all volume sizes including ones with cylinder-managed space.

(L,DATA)

Generates the required data return area constants in the calling program. No other parameters are allowed.

(L,EXPDATA)

Generates the required expanded data return area constants in the calling program. No other parameters are allowed. Use the keyword to obtain the data area for all volume sizes including ones with cylinder-managed space.

DATATYPE=ALL or FRAGINDEX or INDEX orVOLUME orVTOC

This keyword is allowed only when the DATA or EXPDATA keyword is specified. Only the information specified will be returned to the caller. DATATYPE is valid for both non-EAV and EAV. This keyword will eliminate unnecessary I/O required to retrieve free space information that is not be required by the caller. DATATYPE=ALL is the default.

ALL

Provide all available LSPACE statistics. This is the default

FRAGINDEX

Provide the fragmentation index

INDEX

Provide free space information related to the VTOC INDEX

VOLUME

Provide free space information for the VOLUME

VTOC

Provide free space information related to the VTOC

PLISTVER=plistver | IMPLIED_VERSION | MAX

This keyword defines the version of the LSPACE parameter list that should be generated for the MF=I form of the LSPACE macro.

PLISTVER=plistver specifies the version of the LSPACE parameter list that should be generated, where plistver is either 1 or 2. This PLISTVER= keyword is required for any macro keys associated with version 2 or larger to be specified, The macro keys associated with each supported version of the macro are listed below:

PLISTVER=1

PLISTVER=1 is associated with the following macro keys:

• DATA
• EXPMSG
• F4DSCB
• MSG
• SMF

PLISTVER=2

PLISTVER=2 is associated with the following macro keys:

• XEXPMSG
• EXPDATA
• DATATYPE

When PLISTVER= IMPLIED_VERSION is specified the generated parameter list is the lowest version that allows all of the parameters on the invocation to be processed. When PLISTVER is omitted, the default is the lowest version of the parameter list, which is version 1.

When PLISTVER= MAX is specified, the generated parameter list is the largest size currently supported. This size may grow from release to release thus possibly affecting the amount of storage needed by your program. If your program can tolerate this, IBM® recommends that you always specify MAX when creating the list form parameter list as that will ensure that the list form parameter list is always long enough to hold whatever parameters might be specified on the execute form.