5.2 Data Transfer Status Display Function

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

5.2 Data Transfer Status Display Function

The Data Transfer Status Display Function is used for checking the status of data transfer processes.
This function is provided as the mftfstat command for the UNIX/IA server.

The following discusses the data transfer status display command (mftfstat).

Syntax

UNIX Server

mftfstat

[ target device name | upper directory name of the target device ]
[ -u requestor name ]

IA Server

mftfstat.exe [ target device name ] [ -u requestor name ]

Description

This command displays the status of current data transfer processes.

Option

target device name | upper directory name of the target device : [UNIX]
target device name : [IA]

For the target device, specify the character device name of the XL-DATA/MV data transfer volume for which the transfer status is to be displayed.
If neither the target character device name nor the upper directory of the target character device is specified, a list of character devices of the data transfer volume that can be recognized by the local system and a request reception prompt are displayed.
In this case, the search directory is "/dev/rdsk" for Solaris and HP-UX, and "/dev/raw" for Linux.
However, if using a driver such as MPHD on Solaris, in order to search other than the above mentioned, specify the target directory name for the upper directory name of the target device. When specifying the upper directory of the target device, be sure to add "/" to the beginning and end of the target device name.

Example: /dev/FJSVmphd/

When a character device name is specified, the transfer status of that device is displayed, then the command terminates.
For the character device names here, specify the following:

UNIX Server

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.
/dev/rdsk/c1t2d3s2

For HP-UX

Example:

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

For Linux

Example:

When binding the "/dev/sda" device to "/dev/raw/raw2" with the raw command
/dev/raw/raw2

Devices are displayed in order of character code.
The following is an example:

01:/dev/raw/raw1
02:/dev/raw/raw11
03:/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 0, the 0 must be omitted when specifying the number.
Refer to the following example:

Example:

When the physical disk number is 1 ("DISK01")
PHYSICALDRIVE1

If neither the target device name nor the upper directory name of the target device is specified, a request reception prompt asks for a device number to be selected from a displayed list of devices, then the initialization contents of the target device number is displayed and the command terminates.
To cancel after the device list is displayed, enter "quit" or "q" at the request reception prompt.
More than one the target device numbers cannot be specified at the same time.

-u requestor name

Specify the requestor name (login name on the client system) whose data transfer processes using the target devices are to be displayed.
Only the transfer status of the requestor specified by this option is displayed. However, this is only enabled when the transfer status is transferring.
If this parameter is omitted, all transfer information is displayed.

Return Value

0 is returned when terminating successfully.
-1 is returned for an abnormal termination, and an error message is output to the standard error output.

Display Contents

When the target device name was not specified

# mftfstat
01:/dev/rdsk/c1t1d1s2
02:/dev/rdsk/c1t1d2s2
03:..................
nn:..................

quit or q : exit
>>request No.
2
Information of data transfer volume           DATE : yyyy.mm.dd  hh:mm:ss
  Data transfer volume : /dev/rdsk/c1t1d2s2  (1)

  ** Translation state information **  
  == No.1  Client system : LINUX1 ==  (2) 

     -- Partition No.00 --    (3) 
        Status : Alloc        (4)     

     -- Partition No.01 --    (3)   
        Status : Trans(send)  (4) 
        Translation byte :       10 Mbyte     (5) 
        Application id : 01   (6)  
        Client request time      : yyyy.mm.dd  hh:mm:ss  (7)  
        Server receptionist time : yyyy.mm.dd  hh:mm:ss  (8)  
        Sysid                    :  00000003  (9) 

        Translation information  
          Client system information   
            Client file name : /dir/file/data01  (10)  
            Request userid   : root              (11)  

          Server system information   
            Server system name   : UNIX1     (12)  
            Server system volume : /dev/rdsk/c1t1d2s2          (13)  
            Server file name     : /work/mftf_data/mftf        (14) 
            Server filtercommand : "/usr/mftf/bin/convert -i"  (15)  
            Server userid        : mftfuser  (16)

