COPY-FILE

File 37
Statement PROCESS
Task Copy files or library elements.

Relevant Error Codes

Code Text
530 Access denied by Security Facility
659 Dataset is already cataloged
678 MEMBER already exists.
701 DSNAME missing
772 Requested dataset not found
798 Task was not started under TSOS.
799 Entire Systems Management Adapter internal error
983 REMOTE-COPY not supported by COPY-FILE
991 Unknown product

Field Descriptions

Dictionary Field Name Format/

Length/

Desc/

Mu

Description

DSORG (A4) For copy of LMS element to file: DSORG of target file. Possible values:
  D CAT DSORG as defined in catalog entry of file
    SAM DSORG = SAM
    ISAM DSORG = ISAM
    The default is the default of the LMS.
FROM-DSNAME (A54) Required.
  D Fully qualified input file name.
FROM-ELEMENT (A64) Name of LMS element to be copied.
  D  
FROM-ELEMENT-PASSWORD (A8) Password for protected input element.
  D  
FROM-ELEMENT-TYPE (A8) Type of LMS element to be copied.
  D  
FROM-ELEMENT-VERSION (A24) Version of LMS element to be copied.
  D  
FROM-PASSWORD (A8) Password for input file.
  D  
FROM-PRODUCT (A1) Specify access method with FROM-LIBRARY:
  D M LMS
    Blank default
REPLACE (A3) Possible options:
  D NO Add object to library. If an object with
    the same name already exists, raise error.
    REP Replace object of the same name. If it
    does not exist, raise error.
    YES Default. Add object to library. If an
    object with the same name already exists,
    replace it.
SAME (A3) Specify YES for the output file to have the same security and save options as the input file.
  D  
TO-DSNAME (A54) Required.
  D Fully qualified output dataset name.
TO-ELEMENT (A64) Name of target LMS element.
  D  
TO-ELEMENT-PASSWORD (A8) Password for protected output element.
  D  
TO-ELEMENT-TYPE (A8) Type of target LMS element.
  D  
TO-ELEMENT-VERSION (A24) Version of LMS element to which is to be copied.
  D  
TO-ELEMENT-USER-DATE (A14) User date for output element. Format: YYYY-MM-DDaaaa, where aaaa can be any 4-character string.
  D  
TO-ELEMENT-USER-TIME (A8) User time for output element. Format: HH:MM:SS.
  D  
TO-PASSWORD (A8) Password for output file.
  D  
TO-PRODUCT (A1) Specify access method for TO-LIBRARY:
  D M LMS
    Blank default