MAIN-STORAGE

File 20
Op-Sys z/OS, z/VSE, BS2000
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.