| 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. |
| 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 |
| 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.
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.
