MAIN-STORAGE

#### Search Results

Search

# MAIN-STORAGE

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.

### On this page

- Common Fields for all Operating Systems
- Additional Field Supported for z/OS
- Additional Fields Supported for BS2000
- Relevant Error Codes
- Field Descriptions