Connect:Direct for i5/OS Copy Files Statement

Edit online

The Connect:Direct® for i5/OS COPY statement is used in a Process initiated on a non-i5/OS node to copy files, members, objects, and spooled files to or from an i5/OS node.

The COPY statement consists of a COPY FROM clause that specifies the source object name and a COPY TO clause that specifies the destination object name. You can specify additional parameters to customize the file transfer operation.

Use the file format to copy a physical database file to and from a Connect:Direct for i5/OS node.

Refer to Connect:Direct for i5/OS File Support for guidelines when copying files in Connect:Direct for i5/OS.

Note: z/OS member naming conventions can have unexpected results when you copy a file from i5/OS to z/OS. Refer to Member Name Length in Connect:Direct for i5/OS Copy to z/OS for more information.

The PROCESS statement defines the attributes of a Process and is always the first statement in a Process.

The following is the Connect:Direct for i5/OS Copy-Files statement format. Refer to Connect:Direct for i5/OS Process Parameters for more information.

Label	Statement	Parameters
stepname	COPY	FROM	(
			DSN=`library-name/file-name' \| `/directory/file-name' \|`/QLANSrv/file-name' \| `/QDLS/folder-name' \| `/QOpenSys/file-name'
			SYSOPTS="TYPE(FILE)
			PRECMPR (YES \| NO)
			EXITCMD(valid i5/OS command)
			FAILCMD(valid i5/OS command)
			SNDFFD(YES \| NO)
			TEXTFILE(YES \| NO)
			EORCHAR(xxxx)
			CCSID(nnnnn)
			CODEPAGE(from code set, to Unicode set)
			XTRAN (table-name)
			[XTRANLSO (so-code) \| XTRANLSI (si-code) \| XTRANLDATA (MIXED \| DBCS)]"
			DISP=([SHR \| OLD] ,[KEEP \| DELETE] ,[KEEP \| DELETE])
			EXCLUDE=(generic \| member \| (start-range/stop-range) \| list)
			REPLACE \| NOREPLACE
			SELECT=(member \| generic \| (*)) \| (member, [new-name], [NR \| R]) \| generic,, [NR \| R])
			(start-range/stop-range,,[NR \| R]) \| (list)
			)
		TO	(
			DSN=`library-name/file-name' \| `/directory/file-name' \| `/QLANSrv/file-name' \| `/QDLS/folder-name' \|`/QOpenSys/file-name'
			SNODE (remote-node-name)
			SYSOPTS="TYPE(FILE) DECMPR (YES \| NO) EXITCMD(valid i5/OS command) FAILCMD(valid i5/OS command) TEXTFILE(YES \| NO) EORCHAR(xxxx) CCSID(nnnnn) CODEPAGE(from Unicode set, to code set) RCDLEN(record-length) FILETYPE(SRC \| DATA) TEXT(`text-description') EXPDATE(expiration-date) MAXMBRS(number \| NOMAX) SIZE(#-of-recs \| incr-value#-of-incrs\|NOMAX) AUT(CHANGE \| ALL \| USE \| EXCLUDE) IGCDTA(YES \| NO)"
			DISP=([NEW \| OLD \| MOD \| RPL \| SHR])
			UNIT=(unit-identifier)
			)
			CKPTINV=[nnnnnnn \| nnnnnnK \| nnnnnnM]
			COMPRESS [[PRIMEchar =X`xx' \| X`40' \| C`cc'] \| EXTended = ECCLEVEL(n), ECWINSIZE(n), ECMEMLEVEL(n) Note: If the SNODE is B2B Integrator, only COMRESS EXT is supported.