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

4.2.1 mftfsend Command

Syntax

UNIX Server	mftfsend   [ -f clientfile ]   serverfile
IA Server	mftfsend.exe   [ -f clientfile ]   serverfile

Description

The data is saved to the file specified by clientfile following -f of the client system, or the data is sent to the server from the standard input and saved to the file/data set specified by serverfile of the server system.
When sending data to the UNIX/IA server system, the data transfer can only be performed by a user matching the user name registered in the "user registration file" of the server system.
Refer to "Registering Data Transfer Users" for more details on the matter.
This command is not available for the following users:

• For IA server, users not belonging to the Administrators group.

When a user above mentioned executes the command, an error occurs.

Option

-f clientfile

Specify the full path of the transfer source file name.
"clientfile" specifies the file name according to the source client system as shown below.

Client System		Rules
UNIX	Solaris	A file name up to 1023 bytes in ASCII code is specified.
	HP-UX	A file name up to 1023 bytes in ASCII code is specified.
	Linux	A file name up to 1023 bytes in ASCII code is specified.
IA		A file name up to 260 bytes in ASCII code is specified.

If this option is omitted, the data from the standard input becomes the source data. If multiple options are specified, the final option specified is used.

serverfile

Specify the transfer destination file name or data set name.
Multiple file / data set names cannot be specified.
If a "serverfile" does not exist in the transfer destination server system, create a new one.
Also, When creating a new file in a data transfer to a UNIX/IA server system, a directory is also created in the case where the upper directory does not exist (Refer to "Setting the Permission Level of New Files" of "User Verification" for the permission of the UNIX/IA server).
If a "serverfile" exist in the transfer destination server system, it is overwritten.
The file name specified by "serverfile" is specified according to the server system as shown below.

Server System		Rules, Note
UNIX	Solaris	A file name up to 1023 bytes in ASCII code is specified.
	HP-UX	A file name up to 1023 bytes in ASCII code is specified.
	Linux	A file name up to 1023 bytes in ASCII code is specified.
IA		A file name up to 260 bytes in ASCII code is specified. Use single quotes or double quotes when specifying the file (e.g., 'filename' or "filename"). However, in XL-DATA/MV, a file cannot be sent to a network drive subordinate.

Environment Variables

When using this command, specify the following environment variables to configure the data transfer related settings.

Environment Variable	Required	Description
MFTF_USER	YES	User name of the server system
MFTF_DEVICE	YES	Intermediate character device name of the client system
MFTF_CLLINECODE		Separator code of the client system
MFTF_SVLINECODE		Separator code of the server system
MFTF_COMMAND		Filter Command

The environment variables are described below.

MFTF_USER

Specifies the user name of the target server system.
The user name must be within 127 bytes in ASCII code.
The user name specified here is specified according to the transfer destination server system as shown below.

Server System	Rules
UNIX	Specify the user name registered in the server system.
IA	Specify "WINDOWS" (without the double quotations).

MFTF_DEVICE

Specifies the intermediate character device name, which is used for sending data, within 64 bytes.
If multiple values are specified for this environment variable, the transfer is performed by automatically selecting the fastest device.
To specify multiple devices, separate each device with a ":" (colon) for UNIX servers or a ";" (semicolon) for IA servers.
When specifying multiple devices, even if each character device name is within 64 bytes length, if the total length of all the names together exceeds 64 bytes, the first 64 bytes are treated as valid data and only valid device names within this first 64 bytes are used.
Specify the following for the character device names specified here:

UNIX Server

Specify the full path of the data transfer volume defined by the initialization command.

For Solaris


Example:

For host-adapter-id=1, target-id=2, and logical unit=3 *The partition that can view the entire logical unit is s2 for Solaris. setenv MFTF_DEVICE /dev/rdsk/c1t2d3s2

For HP-UX


Example:

For host-adapter-id=1, target-id=2, and logical unit=3 setenv MFTF_DEVICE /dev/rdsk/c1t2d3

For Linux


Example:

When binding the /dev/sda2 device to /dev/raw/raw2 with the raw command setenv MFTF_DEVICE /dev/raw/raw2

IA Server

