cp

Name

cpsetdb, cpadb, cpmdb, cpssdb — Copy datasets

Synopsis

subroutine cpsetdb(handle1,name1,handle2,name2,status)
integer*4 handle1 
character*(*) name1 
integer*4 handle2 
character*(*) name2
integer*4 status

subroutine cpadb(handle1,handle2,status)
integer*4 handle1
integer*4 handle2
integer*4 status

subroutine cpmdb(handle1,handle2,mask,status)
integer*4 handle1
integer*4 handle2
character *(*) mask
integer*4 status

subroutine cpssdb(handle1,name1,handle2,name2,irep,buf,lbuf,status)
integer*4 handle1 
character*(*) name1 
integer*4 handle2 
character*(*) name2 
inetger*4 irep 
integer*4 buf(*) 
integer*4 lbuf 
integer*4 status

Description

The data set copy functions copy datasets of type I, J, E, C, F, Z, U, and $. cpsetdb copies a single dataset from one database to another. If a dataset is inactive, i.e deleted, it is not copied. If a set already exists on the destination database the set is deleted before the copy operation is performed. cpadb copies all datasets from one database to another. Inactive (deleted) datasets are not copied. cpmdb copies all datasets which match the mask string mask from one database to another. Inactive (deleted) datasets are not copied. cpssdb copies a single dataset from one database to another. The user-defined copy buffer is not used anymore in the argument list.

Parameters

handle1: Database handle of set to be copied (input). The file handle handle may not exceed the maximum number of simultaneously open databases.
name1: Name of dataset to be copied (input). The string may not exceed the maximum dataset name length.
handle2: Database handle of target set (input). The file handle handle may not exceed the maximum number of simultaneously open databases.
name2: Name of target dataset (input). The string may not exceed the maximum dataset name length.
irep: Replace flag (input). Not used anymore.
mask: Mask string (input). All datasets matching mask are copied. The string may not exceed the maximum dataset name length.
buf: Copy work space (not used anymore).
lbuf: Length of copy work space. Not used anymore.
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. See MemCom error codes.

Additional notes

Sparse tables cannot be copied by these functions.