MemCom Reference Manual > MemCom ftn Fortran API > Database Manager (DB) > mcf_db_copy

Name

mcf_db_copy — Copy dataset (Fortran API)

Synopsis

subroutine mcf_db_copy(handle1,name1,handle2,name2,status)

integer*4 handle1
character*(*) name1
integer*4 handle2
character handle2

Description

mcf_db_copy copies a dataset name1 from a database file identified by handle1 to another database identified by handle2 and renames it to name2. name2 can be equal to name1 if handle2 is not equal to handle1. The operation fails if name2 already exists on handle2, i.e a dataset cannot be overwritten by copying.

Parameters

handle1

Handle of database file to be copied (input).

name

Name of dataset to be copied (input). The string may not exceed the maximum dataset name length.

handle2

Handle of database file where the dataset is copied to (input).

name

Name of copied dataset (input). The string may not exceed the maximum dataset name length.

status

Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected. A positive value is returned, if a warning has been issued.