[Display Contents]

The following explains the display contents.
The displayed items vary depending on the application ((6)) that requested the transfer and the partition status ((4)).
If nothing was transferred within a single client system, "Partition no use" is displayed for items (3) onward.

No.	Display Contents	Partition status
No.	Display Contents	Allocating	Transferring
(1)	Device Name
(2)	Client System name
(3)	Partition Number (00 - 15: decimal)
(4)	Partition Status Alloc: Allocating (preparing or terminating) Trans: Transferring
(4)	Transfer Type on the client system send: Data send request recv: Data receive request
(5)	Data Transfer Size (MB) Displayed in MB (1024 x 1024 bytes).
(6)	Application ID The ID of the application using the data transfer volume. 01: XL-DATA/MV
(7)	Date/Time of Client Transfer Request The date and time when the client requested the transfer.
(8)	Date/time of server transfer acceptance The date and time when the server accepted the transfer request.
(9)	The Transfer ID Assigned the XL-DATA/MV The ID that identifies the transfer request.
(10)	Client File Name The client file name. If the client file name exceeds 150 characters, the first 50 characters and the last 50 characters are displayed with "..." in between. When using standard input (not specifying the -f option) with the mftfsend Command (data send request) on the client, this item displays "stdin". When using standard output (not specifying the -t option) with the mftfrecv Command (data receive request), this item displays "stdout".
(11)	Client user name of transfer request The user name of the client that requested the transfer.
(12)	Server System Name
(13)	Server Device Name
(14)	Server File Name The server file name. If the server file name exceeds 150 characters, the first 50 characters and the last 50 characters are displayed with "..." in between.
(15)	Server Filter Command Name If the server filter command name was not specified for the transfer request, nothing is displayed. If the server filter command name exceeds 150 characters, the first 50 characters and the last 50 characters are displayed with "..." in between.
(16)	Server User Name The server user name specified for the transfer request. If the server user name was not specified for the transfer request, no value is displayed.

:	Displays information.
:	No information is displayed.

When the target device name was specified

# mftfstat /dev/rdsk/c1t1d2s2
Information of data transfer volume           DATE : yyyy.mm.dd  hh:mm:ss
  Data transfer volume : /dev/rdsk/c1t1d2s2

  ** Translation state information **  
  == No.1  Client system : LINUX1 ==  (2) 

     -- Partition No.00 --    (3) 
        Status : Alloc        (4)     

     -- Partition No.01 --    (3)   
        Status : Trans(send)  (4) 
        Translation byte :       10 Mbyte     (5) 
        Application id : 01   (6)  
        Client request time      : yyyy.mm.dd  hh:mm:ss  (7)  
        Server receptionist time : yyyy.mm.dd  hh:mm:ss  (8)  
        Sysid                    :  00000003  (9) 

        Translation information  
          Client system information   
            Client file name : /dir/file/data01  (10)  
            Request userid   : root              (11)  

          Server system information   
            Server system name   : UNIX1     (12)  
            Server system volume : /dev/rdsk/c1t1d2s2          (13)  
            Server file name     : /work/mftf_data/mftf        (14) 
            Server filtercommand : "/usr/mftf/bin/convert -i"  (15)  
            Server userid        : mftfuser  (16)

In the event of one of the following, the partition which was being used at that moment will remain as "in use".
- System down
- An error occurred on the server system and the partition which was being used at that moment were not released
- Forcible stop
The partition will be available in 18 minutes, but it will display "Allocating" or "Transferring" until the next time the partition is used.
Empty partitions are given priority when allocating partitions of a data transfer. Therefore, the partition may continue to remain as "Allocating" or "Transferring".
If necessary, reinitialize the data transfer volume during a time frame when no data transfer is performed.
Data transfer volumes used in the past may appear on the device list (refer to "When changing the data transfer volume to a volume for another purpose").

Contents Index