This keyword applies to an indexed VTOC only and specifies the
disposition of the MAPRCDS buffer list and buffers.
- MAPRCDS=YES
- Specifies that the buffer list and buffers are to be retained
at the end of processing.
If no buffer list address is in the CVAF
parameter list, CVAF reads the MAP VIRs into buffers it obtains. The
buffer list that contains the address and RBAs of the VIRs can be
accessed after processing from the CVAF parameter list field, CVMRCDS.
The buffer list and VIR buffers are in your protect key: subpool 0
if you are not authorized; subpool 229 if you are.
When processing
on the current volume is finished, release all areas that were kept.
- MAPRCDS=(YES,addr)
- If MAPRCDS=YES is coded and the buffer list address (CVMRCDS
in CVAF parameter list) is supplied, VIRs are not read.
The CVMRCDS
buffer list used in CVAFDIR macro can be passed to another CVAF macro
call through the MAPRCDS keyword.
If MAPRCDS=YES is coded for
a nonindexed VTOC, the function is performed, but an error code is
returned.
- MAPRCDS=NO
- If MAPRCDS=NO is coded, all the buffers without the skip bit
on in the buffer list whose address is in the CVMRCDS field of the
CVPL are freed. If all the buffers are freed, the buffer list is also
freed.
- MAPRCDS=(NO,addr)
- Frees buffer lists and buffers previously obtained by CVAF.
You must free buffer lists and buffers obtained by CVAF. This can
be done in one of three ways:
- By coding MAPRCDS=NO on the CVAFDIR macro that obtained the buffers
- By coding MAPRCDS=NO on a subsequent CVAF macro
- By coding CVAFDIR ACCESS=RLSE and providing the address of the
buffer list in the BUFLIST keyword.
Requirement: You must enqueue the VTOC
and reserve the unit to maintain the integrity of MAP records read.