Ordering input of control statements

You must specify TDMF control statements in the following required order.

Procedure

  1. The SESSION control statement must appear first. This statement can include a session name and the SMF identifiers of the Master and Agent systems. It can also include the Communications data set name, options applicable to the session itself, and default settings for volume migration. If the communications data set name is omitted, the name is extracted from the session’s JCL
  2. In a TCP/IP migration session, where the target devices are controlled by another TDMF Master system at a remote location, the REMOTE control statement is required. This statement must immediately follow the SESSION control statement. The REMOTE control statement defines the migration session IP Port number and the remote Master system IP host name. For more information, see REMOTE control statement.
  3. A GROUP control statement can precede a number of MIGRATE or REPLICATE statements. The volumes in these subsequent statements are synchronized together. Options that are specified on this control statement apply to the volumes in the group, and are discarded when a new GROUP control statement is encountered. Do not specify the grouped volumes with a mixture of MIGRATE and REPLICATE control statements. A maximum of 32 GROUP statements can be supplied in a session.
  4. A MIGRATE control statement specifies a volume swap migration. If it is to be treated as a single (ungrouped) volume, the control statement must precede any GROUP statements in the input stream. The statement provides the source and target volume for the migration, and can supply a new volume serial number to be written to the source volume after the swap. The MIGRATE statement also provides options that apply to this volume migration alone. No MIGRATE statements can be specified in a session that contains a REMOTE statement.
  5. A REPLICATE control statement specifies a volume Point-in-Time migration. If it is to be treated as a single (ungrouped) volume, the REPLICATE control statement must precede any GROUP statements in the input stream. If a remote system is provided on the control statement, the second or only target volume is assumed to be at the remote system. If two target volumes are supplied, but no remote system exists, a duplex local volume copy is made. Options that are specified on this control statement apply to the single volume migration only. Any options that are specified on the preceding GROUP and SESSION statements and the installation defaults are overwritten.
    Important: For volumes that are not part of a group, the MIGRATE and REPLICATE control statements must precede the GROUP control statement.