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

OPUT
OPUT — Copy an MVS data set member into a z/OS UNIX system file
Format
Description
Parameters
OPUT mvs_data_set_name | mvs_data_set_name(member_name)
’pathname’
BINARY | TEXT
CONVERT(character_conversion_table | YES | NO)
You can use the OPUT command to:
v Copy a member of an MVS partitioned data set (PDS or PDSE) to a file
v Copy an MVS sequential data set to a file
and convert the data from code page IBM-037 or ASCII to code page IBM-1047.
Do not use the CONVERT option when copying files that contain doublebyte data.
This option is used for singlebyte data only, not for doublebyte data.
mvs_data_set_name | mvs_data_set_name(member_name)
Specifies the name of an MVS sequential data set or an MVS partitioned data
set member that is being copied.
v A fully qualified name that is enclosed in single quotes, or an unqualified
name (an unqualified name is not enclosed in single quotes)
v Up to 44 characters long, with an additional 8 characters for the member
name
v Converted to uppercase characters by the system
pathname
Specifies the path name of the file to receive the data set member that is being
copied. The target file cannot be a directory. All directories in the path name
prior to the file name directory must already exist. The path name is:
v A relative or absolute path name. A relative path name is relative to the
working directory of the TSO/E session (usually the HOME directory).
Therefore, you should usually specify an absolute path name.
v Up to 1023 characters long.
v Enclosed in single quotes.
v In uppercase or lowercase characters, which are not changed by the system.
BINARY | TEXT
specifies that the data set being copied contains binary data or text.
BINARY
Specifies that the data set being copied contains binary data. This is the
default for a data set of undefined record format.
TEXT
Specifies that the data set being copied contains text. This is the default for
a data set of fixed record format or variable record format.
CONVERT(character_conversion_table | YES | NO)
Specifies that the data being copied is to be converted from IBM-037 or ASCII
to EBCDIC Latin 1/Open Systems Interconnection code page 01047—that is,
866 z/OS V1R9.0 UNIX System Services Command Reference