Specify the device by adding the physical disk number (the xx portion of "Diskxx"), which was selected by the Disk Utility, to the end of "PHYSICALDRIVE".
If the physical disk number starts with a 0, the leading 0 must be omitted when specifying the number.
Refer to the following example:

Example:

When the physical disk number is 1 ("Disk01") set MFTF_DEVICE=PHYSICALDRIVE1

MFTF_CLLINECODE

This specifies the separator code used to distinguish the end of a record (a line) in "clientfile" when transferring data by the record (line) (when transferring text data).
Specifying this environment variable performs data transfers using the "Change Separator Function".

If this environment variable is not specified, the source data is sent as a binary transfer rather than as records (data lines).

The code must be an ASCII code.
The separator can be 1 to 4 bytes. When specifying a character code that is 2 bytes or larger, specify each code 1 byte at a time.
To specify multiple separator codes, separate each code with a ":" (colon) for UNIX servers or a ";" (semicolon) for IA servers.
Specify the separator code in the following format for the MFTF_CLLINECODE variable:

[0 [{x | X}]]character code[{:|;}...]

The character code is a single ASCII character.

To specify the ASCII code in hexadecimal	Specify '0' for the first character and 'x' or 'X' for the second character, then specify the ASCII code.
To specify the ASCII code in octal	Specify '0' for the first character followed by the ASCII code.
To specify the ASCII code in decimal numbers	Simply specify the ASCII code.

Example:

When specifying the hexadecimal values 0d and 0a in a UNIX system 0x0d:0x0a

MFTF_SVLINECODE

This specifies the separator code used to distinguish the end of a record (a line) in "serverfile" when transferring data by the record (line) (when transferring text data).
This variable must be specified if the MFTF_CLLINECODE environment variable is specified.
This variable is in effect when the target server system is a UNIX/IA server.

The code must be an ASCII code.
The separator can be 1 to 4 bytes. When specifying a character code that is 2 bytes or larger, specify each code 1 byte at a time.
To specify multiple separator codes, separate each code with a ":" (colon) for UNIX servers or a ";" (semicolon) for IA servers.
Specify the separator code in the following format for the MFTF_SVLINECODE variable:

[0 [{x | X}]]character code[{:|;}...]

The character code is a single ASCII character.

To specify the ASCII code in hexadecimal	Specify '0' for the first character and 'x' or 'X' for the second character, then specify the ASCII code.
To specify the ASCII code in octal	Specify '0' for the first character followed by the ASCII code.
To specify the ASCII code in decimal numbers	Simply specify the ASCII code.

Example:

When specifying the hexadecimal values 0d and 0a in a UNIX system 0x0d:0x0a

MFTF_COMMAND

Specifies the filter command string to execute in the target server system. The name of the file specified here must be specified using its full path.
Options may also be specified, but they must be entered in a format that the shell can read.
If the file name or directory name of the filter command has spaces, they must be specified in single quotations (' ') or double quotations (" ") (double quotations for IA servers) in order for the shell to recognize them.
The file name must be within 2047 bytes in ASCII code.
If this environment variable is omitted, the filter command is not executed in the target server system. This variable is in effect when the target server system is a UNIX/IA server.
This filter command specification must comply with the format of the filter command in order for the transfer to process normally. Refer to the section on Calling the Filter Command for details on the format of the filter command.

Return Value

0 is returned when an operation is successful.
In the event of a filter command error (i.e., when the return code of the filter command is other than 0), the following value is returned, based on the results of the "filter command return code conversion file," and the message is sent to the standard error output. For details refer to "Creating the Filter Command Return Code Conversion File".

Results of the Filter Command Return Code Conversion File	Return Value
Filter command return code conversion file does not exist.	Return code of the filter command
No corresponding information in the filter command return code conversion file
The return code of the filter command corresponds to NORMAL	0
The return code of the filter command corresponds to WARNING	The value specified by "WARNING" in the filter command return code conversion file
The return code of the filter command corresponds to ERROR	-1 (255 for UNIX servers)

-1 (255 for UNIX servers) is returned for other cases, and the message is sent to the standard error output.



When running the transfer command on a UNIX server, the return value may be evaluated based on which shell is being used.