The INCLUDE statement is used to enlarge the scope of MOVE DSGROUP,
COPY DSGROUP, MOVE PDS, or COPY PDS statements by including a member
or a data set not explicitly defined in those statements. The INCLUDE
statement follows the MOVE or COPY statement whose function it modifies.
The record characteristics of the included partitioned data sets must
be compatible with those of the other partitioned data sets being
moved or copied.
Any number of INCLUDE statements can modify a MOVE or COPY statement.
For a partitioned data set, the INCLUDE statement is invalid when
data is unloaded or when unloaded data is moved or copied. For DSGROUP
operations, INCLUDE is invalid.
The syntax of the INCLUDE statement is:
Label |
Statement |
Parameters |
---|
[label] |
INCLUDE |
DSNAME=name |
|
|
[,MEMBER=membername] |
|
|
[,{FROM=device={serial|
(list)| |
where:
- DSNAME=name
- specifies the fully qualified name of a data set. If used in
conjunction with MOVE or COPY DSGROUP, the named data set is included
in the group. If used in conjunction with MOVE or COPY PDS, either
the named partitioned data set or a member of it (if the MEMBER parameter
is specified) is included in the operation.
- MEMBER=membername
- specifies the name of one member in the partitioned data set
named in the DSNAME parameter. The named member is merged with the
partitioned data set being moved or copied. Neither the partitioned
data set containing the named member nor the member is scratched.
- FROM=device={serial| (list)}
- specifies the device type and serial number of the volume on
which the data sets to be included reside. If the data sets reside
on more than one volume, enclose the list of serial numbers within
parentheses, separating the numbers with commas.
If the data set
is cataloged, do not code "FROM".
If you want to specify
a specific device rather than device type, code the device number
in the device subparameter.
If the data set resides
on a tape device, the serial number must be enclosed in parentheses,
and the data set sequence number must be included as follows: "(serial,sequence
number)".