| ETERNUS SF XL-DATA/MV V13 User's Guide |
|
Contents
Index
|
| Chapter 4 : UNIX/IA Server Data Transfers | > 4.2 Transfer Command Reference |
Syntax| UNIX Server | mftfrecv [ -t clientfile ] serverfile |
|---|---|
| IA Server | mftfrecv.exe [ -t clientfile ] serverfile |
DescriptionThe client system receives the data, which is stored in the file specified by "serverfile", from the server system, and then stores it to the file specified by "clientfile" following "-t" or outputs it to the standard output.
When receiving data from the UNIX/IA server system, the data can only be received 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 the IA server, users not belonging to the Administrators group.
When a user above mentioned executes the command, an error occurs.
Option-t clientfile
Specifies the storage destination file name of the client system.
The file name specified by "clientfile" is specified according to the 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 "clientfile" does not exist in the client system, create a new one.
The security and permission of a file or a directory which were created newly become authority of the user who executed this command.
If "clientfile" exists, the data overwrites the file.
If this option is omitted, the incoming data is sent to the standard output. If multiple parameters are specified, the final parameter specified is used.
serverfile
Specify the server receiving source file name or data set name of the server system. Multiple file / data set names cannot be specified.
The file name or data set names 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,a network drive subordinate's file cannot receive. | |
Environment VariablesWhen using this command, specify the following environment variables to configure the settings related to the receiving of the data transfer.
| 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 following explains each of the environment variables.
MFTF_USER
Specifies the user name of the server system.
The user name must be within 127 bytes in ASCII code.
The user name specified here is specified according to the 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 receiving data, within 64 bytes.
If multiple values are specified for this environment variable, the transfer is performed by automatically selecting the device with the least processing time.
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, then the first 64 bytes are treated as valid data and only valid device names within this first 64 bytes are used.
The character device names shown below can be used:
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".
| 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 a transfer using the "Change Separator Function".
If this environment variable is not specified, the target data is saved as binary rather than as records (data lines). The code must be an ASCII code.
The separator can be from 1 to 4 bytes long. 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 environment 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 also effective when the target server system is a UNIX/IA server and the MFTF_CLLINECODE variable is specified.
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 environment 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 on the server system. The file 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 (' ') for UNIX servers or double quotations (" ") for UNIX/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 receiving server system. This variable is only effective when the receiving 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 Value0 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 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.
|
Contents
Index
|