FILE-MAINTENANCE

#### Search Results

Search

# FILE-MAINTENANCE

File | 18
Op-Sys | z/OS, 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 | `PROCESS`
Task | z/OS: Compress a PDS library online. BS2000: Compress a file (release unused space).

## 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 |  |  |
`DSNAME` | A54 |  | D | Required.
`PASSWORD` | A8 |  | D |
`FUNCTION` | A8 |  | D |

## Additional Fields Supported for z/OS

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`VOLSER` | A6 |  | D | Required in z/OS if dataset is not cataloged.
`LINE` | A121 |  | D |
`COMPLETION-CODE` | B2 |  |  |
`DISP` | A3 |  |  |

## Additional Fields Supported for BS2000

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`SYSTEM-CODE` | B2 |  |  |

## Relevant Error Codes

Code | Text | z/OS | BS2000
--- | --- | --- | ---
530 | Access denied by security facility. |  | X
565 | Syntax error in dataset name. |  | X
600 | Unknown function. |  | X
701 | `DSNAME` missing. |  | X
733 | User ID does not exist. |  | X
772 | Requested dataset not found. |  | X
778 | Not APF authorized. | X |
798 | Task was not started under TSOS. |  | X
799 | Entire System Server internal error. |  | X
985 | Access to tape file not allowed. |  | X

## Field Descriptions

Field Name | Type/Length | Operating System
--- | --- | ---
`COMPLETION-CODE` | (B2) | z/OS

`IEBCOPY` completion code.

Field Name | Type/Length | Operating System
--- | --- | ---
`DISP` | (A3) | z/OS

Disposition to be used when compressing the file. Possible options:

- `OLD`

- `SHR`

Field Name | Type/Length | Operating System
--- | --- | ---
`DSNAME` | (A54) | z/OS, BS2000

Fully qualified dataset name.

Field Name | Type/Length | Operating System
--- | --- | ---
`FUNCTION` | (A8) | z/OS, BS2000

Possible values:

Value | Explanation
--- | ---
`COMPRESS` | Default. Compress dataset or file.
`RECALL` | z/OS only. Recall file stored with HSM (Hierarchical Storage Manager).

Field Name | Type/Length | Operating System
--- | --- | ---
`LINE` | (A121) | z/OS

`IEBCOPY` output line. For a description of the line layout, see `IEBCOPY` documentation.

Field Name | Type/Length | Operating System
--- | --- | ---
`PASSWORD` | (A8) | z/OS, BS2000

Password for dataset

Field Name | Type/Length | Operating System
--- | --- | ---
`VOLSER` | (A6) | z/OS

Volume serial number of the dataset.

### On this page

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