ACCESS: Retrieve a DSCB, or Release FLTAREA and/or IOAREA

ACCESS=READ

Retrieves all DSCBs associated with the data set names specified in the filter criteria list (FCL), placing them in your buffers. You can select (filter) the retrieved DSCBs by providing either a list of one or more fully-qualified names, or a single partially-qualified name, using single or double asterisk notation. (See the example of partially-qualified names in Partially-Qualified Names for CVAFFILT.)

If the number of buffers is not large enough to hold all the requested DSCBs, CVAFFILT indicates this in the CVSTAT status byte of the CVAF parameter list (CVPL). You can resume the READ function by issuing a call with ACCESS=RESUME. See Codes Put in the CVSTAT Field.

When selecting DSCBs by partially-qualified name, CVAFFILT uses only the first data set name in the FCL list. Set the FCLCOUNT count field in the FCL to 1 or CVAFFILT returns error code 63 in the CVSTAT status byte of the CVPL. The DSCBs returned by CVAFFILT might not be in sequence by data set name; however, the DSCBs for each data set are always in order (format-1, format-2, format-3).

When selecting DSCBs by fully-qualified names, you can request that CVAF filter return the DSCBs for the selected data set names in the data set name order implied by the FCL. See the FCL1ORDR flag in Table 1.

Always test the status byte of each data set name in the FCL list to ensure successful completion. (Some error conditions result in failure to return a data set's DSCBs.) See the FCLDSNST byte in Table 2.

ACCESS=RESUME

Resumes a previously initiated READ or RESUME function that was terminated because you did not provide enough buffers to contain all the requested DSCBs. For the RESUME function to execute correctly, the keyword FLTAREA=KEEP must be coded in each of the previous READ and RESUME function calls.

ACCESS=RLSE

Releases the previously kept filter save area (FLTAREA) and/or CVAF I/O work area (IOAREA).