Copy a data structure from one directory to the CWD

CALL RZCOPY (CHPATH,KEYIN,ICYCIN,KEYOUT,CHOPT)

CHPATH

The pathname of the directory tree which has to be copied to the CWD

KEYIN

Key-vector of the object to be copied from CHPATH.

ICYCIN

Cycle number of the key to be copied

KEYOUT

Key array of the object in the CWD after the copy

CHOPT

Character variable specifying the options selected.

' '

Copy the object from (KEYIN,ICYCIN) from CHPATH to the CWD (default).
If KEYOUT already exists, a new cycle is created.

'C'

Copy all cycles for the specified key ( ICYCIN not used)

'K'

Copy all keys in the CWD ( ICYCIN and KEYIN not used) Given together with the 'C' option it copies all cycles of all keys.

'T'

Not yet implemented. Copy the complete tree CHPATH. By default only the highest cycles are copied. Given together with the 'C option all cycles are copied.

Note that the input and output keys KEYIN and KEYOUT may be identical. In this case, if KEYOUT already exists in the CWD, a new cycle (or several) is created.

A directory tree identified by its pathname CHPATH can be copied to the CWD with the help of subroutine RZCOPY. Routine RZCOPY can also be used to merge two RZ files.

Return codes

IQUEST(1)

Error status

1

Invalid pathname

0

Normal completion