TRANSFER

Basic form

TRANSFER f TO dsn.

Addition

... LENGTH len

Effect

Transfers the field f (usually a field string) to the sequential file specified in dsn (this may be a literal or a field).

Binary mode (addition IN BINARY MODE of the OPEN DATASET statement):

Write to the file in the length of field f .

Text mode (addition IN TEXT MODE of the OPEN DATASET statement):

Write a line.

If the specified file is not open, TRANSFER attempts to open the file dsn FOR OUTPUT ( IN BINARY MODE or using the further specifications of the last OPEN command for this file). If this fails, a runtime error occurs.

Example


DATA REC(80).
TRANSFER REC TO '/usr/test'.

Notes

You can read sequential datasets with READ DATASET .

The structure of file names depends very much on the operating system you are using. You can access portable programs with the function module GET_FILE_NAME . This returns the relevant physical name for a given logical file name.

Addition

... LENGTH len