z/OS and File Transfers

The z/OS Agent supports all file transfer functions such as the transfers of text and binary files, or file transfers with wildcard characters. File Transfer objects include various pages where the object definitions are stored. File transfers are processed with the character conversions that you define in these pages (such as IBM_3270_INTERNATIONAL).

Specific File Transfer Attributes

When you define a File Transfer object, you can set specific additional file attributes for the file transfer's destination on the File Transfer page that will override the system's default allocation.

You can take over 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 File Transfer object for this purpose.

Important!

• You cannot overwrite the original attributes with additional specifications in the File Transfer object (target). Any attempt to do so results in an error message and the file transfer fails.
• Setting this option in combination with files that are located on tape/VTL is not supported. This option requires the dataset to be on a disk.

For general information about file transfers, see File Transfers (JOBF)

Command Formats

Two command formats are available that you can use to set file attributes in file transfers that use z/OS as their destination platform:

Language Environment Command Format

With this format, you can separate several file attributes with a comma (,) and assign values with an equals sign (=).

The following file attributes are supported:

• 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 (Windows Agent default), records are separated by <cr><lf> (=0d0a)
  lf (Unix Agent default), records are separated by <nl> (=0a)
  none, no line separator is inserted between records

Example

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

recfm=fb,lrecl=80

Allocate Command Format

The advantage of using this format is that you can set more attributes than with the language environment command format. You separate several attributes by using blanks and put the values in parentheses right after the attribute name. The equals sign (=) is not required.

The following attributes are supported:

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

For a detailed description, see the IBM documentation TSO command ALLOCATE.

Example

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

See also:

• OS/390 JOBS
• File Transfers (JOBF)