MAPRCDS: Keep or Free MAPRCDS Buffer List and Buffers

MAPRCDS=YES

Specifies that the buffer list and buffers are to be retained at the end of the function.

If MAPRCDS=YES is specified and no buffer list is supplied through the CVAF parameter list, CVAF reads the VIRs into buffers obtained by CVAF. The buffer list that contains the address and RBAs of the VIRs can be accessed after the CVAF call from the CVAF parameter list field, CVMRCDS. The buffer list and VIR buffers are in the caller's protect key: subpool 0 if the caller is not authorized; subpool 229 if the caller is authorized.

MAPRCDS=YES is the default if MF=I is specified or defaulted.

When processing on the current volume is finished, release all areas that were kept.

MAPRCDS=(YES,addr)

If MAPRCDS=YES is coded, but the buffer list address (CVMRCDS in CVAF parameter list) is supplied, the VIRs are not read.

The CVMRCDS buffer list from one CVAF call can be passed to another CVAF macro call through the MAPRCDS keyword.

MAPRCDS=NO

Specifies that the MAP records buffers and buffer list are freed upon completion of the CVAFDSM function.

NO is the default if MF=L is specified.

MAPRCDS=(NO,addr)

Frees buffer lists and buffers previously obtained by CVAF.

Buffer lists and buffers obtained by CVAF must be freed by the caller. This can be done in one of the following ways:

By coding MAPRCDS=NO on the call that obtained the buffers
By coding MAPRCDS=NO on a subsequent CVAF call
By coding CVAFDIR ACCESS=RLSE and providing the buffer list in the BUFLIST keyword.
If MF=(E,addr) is coded and MAPRCDS is not coded, the parameter list value of MAPRCDS is not changed.

Requirement: You must enqueue the VTOC and reserve the unit to maintain the integrity of the MAP records read.