MEMBER
Applicable Control statements
COPYMODSELECT
58 MVS/370 Utilities
Description of Parameters
MAXBlK=(nnnnnlnnKlspecifies~he maximum block size for records in the output partitioned data set. MAXBlK is normally used to specify a smaller block size than the default, in order to make the records in the data set compatible with other systems or programs.
nnnnn is specified as a decimal number; K indicates that the
un
value is multiplied by 1024 bytes.MAXBlK may be specified with or without MINBlK.
Default:
The track size for the output device or 18K, whichever is smaller. If a value greater than 18K (18432) or less than 4K (4096) is specified, the default is used.specifies the members to be selected from the input data set. The values that can be coded for SELECT are:
specifies the name of a member that 1s to be selected in a copy step. Each member name specified within one copy step must be unique; that is, duplicate names cannot be specified as either old names, or new names, or both, under any circumstances. If no member name is specified, the entire data set is included in the operation.
newname
R
specifies a new name for a selected member. The member is copied, unloaded, or loaded to the output partitioned data set using its new name. If the name already appears on the output partitioned data set, the member is not copied unless replacement
(R) is also specified.
spec if i es that the input Inember i s to replace any identically named member that exists on the output partitioned data set. The replace option is not valid for an unload or alter operation.
Parameters
MEMBER
MINBLK
OUTDO
APplicable Control statements
EXCLUDE
COPYMOD
COPY COPYMOD ALTERMOD
Description of Parameters
MEMBER=[(]membernamel[,membername2] ••• [)]
specifies members on the input data set that are not to be copied, unloaded, or loaded to the output data set. The members are not deleted from the input data set unless the entire data set is deleted. (This can be done by specifying DISP=DELETE in the operand field of the input DO job control statement.) Each member name specified within one copy step must be unique.
MINBLK=CnnnnnlnnKl
specifies the mInImum block size for records in the output partitioned data set. MINBLK specifies the smallest block which should be written on the end of a track for the
purpose of improving utilization of OASO storage.
A small MINBLK value will improve track utilization; however, a large MIHBLK value (close to the track size) will improve system fetch (IEWFETCH) performance. When determining the value of MIHBLK, you should consider the importance of fetch performance versus optimal OASO storage. In any case,
in order to have room for RLD counts, the value of MIHBLK should be less than the size of one full track.
nnnnn is specified as a decimal number; K indicates that the
un
value is multiplied by 1024 bytes.MIHBLK may be specified with or without MAXBLK.
Default:
lK (1024). If a value greater than MAXBLK or less than 1K is specified, lKis used. The default for the installation can be changed by altering the value in the assembler statement 'MIHBLK DC F'1024" in the macro IEBMCA and reassembling the module IEBOSCPY.
OUTDD= ddname
specifies the name of the output partitioned data set. One ddname is required for each copy, unload, or load operation; the ddname used must be specified on a DO statement.
When the COPY or COPYMOD or ALTERMOD
statement is used, OUTDO must be specified.
IEBCOPY EXAMPLES
The following examples illustrate some of the uses of IEBCOPY.
Figure 22 on page 61 can be used as a quick-reference guide to IEBCOPY examples. The numbers in the "Example" column point to examples that follow.
Examples that use disk or tape, in place of actual device
numbers, must be changed before use. See "DASD and Tape Device Support" on page 3 for valid device number notation.
60 MVS/370 Utilities
Operation Device Comments Example COPY Disk Full Copy. The input and output data sets are 1
partitioned.
COpy Disk Multiple input partitioned data sets. 2 Fixed-blocked and fixed-record formats.
COpy Disk All members are to be copied. Identically 3 named members on the output data set are to be replaced. The input and output data sets are partitioned.
COPY Disk Selected members are to be copied. 4
Variable-blocked data set is to be created.
Record formats are variable-blocked and
variable. The input and output data sets are partitioned.
COPY Disk Selected members are to be copied. One member 5 is to replace an identically named member on
the output data set. The input and output data sets are partitioned.
COpy Disk Selected members are to be copied. Members 6 found on the first input data set replace
identically named members on the output data set. The input and output data sets are partitioned.
COPY Disk Selected members are to be copied. Two 7 members are to be renamed. One renamed member
is to replace an identically named member on the output data set. The input and output data sets are partitioned.
COpy Disk Exclusive Copy. Fixed-blocked and 8
fixed-record formats. The input and output data sets are partitioned.
Unload and Disk and Copy a partitioned data set to tape (unload) 9 Compress- Tape and compress-in-place if the first step is
in-place successful.
COpy and Disk Full copy to be followed by a 10 Compress- compress-in-place of the output data set.
in-place Replace specified for one input data set. The input and output data sets are partitioned.
COpy Disks Multiple copy operations. The input and 11 output data sets are partitioned.
COPY Disks Multiple copy operations. 12
Unload Disk and A partitioned data set i s to be unloaded to 13 Tape tape.
Load Tape and An unloaded data set is to be loaded to disk. 14 Disk
Unload, Disk and Selected members are to be unloaded, loaded, 15 Load, and Tape and copied. The input data set i s
COPY partitioned; the output data set is sequential.
Alter in Disk Selected members are to be altered in place. 16 Place