z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

OCOPY
Parameters
v A file to an MVS sequential data set
v A file to a file
v A member of an MVS PDS or PDSE to another member of an MVS PDS or
PDSE
v A member of an MVS PDS or PDSE to an MVS sequential data set
v An MVS sequential data set to another MVS sequential data set
v An MVS sequential data set to a member of an MVS PDS or PDSE
Both INDD and OUTDD can represent an MVS data set or a file. If the source
(INDD) is an MVS data set and the target (OUTDD) is an z/OS UNIX file system
file, then OCOPY copies an MVS data set to a file; the operation is the same as the
OPUT command. If the source (INDD) is an z/OS UNIX file system file and the
target (OUTDD) is an MVS data set, then OCOPY copies a file to an MVS data set;
the operation is the same as the OGET command.
Both the target and source can be an MVS data set or member of a partitioned
data set, or both can be a file. This function is typically used for code page
conversion.
If PATHMODE, which sets the permission bits for a new file, is specified during
allocation, it is used when creating a new file. If PATHMODE is not specified during
the allocation of a new file, the allocation creates a file with the default permission
of 000, which means the user has no access to it.
INDD(ddname1)
Specifies the ddname of the source. The ddname is up to 8 characters long.
OUTDD(ddname2)
Specifies the ddname of the target. The ddname is up to 8 characters long.
BINARY | TEXT
Specifies that the data to be copied is a binary file or text file.
BINARY
Specifies that the data to be copied is a binary file. The default is binary
when copying a data set of undefined record format to a file.
When you specify BINARY, OCOPY operates without any consideration for
characters or the special characteristics of DBCS data. For
example, doublebyte characters might be split between MVS data set
records, or a “shift-out” state might span records.
TEXT
Specifies that the data to be copied is a text file. The default is text except
when copying a data set of undefined record format to a file.
If you are using a DBCS-supported terminal, you should use TEXT. It is
assumed that doublebyte data in the file system includes the
character in order to delineate line boundaries. Data within these lines that
are delineated by characters must begin and end in the “shift-in”
state.
CONVERT(character_conversion_table | YES | NO)
Specifies the character conversion table used to convert between the following:
v Code pages IBM-037 and IBM-1047
v The ASCII code page and IBM-1047
840 z/OS V1R9.0 UNIX System Services Command Reference