Output

The most important output from a find routine is a description of the named AREA or STRUCTURE. The description is provided by filling in fields in the BLSRESSY data area. The definition may be returned in either the ABITS=31 format passed to the FIND exit or in ABITS=64 format. The buffer passed is sized to accomodate the largest BLSRESSY structure supported by IPCS.

The find routine fills in the fields of BLSRESSY as follows:

The address space in which the block was found in the AS field within BLSRESSY. The AS field is, itself, a structure that is described by BLSRDATS (contained in BLSRESSY mapping macro).
The address of the block in the LAD field within BLSRESSY.
Other attributes of the block in the D field within BLSRESSY. The D field is, itself, a structure that is described by BLSRDATC (contained in BLSRESSY mapping macro).
A remark that pertains to the block in the R field within BLSRESSY. The R field is, itself, a structure that consists of a halfword binary field and 512 bytes of space for remark text. The halfword should be set to indicate the number of bytes of EBCDIC text in the remark supplied.

If the routine receives a device number as the final characters of a symbol, for example, UCBdddd, the device number consists of 4 digits, with leading zeros.

In addition to the above information, the following return codes are supplied:

Code: Meaning
00: Successful completion - a usable definition of the AREA or STRUCTURE has been returned in BLSRESSY.
04: Attention conditions detected - but a usable definition of the AREA or STRUCTURE has been returned in BLSRESSY.
08: Error conditions detected - but a usable definition of the AREA or STRUCTURE has been returned in BLSRESSY.
12: Symbol not resolved, possibly due to path to block not available, block failed validation, or IPCS user requested early termination of processing - NO usable definition of the AREA or STRUCTURE has been returned in BLSRESSY.
16: Find exit unable to function, for example, GETMAIN failure - NO usable definition of the AREA or STRUCTURE has been returned in BLSRESSY.

Reference

See z/OS MVS™ Data Areas in the z/OS® Internet Library: &zosliburl; for a mapping of the BLSRESSY data area.