PRIMEQUEST System Disk Mirror for Windows User's Guide V1.0
Contents PreviousNext

Appendix A Command Reference

A.2 sdxinfo - Disk configuration and status viewing

Command name

sdxinfo - Disk configuration and status viewing

 

Synopsis

sdxinfo [-DG] [-e long]
sdxinfo -P
sdxinfo {-h | /?}

 

Description

The sdxinfo command displays the configuration and status of disks.

To use this command, you must be a user with administrator privileges (a user of the Administrators group).

 

Primary options

The following primary options can be set. By default, mirror disk information and mirror group information are displayed.

-D
Displays mirror disk information.

-G
Displays mirror group information.

-P
Displays physical disk information.

-h
Shows the usage of the command.

/?
Shows the usage of the command.

 

Sub options

-e long
Displays detailed information.

 

Displayed information

Information displayed in response to the sdxinfo command is explained below.

For pieces of information not displayed for some reason, a question mark (?) is displayed.

Mirror disk information

This information is displayed by default or if the -D option is set.

OBJ
Indicated as disk.

 

NAME
Displays the mirror disk names. The mirror disk name is given in the format of Diskn (where n is the mirror disk number).

 

TYPE
Indicated as mirror.

 

GROUP
Displays the mirror group names. The mirror group name is given in the format of Groupn (where n is the mirror group number).

 

DEVNAM
Displays the disk numbers.

 

DEVBLKS
Displays the disk size (the number of blocks in 512-byte units).

 

STATUS
Displays the statuses classified as shown below.

VALID
The data is valid.

Data on VALID disks in the same mirror group is always synchronized.

INVALID
The data is invalid.

Data on the disk in this status may no longer be synchronized with data on VALID disks in the same mirror group.

Disks will be in INVALID status before synchronization copying is initiated or after it is canceled.

COPY
Synchronization copying is in process.

ERROR
An error occurred.

 

Mirror disk detailed information

This information is displayed by default or with the -D option if the -e long option is set.

WB
Indicated as 0.

 

Mirror group information

This information is displayed by default or if the -G option is set.

OBJ
Indicated as group.

 

NAME
Displays the mirror group names. The mirror group name is given in the format of Groupn (where n is the mirror group number).

 

DISKS
Displays the mirror disk names, each separated by a colon (:). The mirror disk name is given in the format of Diskn (where n is the mirror disk number).

 

BLKS
Displays the group size (the number of blocks in 512-byte units).

 

SPARE
Indicated as 0.

 

JRM
Displays the just resynchronization mode setting, which is one of the following values.

on
Resynchronization copying executed when the system is rebooted after it was down copies only the part that was being written when the system was down. However, for the boot partition (usually C:), the entire partition is copied.

off
Resynchronization copying executed when the system is rebooted after it was down copies the entire disk.

 

Mirror group detailed information

This information is displayed by default or with the -G option if the -e long option is set.

TYPE
Indicated as mirror.

 

COPY
Indicated as run. If copying is not in process, an asterisk (*) is displayed.

 

RATE
Displays the synchronization copying progress (%). If copying is not in process, or if just resynchronization copying is in process, an asterisk (*) is displayed.

 

CURBLKS
Displays the number of blocks copied already. If copying is not in process, an asterisk (*) is displayed.

 

COPYBLKS
Displays the number of blocks that are copied. If copying is not in process, an asterisk (*) is displayed.

 

DLY
Displays delay time of the copying process (in milliseconds). If copying is not in process, an asterisk (*) is displayed.

 

Physical disk information

This information is displayed if the -P option is set.

OBJ
Indicated as device.

 

NAME
Displays the disk numbers.

 

BLOCKS
Displays the disk size (the number of blocks in 512-byte units).

 

STATUS
Displays the mirror disk statuses classified as shown below.

VALID
The data is valid.

Data on VALID disks in the same mirror group is always synchronized.

