COPY-FILE

#### Search Results

Search

# COPY-FILE

File | 37
Statement | `PROCESS`
Task | Copy files or library members. Both source and target files must exist before this function is executed. Load modules can only be copied from PDS to PDS, while program objects can only be copied from PDSE to PDSE. Mixing of PDS and PDSE formats is unavailable due to IBM restrictions.

## Fields

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 |  |  |
`FROM-DSNAME` | A54 |  | D | Required
`FROM-PRODUCT` | A1 |  | D |
`FROM-PASSWORD` | A8 |  | D |
`TO-DSNAME` | A54 |  | D | Required
`TO-PRODUCT` | A1 |  | D |
`TO-PASSWORD` | A8 |  | D |
`REPLACE` | A3 |  | D |
`ERROR-NODE` | N5 |  |  |
`ERROR-VIEW` | N3 |  |  |
`FROM-VOLSER` | A6 |  | D |
`FROM-TAPE-DDNAME` | A8 |  | D |
`FROM-TAPE-FILE-SEQUENCE` | B2 |  | D |
`FROM-USERID` | A8 |  | D |
`FROM-USER-PASSWORD` | A32 |  | D |
`FROM-MEMBER` | A8 |  | D |
`FROM-NODE` | N5 |  | D |
`TO-VOLSER` | A6 |  | D |
`TO-TAPE-DDNAME` | A8 |  | D |
`TO-TAPE-FILE-SEQUENCE` | B2 |  | D |
`TO-USERID` | A8 |  | D |
`TO-USER-PASSWORD` | A32 |  | D |
`TO-MEMBER` | A8 |  | D |
`TO-NODE` | N5 |  | D |

## Relevant Error Codes

Code | Text
--- | ---
530 | Access denied by Security Facility
549 | Not a PDSE data set
659 | Dataset is already cataloged
670 | View not supported on one of the operating systems
679 | Input and output files are incompatible
683 | FAMS error, R15 = :1:, R0 = :2:
685 | FAMS subtask abended
699 | `GETVIS` failed
701 | `DSNAME` missing
772 | Requested dataset not found
998 | Member not found

Note
Any possible return code from `READ-FILE`, `WRITE-FILE`, `LIB-DIRECTORY`, `LIB-UPDATE`, `SYSTEM-INFO` and `NATPROC-LOGON` may also be returned.

## Field Descriptions

Note
Specification of user ID and password are only required if they are different from the local user ID and password.

Field Name | Format/Length
--- | ---
`ERROR-NODE` | (N5)

If an error occurred during processing, this contains the node which returned the error code.

Field Name | Format/Length
--- | ---
`ERROR-VIEW` | (N3)

If an error occurred during processing, this contains the view number (called internally by `COPY-FILE`) which returned the error code. If it is zero, then the error was not returned by a called view.

Field Name | Format/Length
--- | ---
`FROM-DSNAME` | (A54)

Fully qualified input dataset name.

Field Name | Format/Length
--- | ---
`FROM-MEMBER` | (A8)

Name of the member to be copied.

Field Name | Format/Length
--- | ---
`FROM-NODE` | (N5)

Entire System Server node ID from which to copy.

Field Name | Format/Length
--- | ---
`FROM-PASSWORD` | (A8)

Password for input dataset.

Field Name | Format/Length
--- | ---
`FROM-PRODUCT` | (A1)

Specify access method with `FROM-LIBRARY`:

Value | Explanation
--- | ---
`L` | CA-Librarian
`P` | CA-Panvalet

Field Name | Format/Length
--- | ---
`FROM-TAPE-DDNAME` | (A8)

The DD name of the input tape as specified in the view `FILE-ALLOCATE`.

Field Name | Format/Length
--- | ---
`FROM-TAPE-FILE-SEQUENCE` | (B2)

The file number of the dataset to be read.

Field Name | Format/Length
--- | ---
`FROM-USERID` | (A8)

User ID in `FROM-NODE`.

Field Name | Format/Length
--- | ---
`FROM-USER-PASSWORD` | (A32)

User password in `FROM-NODE`.

Field Name | Format/Length
--- | ---
`FROM-VOLSER` | (A6)

Volume serial number of the input dataset.

Field Name | Format/Length
--- | ---
`REPLACE` | (A3)

Possible options:

Option | Explanation
--- | ---
`NO` | Add object to library. If an object with the same name already exists, issue error code.
`REP` | Replace object of the same name. If it does not exist, issue error code.
`YES` | Default. Add object to library. If an object with the same name already exists, replace it.

Field Name | Format/Length
--- | ---
`TO-DSNAME` | (A54)

Fully qualified output dataset name.

Field Name | Format/Length
--- | ---
`TO-MEMBER` | (A8)

Name to be assigned to the member in the output dataset. By default, the name of the input member is taken.

Field Name | Format/Length
--- | ---
`TO-NODE` | (N5)

Entire System Server node ID to which to copy.

Field Name | Format/Length
--- | ---
`TO-PASSWORD` | (A8)

Password for output dataset.

Field Name | Format/Length
--- | ---
`TO-PRODUCT` | (A1)

Specify access method for `TO-LIBRARY`:

Value | Explanation
--- | ---
`L` | CA-Librarian
`P` | CA-Panvalet

Field Name | Format/Length
--- | ---
`TO-TAPE-DDNAME` | (A8)

The DD name of the output tape as specified in the view `FILE-ALLOCATE`.

Field Name | Format/Length
--- | ---
`TO-TAPE-FILE-SEQUENCE` | (B2)

The file number of the dataset to be written.

Field Name | Format/Length
--- | ---
`TO-USERID` | (A8)

User ID in `TO-NODE`.

Field Name | Format/Length
--- | ---
`TO-USER-PASSWORD` | (A32)

User password in `TO-NODE`.

Field Name | Format/Length
--- | ---
`TO-VOLSER` | (A6)

Volume serial number of the output dataset.

### On this page

- Fields
- Relevant Error Codes
- Field Descriptions