ETERNUS SF XL-DATA/MV V13 User's Guide

2.4.1.3 mftfdvalt command

Syntax

mftfdvalt

device name   client system name before modification [ /server system name ] { client system name after modification [ /server system name ] | -p full path device name | -d physical drive name }   [ -f ]

Overview

The mftfdvalt command is used for changing the declared client system name, server system name, full path name, or physical drive name of the data transfer volume that was initialized by the mftfdvini command.
Also, this command is only available to the root.
A confirmation prompt is always displayed when executing this command. Select [Yes] to execute, or [No] to abort.

---



If this command is executed on a data transfer volume that has not been initialized by the mftfdvini command, an error occurs.

---

Option

device name

Specify the full path name for the character device name of the data transfer volume.   (required)

For Solaris	:	Specify the special file name (e.g., /dev/rdsk/c1t1d2s2) with the partition number "s2," which refers to the entire volume.
For HP-UX	:	Specify the character device file name (e.g., /dev/rdsk/c1t1d2).
For Linux	:	Specify the character device file name (e.g. /dev/raw/raw2) whose block device name was bound by the raw command.

client system name before modification [/server system name]

Specify the client system name and server system name before modifications within 15 characters.   (required)
When changing only the client system name, specify only the client system name.
When modifying the server system name and/or the server device information, specify the client system name and server system name.
Note that the client system name and server system name cannot be modified at the same time.
Refer to the "initialization command remarks" regarding the client system name and server system name.

client system name after modification [/server system name]

Specify the client system name and server system name after modifications within 15 characters.
Specify the client system name and server system name for the client system name [/server system name] before modification.
If only the client system name is specified for the specification before modification, specify only the client system name after the modification. If you specify the client system name and server system name before modification, also specify the client system name and server system name after modification.
Refer to the "initialization command remarks" regarding the client system name and server system name.

-p full path device name

If the server system to be modified is a UNIX server, specify the device information (i.e., the full path name of the device) of the server system within 64 characters.
Device information cannot be specified with the -d option.

For Solaris	:	Specify the special file name (e.g., /dev/rdsk/c1t1d2s2) with the partition number "s2," which refers to the entire volume.
For HP-UX	:	Specify the character device file name (e.g., /dev/rdsk/c1t1d2).
For Linux	:	Specify the character device file name (e.g. /dev/raw/raw2) whose block device name was bound by the raw command.

Example: -p /dev/rdsk/c1t2d3s2

-d physical drive name

If the server system to be modified is an IA server, specify the device information (i.e., the physical drive name) of the server system within 64 characters.
Device information cannot be specified with the -p option.

Example: -d PHYSICALDRIVE2

-f

Specify this to force the modification even when the data transfer volume is in use.
When executing this option during a data transfer, the data being transferred cannot be guaranteed.

Return Values

0 is returned when successful.
Otherwise an error message is output and -1 is returned.

Example of Usage/Application

When modifying the declared client system name of the UNIX server of the data transfer volume "/dev/rdsk/c1t2d3s2" from "unixunix" to "unix02":

mftfdvalt   /dev/rdsk/c1t2d3s2   unixunix   unix02

When modifying the declared server system name of the IA server of the data transfer volume "/dev/rdsk/c1t2d3s2" that corresponds to the declared client system name "unix02" of the UNIX server from "win02" to "win10":

mftfdvalt   /dev/rdsk/c1t2d3s2   unix02/win02   unix02/win10

When modifying the device name of the data transfer volume that corresponds to the declared client system name "unix02" of the UNIX server and declared server system name "unix001" of the UNIX server from "/dev/rdsk/c1t2d3s2" to "/dev/rdsk/c2t1d6s2":

mftfdvalt  /dev/rdsk/c1t2d3s2  unix02/unix001  -p /dev/rdsk/c2t1d6s2

When modifying the device name of the data transfer volume "/dev/rdsk/c1t2d3s2" that corresponds to the declared client system name "unix02" of the UNIX server and declared server system name "WIN01" of the IA server from 'no setting' to "PHYSICALDRIVE2":

mftfdvalt   /dev/rdsk/c1t2d3s2   unix02/WIN01   -d PHYSICALDRIVE2