MOVEFILE                                                  CMS User Area command

Use the MOVEFILE command to move data from any device supported by VM/370 to
any other device supported by VM/370.  The format of the MOVEFILE command is:
+----------+------------------------------------------------------------------+
| MOVEfile | [INMOVE inddname OUTMOVE outddname]] [(PDS[)]]                   |
+----------+------------------------------------------------------------------+
where:

inddname is the ddname representing the input file definition.  If ddname is
         not specified, the default input ddname, INMOVE, is used.

outddname
         is the ddname representing the output file definition.  If ddname is
         not specified, the default output ddname, OUTMOVE, is used.

Option:

PDS      moves each of the members of the CMS MACLIB or TXTLIB or of an OS
         partitioned data set into a separate CMS disk file.  Each CMS file has
         a filename equal to the member name and a filetype equal to the
         filetype of the output file definition.


Usage notes:

1.  Use the FILEDEF command to provide file definitions for the ddnames used in
    the MOVEFILE command.  If you use the ddnames INMOVE and OUTMOVE on the
    FILEDEF commands, then you need not specify them on the MOVEFILE command
    line.  For example:
       filedef inmove disk sys1 maclib b (member stow
       filedef outmove disk stow macro
       movefile
    copies the member STOW from the OS partitioned data set SYS1.MACLIB into
    the CMS file STOW MACRO.  If you enter:
       filedef indd reader
       filedef outdd printer
       movefile indd outdd
    a file is moved from your virtual reader to your virtual printer.

2.  To copy an entire OS partitioned data set into individual CMS files, you
    could enter:
       filedef test2 disk sys1 maclib b
       filedef macro disk
       movefile test2 macro (pds
    These commands copy members from the OS partitioned data set SYS1.MACLIB or
    the CMS file SYS1 MACLIB into separate files, each with a filename equal to
    the membername and a filetype of MACRO.  Note that the output ddname was
    not specified in full, so that CMS assigned the default file definition
    (FILE ddname).

3.  You cannot copy VSAM data sets with the MOVEFILE command.

4.  The MOVEFILE command does not support data containing spanned records.  Use
    of spanned records results in the error message DMSSOP036E and an error
    code of 7.

Default Device Attributes:

If a record format (RECFM), blocksize (BLOCK), and logical record length
(LRECL) are specified on the FILEDEF command, these values are used in the data
control block (DCB) defining the characteristics of the move operation.  If the
FILEDEF was issued without a record format or blocksize specified, these values
are determined according to the defaults listed below.  If the blocksize was
not specified, the default blocksize is used.  If the logical record length was
not specified, the default logical record length is determined as follows:  for
an F or U record format, the logical record length equals the blocksize; for a
V record format, the logical record length equals the blocksize minus 4.
     +-------------+---------------------+-----------------------------+
     ¦             ¦ Input ddname        ¦ Output ddname               ¦
     ¦             +---------+-----------+--------------+--------------+
     ¦ Device      ¦ RECFM   ¦ Blocksize ¦ RECFM        ¦ Blocksize    ¦
     +-------------+---------+-----------+--------------+--------------+
     ¦ Card Reader ¦ F       ¦ 80        ¦ NA(2)        ¦ NA(2)        ¦
     ¦ Card Punch  ¦ NA(2)   ¦ NA(2)     ¦ F            ¦ 80           ¦
     ¦ Printer     ¦ NA(2)   ¦ NA(2)     ¦ U            ¦ 132          ¦
     ¦ Terminal    ¦ U       ¦ 130       ¦ U            ¦ 130          ¦
     ¦ Tape(1)     ¦ U       ¦ 3600      ¦ RECFM of     ¦ Blocksize of ¦
     ¦             ¦         ¦           ¦ input ddname ¦ input ddname ¦
     ¦ Disk file   ¦ RECFM   ¦ Blocksize ¦ RECFM of     ¦ Blocksize of ¦
     ¦             ¦ of file ¦ of file   ¦ input ddname ¦ input ddname ¦
     ¦ Dummy       ¦ NA(2)   ¦ NA(2)     ¦ RECFM of     ¦ Blocksize of ¦
     ¦             ¦         ¦           ¦ input ddname ¦ input ddname ¦
     +-------------+---------+-----------+--------------+--------------+
     ¦ (1) If the default record format and blocksize are used in a    ¦
     ¦     tape-to-tape move operation and an input record is greater  ¦
     ¦     than 3600 bytes, it is truncated to 3600 bytes on the       ¦
     ¦     output tape.                                                ¦
     ¦ (2) Not applicable.                                             ¦
     +-----------------------------------------------------------------+

Responses:

DMSMVE225I      PDS MEMBER MEMBERNAME MOVED
   The specified member of an OS partitioned data set was moved successfully to
   a CMS file.  This response is issued for each member moved when you use the
   PDS option.

DMSMVE226I      END OF PDS MOVE
   The last member of the partitioned data set was moved successfully to a CMS
   file.

DMSMVE706I    TERMINAL INPUT -- TYPE NULL LINE FOR END OF DATA
   The input ddname in the MOVEFILE specified a device type of terminal.  This
   message requests the input data; a null line terminates input.

DMSMVE708I      DISK FILE 'FILE ddname A1' ASSUMED FOR DDNAME 'ddname'
   No file definition is in effect for a ddname specified on the MOVEFILE
   command.  The MOVEFILE issues the default FILEDEF command:
      FILEDEF ddname DISK FILE ddname A1
   If file ddname does not exist for the input file, MOVEFILE terminates
   processing.