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

Usage notes
Do not use the CONVERT parameter on files containing doublebyte data.
Doublebyte data in the file system is in code page 939. If conversion to a
code page other than 939 is required, you should use the iconv command.
LC
Specifies that the z/OS UNIX system file names can be lowercase, uppercase,
or mixed. If LC is not specified, the z/OS UNIX system file names must be
uppercase. File names are converted to uppercase member names.
QUIET
Turns off the echoing of the OGET command before a file is copied.
SUFFIX(suffix)
Specifies that files with the files created by (suffix) be copied and the suffix be
dropped from the z/OS UNIX system file name when the PDS members are
created.
A suffix is an optional additional file identifier that is appended to the file name
following the first period (.). It is usually used to identify the type of file.
1. Avoid using OGETX with path names containing single quotes or spaces.
OGETX
2. For text files, all characters are stripped during the copy. Each line in
the file ending with a character is copied into a record of the MVS
data set. You cannot copy a text file to an MVS data set in an undefined record
format.
v For an MVS data set in fixed record format: Any line longer than the
record size is truncated. If the line is shorter than the record size, the record
is padded with blanks.
v For an MVS data set in variable record format: Any line is longer than the
largest record size is truncated; the record length is set accordingly. A change
in the record length also occurs if the line is short.
3. For binary files, all data is preserved.
v For an MVS data set in fixed record format: Data is cut into chunks of size
equal to the record length. Each chunk is put into one record. The last record
is padded with spaces or blanks.
v For an MVS data set in variable record format: Data is cut into chunks of
size equal to the largest record length. Each chunk is put into one record.
The length of the last record is equal to the length of the data left.
v For an MVS data set in undefined record format: Data is cut into chunks
of size equal to the block size. Each chunk is put into one record. The length
of the last record is equal to the length of the data left.
4. Data sets with spanned records are not allowed.
5. Before the copy, the OGET command for a file is echoed, unless you specify
the QUIET option. If you did not specify QUIET and if the command is not
echoed for a file, it has not met the copy criteria and is not copied.
6. If more than one file name is the same, the file is overwritten on each
subsequent copy. For example, if you specify a copy of Pgma and pgma and
use LC, the first file copied is overwritten. Or if you copy pgma.h and pgma.c
and specify SUFFIX, the first file copied is overwritten.
7. If the target data set is a PDS with an undefined record format, the files may be
treated as load modules. A load module is copied by link-editing it into the target
library. For the program to be able to execute, the entry point must be at the
beginning of the load module.
Chapter 3. TSO/E commands 851