Knowledge Base > Automation Engine and Target Systems > z/OS > Agent - File Transfer Support

z/OS Agent - File Transfer Support

The z/OS agent supports all file transfer functions such as the transfers of text and binary files or file transfers with wildcard characters. The z/OS agent can extend sequential files (PS, but not the members of a library.

While defining a FileTransfer object, you can define additional file attributes for the file transfer's destination in the FileTransfer tab. This definition overrides the system's default allocation.

You can assume the attributes of the source files if the source and destination platform comply with each other. Use the option "Keep original file attributes" in the FileTransfer object for this purpose. Note that in z/OS, you cannot override these attributes. With this option being activated, an error will occur if you define additional attributes.

The following two formats can be used to specify file attributes in file transfers that use z/OS as the destination platform.

Language Environment Format

The "Language Environment Format" is the usual format. The file attributes for file transfers of older Automation Engine versions have already been specified in this format. Several file attributes are separated by commas, values are assigned using the character '='.

You can specify the following file attributes:

recfm= (all 27 record formats of OS/390 plus * and A are valid)
lrecl= (0, any positive number up to 32,760 and X for each Reclen)
blksize= (0, any positive number up to 32,760)
space= ([CYL,TRK],(prim,sec,directory))
nl= (crlf (default setting in the Windows agent) -> records are separated by <cr><lf> (=0d0a);
lf (default setting in the Unix agent) -> records are spearated by <nl> (=0a);
none (no line separator is inserted between records).

Examples

recfm=fb,lrecl=1024,blksize=2048,space=(CYL,(1,1,0))

recfm=fb,lrecl=80

Allocate Format

Starting with version 9.00A, you can set the attributes for file transfer files using the ALLOCATE command. Several attributes are separated by using blanks and the values are written in parentheses directly after the attribute name. The '=' character is not required.

This spelling can only be used with the new file transfer protocol (source and destination agent are of version 9.00A or later).

The following attributes are supported:

DATACLAS
EXPDT
MGMTCLASS
RETPD
RLSE
STORCLAS
UNIT
VOLUME
RECFM
LRECL
BLKSIZE
SPACE (only in combination with CYLINDERS, TRACKS or BLOCK)
DSORG
ROUND

For a detailed description refer to the IBM documentation of the TSO command ALLOCATE.

Example

ALLOCATE RECFM(FB) LRECL(1024) BLKSIZE(2048) EXPDT(2010100) SPACE(1,1) CYLS DIR(10) UNIT(3390) VOLUME(DSK30D,DSK30E)