File	20
Op-Sys	z/OS, z/VSE, BS2000 Note Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.
Statement	FIND
Task	Read storage allocated to the requested address space or partition. No modifications are possible. In BS2000, read pages of memory pools. In z/VSE , only the partition in which Entire System Server is running can be read.

---

Common Fields for all Operating Systems

Dictionary Field Name	F/L	Mu	DE	Remarks
ERROR-CODE	N3
ERROR-TEXT	A58
NODE	N5		D
NODE-NAME	A16		D
SYSTEM-MESSAGE-CODE	A10
ADDRESS	B4		D	Required in z/OS, z/VSE.
LENGTH	N3		D	Required in z/OS,z/VSE.
OFFSET	B4		D
AREA	A250		D

Additional Field Supported for z/OS

Dictionary Field Name	F/L	Mu	DE	Remarks
JOB-NAME	A8		D	Required
ADDRESS-64BIT	B8		D

Additional Fields Supported for BS2000

Dictionary Field Name	F/L	Mu	DE	Remarks
SYSTEM-CODE	B2
POOL-ID	A54		D	Required
SCOPE	A6		D

Relevant Error Codes

Code	Text	z/OS	z/VSE	BS2000
699	Not enough main storage available.	X	X
799	Entire System Server internal error.			X
801	Job not found.	X
803	Cannot access data.	X	X	X

Field Descriptions

Field Name	Type/Length	Operating System
ADDRESS	(B4)	z/OS, z/VSE, BS2000

Starting main storage address. The actual address displayed is specified by a combination of the ADDRESS and OFFSET fields.

In BS2000, address relative to memory pool start.

Field Name	Type/Length	Operating System
ADDRESS-64BIT	(B8)	z/OS

Starting main storage address in 64-bit format (used to display storage above 4 GB). The actual address displayed is specified by a combination of the ADDRESS-64BIT and OFFSET fields.

Field Name	Type/Length	Operating System
AREA	(A250)	z/OS, z/VSE, BS2000

Location to which the storage block is returned.

Field Name	Type/Length	Operating System
JOB-NAME	(A8)	z/OS

Name of job which serves as address space identifier. This field is required.

Field Name	Type/Length	Operating System
LENGTH	(N3)	z/OS, z/VSE, BS2000

Length of main storage to be retrieved (maximum is 250).

Field Name	Type/Length	Operating System
OFFSET	(B4)	z/OS, z/VSE, z/VSE , BS2000

Offset related to address to be displayed. The actual address displayed is specified by a combination of the ADDRESS and OFFSET fields.

Field Name	Type/Length	Operating System
POOL-ID	(A54)	BS2000

Name of the memory pool.

Field Name	Type/Length	Operating System
SCOPE	(A6)	BS2000

Scope of memory pool. Possible values:

Value	Explanation
GLOBAL	Name valid system-wide. Default.
GROUP	Name valid for user ID.
LOCAL	Name valid for task.