Load modules in either overlay or scatter-load format and modules which were link-ed;ted with the noneditable (NE) attribute or with an assigned origin other than zero will be copied, but not reblocked or altered (that is, as if the member was specified with a COpy statement). Members which are not recognized as load modules will be copied, but not reblocked or altered.
Note that modules which are not reblocked by COPYMOD cannot be copied to a device which has a track size less than the input block size. They may, however, be re-link-edited with a smaller block size.
The replace (R) function may be specified with input ddnames and/or member names to cause like-named modules to be replaced, or it may be omitted to prevent the copying of like-named
modules.
The rename function may be invoked to specify a new name for the selected member. For more information, see "SELECT Statement."
IEBCOPY can unload modules to a sequential data set via the COpy function, and the output of that step can be input to a
subsequent COPYMOD step in which the output data set is the same as the input to the unload step. This would also provide a backup copy in the sequential data set.
The format of the COPYMOD statement is:
[label] COPYMOD OUTDD=ddname
,INDO=[(]ddnamel[,ddname2]
[,(ddname3,R)][, ••• ][)]
[,MAXBLK=CnnnnnlnnK)]
[,MINBLK=CnnnnnlnnK)l [,LIST=NO]
INDD specifies the partitioned or sequential (unloaded) data set from which load modules are to be read. OUTDD specifies the partitioned data set to which load modules are to be copied.
MAXBLK specifies the maximum block size for records in the output data set. MINBLK specifies the minimum block size for records in the output data set.
The SELECT statement specifies members (or modules, in the case of AlTERMOD or COPYMOD) to be selected from input data sets to be altered, copied, loaded, or unloaded to an output data set.
This statement is also used to rename and/or replace selected members on the output data set. More than one SELECT statement may be used in succession, in which case the second and
subsequent statements are treated as a continuation of the first.
The SELECT statement must follow either a COpy statement that includes an INDD parameter, a COPYMOD statement, or one or more INDD statements. A SELECT statement cannot appear with an
EXCLUDE statement in the same copy, unload, or load step, and it cannot be used with a compress-in-place function.
When a selected member is found on an input data set, it is not searched for again, regardless of whether the member is copied, unloaded, or loaded. A selected member will not replace an identically named member on the output partitioned data set unless the replace option is specified on either the data set or member level. (For a description of replacing identically named 54 MVS/370 Utilities
members, see "Replacing Identically Hamed Members" on page 41 and "Replacing Selected Members" on page 4~.) In addition, unless the replace option is specified, a renamed member will not replace a member on the output partitioned data set that has the same new name as the renamed member.
The replace (R) and rename (newname) options cannot be specified with ALTERMOD.
The format of the SELECT statement is:
[label] SELECT MEMBER: {[(]namel[,name2][, ••• ][)]1
( { ( n am e 1 , n e~ ... n a m e [ , R 1 ) [ , ••• 1
I
(namel,newname)[, ••• ll (namel"R)[, ••• ][)])
where:
MEMBER:
specifies the members to be selected from the input data set. The values that can be coded are:
specifies the name of a member that is 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.
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. newname cannot be specified with ALTERMOD.
specifies that the input member is to replace any identically named member that exists on the output partitioned data set. The replace option is not valid for an unload operation. R cannot be specified with ALTERMOD.
The control statement operation and keyword parameters can be abbreviated to their initial letters; SELECT can be abbreviated to S and MEMBER can be abbreviated to M.
To rename a member, the old member name ;s specified in the SELECT statement, followed by the new name and, optionally, the R parameter. When this option is specified, the
old
member name andnew
member name must be enclosed in parentheses. When any option within parentheses is specified anywhere in the MEMBER field, the entire field, exclusive of the MEMBER keyword, must be enclosed in a second set of parentheses.EXCLUDE statement
The EXCLUDE statement specifies members to be excluded from the copy, unload, or load step. Unlike the selective
copy/alter/unload/load, an exclusive copy/alter/unload/load causes all members (or modules, in the case of ALTERMOD or COPYMOD) specified on each EXCLUDE statement to be omitted from the operation.
More than one EXCLUDE statement may be used in succession, in which case the second and subsequent statements are treated as a continuation of the first. The EXCLUDE statement must follow either a COPY statement that includes an INDO parameter, an ALTERMOD or COPYMOD statement, or one or more INDD statements.
An EXCLUDE statement cannot appear with a SELECT statement in the same copy, unload, or load step; however, both may be used following a COPY statement for a copy or load operation. The EXCLUDE statement cannot be used with a compress-in-place function.
The format of the EXCLUDE statement is:
EXCLUDE MEMBER=[(]membernamel[,membername2] ••• [)]
The control statement operation and keyword parameters can be abbreviated to their initial letters; EXCLUDE can be abbreviated to E and MEMBER can be abbreviated to M.
If neither SELECT nor EXCLUDE is specified, the entire data set is copied (a "full copy").
56 MVS/370 Utilities
Parameters INDO
LIST
Applicable Control statements COPY
COPYMOD
COpy COPYMOD ALTERMOD
Description of Parameters
INDD=[(]ddnamel[,ddname2][,(ddname3,R)]
[ ,
...
] [ ) ]specifies the names of the input partitioned data sets. INDO may, optionally, be placed on a separate line following a COPYMOD or COPY statement containing the OUTDO
parameter, another INDO statement, a SELECT statement, or an EXCLUDE statement. These values can be coded:
ddname
R
LIST=NO
specifies the ddname, which is specified on a DO statement, of an input data set. In the case of COPYMOD, this is the name of a load module. For an unload operation, only one ddname may be specified per COpy statement. If more than one ddname is specified in the case of a copy or load operation, the input data sets are processed in the same sequence as the ddnames are specified.
specifies that all members to be copied or loaded from this input data set are to replace any identically named
members on the output partitioned data set. (In addition, members whose names are not on the output partitioned data set are copied or loaded as usual.>
When this option is specified with the INDD parameter, it does not have to appear with the MEMBER parameter
(discussed in "SELECT Statement" on page 54) in a selective copy operation.
When this option is specified, the ddname and the R parameter must be enclosed in a set of parentheses; if it is specified with more than one ddname in INDD, the entire field, exclusive of the INDO parameter, must be enclosed in a second set of parentheses.
specifies that the names of copied members are not to be listed on SYSPRINT at the end of each input data set.
Default: The names of copied members are listed.