Rules and Restrictions for Move or Copy Operations

At least one data set must be an library. The other can be an or partitioned data set member or a DASD-resident sequential data set.
cl
At least one data set must be an
CA Librarian
library. The other can be an
CA Librarian
or partitioned data set member or a DASD-resident sequential data set.
Record format (non-
CA Librarian
data sets):
  • Blocked or unblocked
  • With or without printer control characters. If present, printer control characters are treated as data.
  • Logical record length (LRECL) must be 80.
These rules apply for all move/copy operations:
  • If the TO data set is sequential, its contents are replaced entirely (for disposition OLD) or added to (for disposition MOD).
  • If the TO data set is one of the following, members are added or replaced, depending on whether like names already exist in the TO data set:
    • Partitioned
    • A BDAM or VSAM
      CA Librarian
      master file
    • A wide record master file (where the FROM data set is neither a BDAM nor VSAM master file)
    Replacement is subject to user control -- see panel description.
  • If the TO data set is a wide record master file and the FROM data set is either a BDAM or VSAM master file, members are added if they do not already exist on the TO master file. If like-named members:
    • Exist on the TO master file, members are updated.
    • Do not exist on the TO master file, members are added.
    If archiving is turned:
    • On for the TO master file/member, all archive levels are copied to the TO master file.
    • Off for the TO master file/member, only the most recent archive level is copied from the FROM master file.
      The most current archive level for the member on the TO master file is replaced, and older levels, if present, are retained. The exception to this is if a specific archive level is specified. In that case, only that archive level is copied.
  • If the TO data set is a wide record master file and the FROM data set is either a BDAM or VSAM master file, added and updated dates and times of any archive levels copied are maintained across the copy. That is, the added and last-updated dates and times of the newly copied TO member reflects those for that particular level on the FROM master file.
  • The data to move or copy is not renumbered or modified in any way except that
    CA Librarian
    -INCs can be expanded and SLAT (source load audit trail) variables can be replaced per the panel 1 option.
  • ISPF library statistics that reflect the
    CA Librarian
    module control information are created for the module when copying to a partitioned data set.
ISPF services are invoked when the TO data set is a PDS, and results are subject to limitations of these services.
  • When the FROM data set is
    CA Librarian
    , only the current archive level is copied (except in the case in which the FROM data set is either BDAM or VSAM
    and
    the TO data set is a wide record master file).
The characteristics of both data sets that participate in a move or copy operation must be as follows:
  • Both data sets must exist and be cataloged. (The move/copy utility does not automatically allocate space for a new TO data set.)
  • At least one data set must be an
    CA Librarian
    library, the other can be LIBRARIAN, partitioned, or a DASD-resident sequential data set.
  • Non-
    CA Librarian
    data sets can be blocked or unblocked, but they must have a fixed record format with a logical record length of 80 (with or without printer control characters).
These rules also apply for all move/copy operations.
  • If the TO data set is sequential, its contents are replaced entirely (for disposition OLD) or added to (for disposition MOD).
  • If the TO data set is an
    CA Librarian
    library or partitioned data set, members are added or replaced (replaced if the TO dataset is not a wide record master file and the FROM data set is not a BDAM or VSAM master file; otherwise archive levels are updated per the description above) depending on whether like names already exist in the TO data set. (Replacement is subject to user control -- see panel description.)
  • The data to move or copy is not renumbered or modified in any way.
  • ISPF library statistics that reflect the
    CA Librarian
    member control information are created for the member when copying to a partitioned data set.
ISPF services are invoked when the TO data set is a PDS, and results are subject to limitations of these services.
  • When the FROM data set is LIBRARIAN, only the current archive level is copied (except in the case in which the FROM data set is either BDAM or VSAM
    and
    the TO data set is a wide record master file).