INVALID
The data is invalid.

Data on the disk in this status may no longer be synchronized with data on VALID disks in the same mirror group.

Disks will be in INVALID status before synchronization copying is initiated or after it is canceled.

COPY
Synchronization copying is in process.

ERROR
An error occurred.

*
The disk is not configured as a mirror disk.

 

DKNAME
Displays the mirror disk names. If the disk is not configured as a mirror disk, an asterisk (*) is displayed.

 

LOCATION
Displays the disk location. This information is given in the format of the unit name displayed by the PSA's diskctrl -lu command.

 

Exit codes

0 : Normal end
1 : Abnormal end (indicating that the error is not a temporary error and the command will fail even if it is retried after a while)
2 : Abnormal end (indicating that the error is a temporary error and the command may succeed if it is retried after a while)
3 : Abnormal end (indicating that an option was specified incorrectly)

Execute the following command immediately after this command ends to get the exit code.

> echo %ERRORLEVEL%

 

Examples

  1. View information about mirror disks and mirror groups.

    > sdxinfo
    OBJ  NAME   TYPE   GROUP   DEVNAM DEVBLKS      STATUS
    ---- ------ ------ ------- ------ ------------ -------
    disk Disk0  mirror Group0  0          35291136 VALID
    disk Disk1  mirror Group0  1          35291136 COPY
    
    OBJ   NAME    DISKS                       BLKS         SPARE JRM
    ----- ------- --------------------------- ------------ ----- ---
    group Group0  Disk0:Disk1                     35291136     0 on


  2. View information about mirror disks.

    > sdxinfo -D
    OBJ  NAME   TYPE   GROUP   DEVNAM DEVBLKS      STATUS
    ---- ------ ------ ------- ------ ------------ -------
    disk Disk0  mirror Group0  0          35291136 VALID
    disk Disk1  mirror Group0  1          35291136 COPY


  3. View information about mirror groups.

    > sdxinfo -G
    OBJ   NAME    DISKS                       BLKS         SPARE JRM
    ----- ------- --------------------------- ------------ ----- ---
    group Group0  Disk0:Disk1                     35291136     0 on


  4. View information about physical disks.

    > sdxinfo -P
    OBJ    NAME BLOCKS       STATUS  DKNAME LOCATION
    ------ ---- ------------ ------- ------ ---------------------------------------
    device 0        35291136 VALID   Disk0  IOU#0-HDD#0
    device 1        35291136 *       *      IOU#0-HDD#1


  5. View detailed information about mirror groups.

    > sdxinfo -G -e long
    OBJ   NAME    DISKS                       BLKS         SPARE JRM TYPE   COPY RATE CURBLKS      COPYBLKS     DLY
    ----- ------- --------------------------- ------------ ----- --- ------ ---- ---- ------------ ------------ ----
    group Group0  Disk0:Disk1                     35291136     0 on  mirror run     2       705823     34766848    0



If an error occurs during the sdxinfo command process, error messages may be output in the middle of information display. Disk configurations and states are output to the standard output and error messages are output to the standard error output. Therefore, for convenience, you can specify that error messages are output together at the beginning or at the end or are not output at all using the following methods.

Example 1) Display error messages together at the beginning.

> sdxinfo 1> out1 2> out2 & type out2 & type out1 & del out1 out2
Alternatively, specify as follows.

> sdxinfo > out1 & type out1 & del out1

Example 2) Display error messages together at the end.

> sdxinfo 1> out1 2> out2 & type out1 & type out2 & del out1 out2
Alternatively, specify as follows.
> sdxinfo 2> out2 & type out2 & del out2

Example 3) Skip displaying error messages.

> sdxinfo 2> NUL


For more information on the redirect operator (>), the type command, the del command, and the NUL device, see the Windows Help.



Contents PreviousNext

All Rights Reserved, Copyright(C) FUJITSU LIMITED 2008