Return Codes from OBTAIN (Reading by Data Set Name)

Table 1. DADSM OBTAIN Return Codes
Return Code	Description
0(X'00')	Successful completion of OBTAIN routine.
4(X'04')	The required volume was not mounted.
8(X'08')	The format-1 DSCB was not found in the VTOC of the specified volume.
12(X'0C')	A permanent I/O error was encountered, or an invalid format-1 DSCB was found when processing the specified volume, or an unexpected error return code was received from CVAF (common VTOC access facility).
16(X'10')	Invalid work area pointer.
24(X'18')	Data set has a format-8 DSCB and EADSCB=NOTOK is in effect
24(X'1C')	Internal error with EADSCB=NOTOK in effect.

On return from SEARCH requests, the first 103 bytes of the first 140 byte return area will contain:

The 96 byte data portion of the format-1, format-4, or format-8 DSCB
Followed by 5 bytes that contain the absolute track address (CCHHR) of this DSCB. For VSAM object names that appear in the catalog, but not in the VTOC or VIO data sets, these 5 bytes contain zeros.
Followed by a 2 byte count of the total number of DSCBs associated with the data set DSCB, even if there are insufficient return areas into which to read them all. This count includes all DSCB types that could describe a data set. Set to zero for DSCBs constructed from catalog when DSCBs are not present in the VTOC.
If the request specified multiple DSCBs, only the format-1 or format-8 pseudo DSCB will be returned when the DSCB was not found in the VTOC and had to be constructed from Catalog. No forward chain pointer to the next DSCB will be present in this returned DSCB. The remaining 140 byte return areas will contain the entire 140 byte key and data portions of the associated DSCB.
If the request did not specify multiple DSCBs, a format-1 or format-8 pseudo DSCB will be returned when the DSCB was not found in the VTOC and had to be constructed from Catalog. No forward chain pointer to the next DSCB will be present in this returned DSCB. After executing these macro instructions, the first 96 bytes of the work area contain the data portion of the format-1 or format-4 DSCB; the next 5 bytes contain the absolute track address (CCHHR) of the DSCB. For VSAM or VIO data sets, these 5 bytes contain zeros.