Page 1
NEC Storage Manager
Data Replication
Command Reference
Page 2
© NEC Corporation 2001-2003
No part of the contents of this book may be reproduced or
transmitted in any form without permission of NEC Corporation.
The contents of this book may be modified without notice in the future.
Page 3
Preface
This manual explains how to use various types of commands for a data replication function.
The data replication function consists of a replication volume creation function, which is provided in Disk Array
Subsystems (hereinafter may be referred to as disk array), and software, which is responsible for the management and
operation. The data replication function increases operation efficiency using replication volumes.
Refer to the “NEC Storage Manager Manual Guide” (IS901) for the overview of NEC Storage Manager and the related
manuals.
Remarks 1. This manual explains functions implemented by the following program products:
• NEC Storage Manager and NEC Storage BaseProduct
• NEC Storage ReplicationControl
• NEC Storage ReplicationControl SQL Option
• NEC Storage DynamicDataReplicati on
• NEC Storage RemoteDataReplication
2. This manual is applicable to the program products of the following versions:
• NEC St orage Manager Ver2.1
• NEC Storage BaseProduct Ver2.1
• NEC Storage ReplicationControl Ver2.1
• NEC Storage ReplicationControl SQL Option Ver2.1
3. The term “iSM” in this text refers to all the NEC Storage Manager program products.
4. The term “Microsoft SQL Server 2000” in this text refers to either Microsoft SQL Server 2000 Enterprise
Edition or the Microsoft SQL Server 2000 Standard Edition.
5. The term “data replication functions” differs from the “replication functions” provided by Microsoft SQL
Server 2000.
6. The term “MSCS” in this text refers to the Microsoft Cluster Server.
7. Trademarks and registered trademarks
• Microsoft®, Windows®, and Windows NT® are registered trademarks or trademarks of Microsoft
Corporation in the United States and other countries.
• HP-UX is a registered trademark of Hewlett-Packard, Co. in the United States.
• UNIX is a registered trademark of The Open Group in the United States and other countries.
• VERITAS, VxVM, VxFS, NetBackup, VERITAS Volume Manager, VERITAS File System, and
VERITAS NetBackup are registered trademarks or trademarks of VERITAS Software Corporation in the
United States and other countries.
• Legato NetWorker is a registered trad emark of Legato Systems, Inc. in the United States.
• Sun is a registered trademark of Sun Microsystems, Inc. in th e United States and other countries.
Page 4
• So laris is a registered trademark of Sun Microsystems, Inc. in the United States.
• Linux is a trademark or registered trademark of Mr. Linus Torval ds in the United States and other
countries.
• AIX is a t rademark of IBM Corporation.
Other product names and company na mes, etc. are registered trademarks or trademarks of the associated
companies.
The First Edition in March 2003
Page 5
Contents
Chapter 1 Overview............................................................................................................................................................1
1.1 Command List............................................................................................................................................................. 1
1.2 Volume Types............................................................................................................................................................. 3
1.3 Replication Operation File.......................................................................................................................................... 4
1.4 Database Operation File.............................................................................................................................................. 7
Chapter 2 Command Reference....................................................................................................................................... 11
2.1 Volume List Creation/Display ..................................................................................................................................11
2.1.1 iSMvollist (Windows)....................................................................................................................................... 11
2.1.2 iSMvollist (UNIX)............................................................................................................................................15
2.2 Replication Operations.............................................................................................................................................. 18
2.2.1 iSMrc_replicate................................................................................................................................................. 18
2.2.2 iSMrc_separate.................................................................................................................................................. 28
2.2.3 iSMrc_restore.................................................................................................................................................... 38
2.2.4 iSMrc_change ...................................................................................................................................................52
2.2.5 iSMrc_wait ........................................................................................................................................................ 59
2.2.6 iSMrc_query...................................................................................................................................................... 69
2.2.7 iSMrc_sense...................................................................................................................................................... 77
2.3 Disk Operations ........................................................................................................................................................ 80
2.3.1 iSMrc_flush....................................................................................................................................................... 80
2.3.2 iSMrc_mount .................................................................................................................................................... 83
2.3.3 iSMrc_umount .................................................................................................................................................. 85
2.3.4 iSMrc_signature................................................................................................................................................ 88
2.3.5 iSMrc_scan........................................................................................................................................................ 91
2.4 Pair Operations ......................................................................................................................................................... 92
2.4.1 iSMrc_ldlist....................................................................................................................................................... 92
2.4.2 iSMrc_pair ........................................................................................................................................................ 98
2.5 Operations Linked with Database........................................................................................................................... 102
2.5.1 iSMsql_snapshotbkup..................................................................................................................................... 102
2.5.2 iSMsql_snapshotrst......................................................................................................................................... 109
Chapter 3 Operation Settings......................................................................................................................................... 117
3.1 Replication Operation Option Setting File ............................................................................................................. 117
3.2 Environment Variables ........................................................................................................................................... 123
Index ......................................................................................................................................................................... 127
i
Page 6
Chapter 1 Overview
1
.
1
C
o
m
m
a
n
1
.
1
C
o
m
1
.
1
C
The following is a list of data replication related commands described in this document. The description of
“UNIX” that appears in this document indicates all the UNIX systems, such as HP−UX version, Solaris
version, etc., which the NEC Storage ReplicationControl supports.
o
m
m
m
d
a
n
d
a
n
d
Table 1−1 Command List
Chapter 1 Overview
L
i
s
t
L
L
i
s
t
i
s
t
No. Command name Operation Description
Displays logical disk (disk array
1 iSMvollist
2 iSMrc_replicate Replication
3 iSMrc_separate Separation
4 iSMrc_restore Restoration
5 iSMrc_change
6 iSMrc_wait Waiting for state
7 iSMrc_query
8 iSMrc_sense Volume list display Displays volume information.
9 iSMrc_ldlist
10 iSMrc_pair Pairing/unpairing
Volume list
creation/display
Copy Control State
Change
Paired volume state
display
Logical disk
information display
side) information and associat ed
system−de pe nde nt information
(server side).
Starts copy (Replicate) from MV
to RV.
Separates MV from RV in the
copy state (Replicate or Restore).
Starts copy (Restore) from RV to
MV.
Change Copy Control State for
reflecting updates in MV to RV.
Waits for Sync State (rpl/sync),
Sync State (rst/sync), and
Separated State.
Displays the state of the p ai r ed
volume.
Obtains and displays logical disk
list information.
Sets and cancels the paired
volume.
Target s ystem
Windows UNIX
11 iSMrc_flush
12 iSMrc_mount Volume mount
13 iSMrc_umount Volume unmount
File system buffer
flush
Flushes the file system cache
buffer.
Mounts the volume (file system).
Unmounts the volume (file
system).
1
−
−
−
Page 7
Chapter 1 Overview
14 iSMrc_signature
15 iSMrc_scan Disk scanning
16 iSMsql_snapshotbkup Snapshot Backup
17 iSMsql_snapshotrst Snapshot Restore
: Target −: Non-target
Notes:
(1) Commands from No.1 to No.15 can be used after the NEC Storage ReplicationControl has been
installed.
(2) Commands from No.16 to No.17 can be used after the NEC Storage ReplicationControl SQL Option has
been installed.
(3) On the Windows system, those commands can be operated only by a user who belongs to the
Administrators group.
(4) On the UNIX system, operation authority belongs to a super user immediately after the installation.
The volume list can be created only by the super user; other operations, however, can be performed by
anybody by changing the authority for the command and directory operations.
(5) To operate together with the replication management (controlling the issuance of I/O to disk arrays via
the NEC Storage Manager), joint operation is possible with regard to commands from No.2 to No.10.
Command No.1 and those from No.11 to No.17 are not targeted for th e joint operation because those
commands directly operate the system’s volumes.
Disk signature
operation
Performs an operation on each
disk signature.
Scans for available disks.
Creates backups of the Microsoft
SQL Server 2000 database.
Restores the Microsoft SQL
Server 2000 database from the
backup.
−
−
−
−
2
Page 8
Chapter 1 Overview
1
.
2
V
o
l
u
m
e
T
y
p
e
s
1
.
2
V
o
l
u
m
e
T
y
1
.
2
V
o
l
u
m
e
Types of volumes that are speci fied as operation targets by data replication commands are as foll ows:
p
T
y
p
Table 1-2 Volume Types
e
e
s
s
Type Description Identifier
Logical disk name
Mount point volume
name
NTFS folder name
Drive letter Specifies the drive letter set for the volume.
Special file name
Volume group name
Disk group name
Notes:
(1) The identifier is a character string that indicates t he volume type and is used in the follo win g cases:
When specifying a volume type by a replication operation command argument (-mvflg, -rvflg, or
When specifying a volume type by the pair specification (MV type or RV type) in the replication
(2) To use the volume group, the LVM environment is necessary.
(3) To use the disk group, th e V xVM environment is necessary.
(4) On the UNIX system Solaris version, to specify a special file name (/dev/rdsk/c#t#d#s#), remove the
special file name’s slice (partition) number (s#).
(5) The pair setting and canceling operation (iSMrc_pair command) is performed on a single logical disk;
therefore, it is not possible to specify a LVM volume group or a VxVM disk group.
(6) To operate together with the replication management (controlling the issuance of I/O to disk arrays via
the NEC Storage Manager), an applicable volume type is a logical disk name only.
Specifies the logical disk name set on the disk
array side.
Specifies the mount point volume name
assigned by the system to the volume.
Specifies the NTFS folder name (path name)
set for the volume.
Specifies the special file n ame assigned by the
system to the disk (logical disk).
Specifies the name of the LV M’s volume
group that includes the disk (logical disk).
Specifies the name of the VxVM’s disk group
that includes the disk (logical disk).
-volflg)
operation file
Target s ystem
Windows UNIX
ld
mvol
mdir
drv
sfn -
vg -
dg -
-
-
-
3
Page 9
Chapter 1 Overview
1
.
3
1
.
3
1
.
3
To perform batch setting of paired volumes by a data replication command with the -file option, use the
replication operation file .
The replication operation file is described below.
[ FILE LOCATION AND NAME ]
[ DESCRIPTION ]
[ SYNOPSIS ]
R
R
R
Can be freely specified.
The replication operation file is used to perform batch setting of multiple pairs by using a data
replication command.
This file is described in the following synopsis:
e
e
e
p
p
p
l
i
c
a
t
i
o
n
O
p
e
r
a
t
i
o
n
F
i
l
e
l
i
c
a
t
i
o
n
O
p
e
r
a
t
i
o
n
F
l
i
c
a
t
i
o
n
O
p
e
r
a
t
i
o
n
i
F
i
l
e
l
e
MV_Type:MV RV_Type:RV
To describe the MV and RV, use a col on (:) to connect the volume type (MV_Type or RV_Type) with
the volume (MV or RV).
Specifying volume types (MV_Type, RV_Type)
The following values can b e specified as a volume type by using either a numerical value o r a
character string.
Table 1-3 Volume Types
Target volume
Logical disk name 0 ld
Special file name 1 sfn
Volume group name
Drive letter
Volume Types Target s ystem
By number By characters Windows UNIX
-
2 vg
4 drv
-
-
Disk group name
Mount point volume name
NTFS folder name
5 dg
6 mvol
7 mdir
4
-
-
-
Page 10
Chapter 1 Overview
5
Page 11
Chapter 1 Overview
Specifying a volume (MV, RV)
Specify the name of the target volume that has an attri bute specified as a volume type.
The maximum number of characters is as fol lows:
Table 1-4 Sp ecifying a Volume
Target volume
Logical disk name
Special file name
Volume group name
Drive letter
Disk group name
Mount point volume name 52 single-byte characters
NTFS folder name 260 single-byte characters
Maximum number of
characters
32 single-byte characters
Rules
Start description from the first column of the line.
A line break shall be a partition of records.
Up to 1,024 single-byte characters can be described per record.
One pair can be described per record.
When there are one MV and one RV, description of the RV can be omitted.
Normally, when there are one MV and multiple RVs, description of the RVs cannot be omitted. It
can be omitted only when the iSMrc_query command or the iSMrc_wait command is used.
Use a blank space or a tab character to separate the descri ption of the MV from the description of the
RV.
Text displayed from the sharp (#) character to the end of the record is recognized as a comment.
If there is an error in the file syntax, operations to all pairs described in the file become invalid.
When using the iSMrc_sense command, specify the volume type and th e volume name for
MV_Type and MV, respectively. Descriptions of RV_Type and RV are ignored.
When describing a pair that combines a volume group or a disk group with a special file name (or
logical disk name), multiple volumes can be specified by describing multiple special file names (or
logical disk names) separated by a comma (,).
When specifying a pair that combines a volume group or a disk group with a special file name (or
logical disk name), the number of logical volumes that consist of the volume group or the disk group
must coincide with the number of special file names to be described.
If a character string, such as a NTFS folder name, includes a blank space (∆) or colon (:), enclose the
entire character string in doub le quotation marks (“).
6
Page 12
The following is an example of a description of the replication operation file:
An example for the Windows system
#Type:MV Type:RV
ld:dev000 ld:dev001
drv:E drv:F
ld:dev006 drv:G
drv:H ld:dev007
# Parallel configuration
ld:dev002 ld:dev003
ld:dev002 ld:dev004
# MV:RV=1:1
ld:dev005
An example for the UNIX system
Chapter 1 Overview
#Type:MV Type:RV
sfn:/dev/rdsk/c16t1d0 sfn:/dev/rdsk/c16t1d1
sfn:/dev/rdsk/c16t1d2 sfn:/dev/rdsk/c16t1d3
vg:/dev/vgvol ld: /dev/rdsk/c16t1d4,/dev/rdsk/c16t1d5
dg:dg_name
ld:dev001 ld:dev002
ld:dev003 sfn:/dev/rdsk/c23t2d0
# Parallel configuration
sfn:/dev/rdsk/c16t2d0 sfn:/dev/rdsk/c16t2d1
sfn:/dev/rdsk/c16t2d0 sfn:/dev/rdsk/c16t2d2
# MV:RV=1:1
sfn:/dev/rdsk/c22t3d0
7
Page 13
Chapter 1 Overview
1
.
4
1
.
4
1
.
4
To perform batch setting of databases by a NEC Storage ReplicationControl SQL Option command with the
-dbfile option, use the database operation file.
The database operation file is described below.
[ FILE LOCATION AND NAME ]
[ DESCRIPTION ]
[ SYNOPSYS ]
D
D
D
Can be freely specified.
The database operation file is used to perform batch setting of multiple databases by using a NEC
Storage ReplicationControl SQL Option command.
This file is described in the following synopsis:
a
a
a
t
a
b
a
s
e
O
p
e
r
a
t
i
o
n
F
i
l
e
t
a
b
a
s
e
O
p
e
r
a
t
i
o
n
t
a
b
a
s
e
O
p
e
r
a
t
i
o
n
F
F
i
l
e
i
l
e
db:db_name [ Option_Type:[value] ] [...]
For description, use a colon (:) to connect “db” with a database name (db_name) and to connect an
option type (Option_Type) with the preset value (value).
Description of each option can be omitted or can be in arbitrary order.
Specifying a database name (db_name)
Specify a name of the database which is a Snapshot Backup or Snapshot Restore target.
If the database name includes any of the following eleven characters, an error occurs.
\ / : , ; * ? ” < > |
8
Page 14
Chapter 1 Overview
Specifying an option type (Option_Type) and a preset value (value)
The following character strings can be specified as an option type.
Table 1-5 Specifying an Option Type and Pr eset Value
Option type Description
uid Specify a user ID for connecting to the Microsoft SQL Server 2000.
pass
input Specifies for entering a user ID and a password from the input screen.
server
remod
refile
move
Specifies a password for the user ID for connecting to the Microsoft SQL
Server 2000.
Specify a computer name and an instance name for connectin g to a named
instance.
Specify the mode during the database recovery.
Description of this option is effective only during Snapshot Restore execution,
and ignored during Snapshot Backup execution.
Specifies the standby database file.
Description of this option is effective only during Snapshot Restore execution,
and ignored during Snapshot Backup execution.
When executing Restore by using a physical file that has a different path from
the backed up physical file, specify the data file path name and the log file path
name.
Description of this option is effective only during Snapshot Restore execution,
and ignored during Snapshot Backup execution.
Specify the following preset values for each option type:
uid:user_Id Specify a user ID for connecting to the Microso ft SQL Server 2 000.
Specify the pass option together with this option.
If this option is omitted, the system uses a user name and a
password for the Windows login account.
This option and the input option cannot be sim ultane ous ly
specified.
pass:[password] Specify a password for connecting to the Microsoft S QL Server
2000. If the password is omitted, the system recognizes that
there is no password. Specify the uid option together with this
option.
This option and the input option cannot be sim ultane ous ly
specified.
input: Enters a user ID and a password from the input screen when
connecting to the Microsoft SQL Server 2000. This option does
9
Page 15
Chapter 1 Overview
server:instance_name Specify a compu t er name and an instance name in th e fol lowing
remod:{recovery | norecovery | standby}
refile:restore_file Specify a standby database file.
move:os_file_name[,...] When executing Snapshot Restore by the -norestore option
not have a preset value.
This option and the uid and pass options cannot be
simultaneously specified.
format when connecting to a named instance.
computer_name\instance_name
If this option is omitted, a connection is made to the predetermined
instance.
The computer name must be either a local computer name, or a
virtual computer name in the MSCS (Microsoft Cluster Server)
environment.
Specify the mode during the database recovery.
recovery Executes a command and simultaneously
recovers the database.
norecovery Recovers the target dat abase in the state so that
the transaction log is applicable.
standby Recovers the database as a standby database. A
standby database file is specified by the refile
option.
If this option is omitted, the operation is the same as the operation
when recovery is specified.
This option can be specified only when standby is specified by
the remod option. If recovery or norecovery is specified,
or if the remod option is omitted, an error occurs.
and when executing Restore by using a physical file that has a
different path from the backed up physical file, specify the
database’s data file path name and log file path name. As a file
name specified by os_file_name, specify the database’s data
file and log file in the full path by separating them by a comma.
10
Page 16
Chapter 1 Overview
Rules
Start description from the first column of the line.
A line break shall be a partition of records.
Up to 1,024 single-byte characters can be described per record.
Information of one database can be described per record.
The same option type cannot be specified twice per record.
Description of the database name cannot be omitted.
The operation target database must be unique.
Use a blank space o r a tab character to separate the descri ptions of the database name or the option
type.
Text displayed from the sharp (#) character to the end of the record is recognized as a comment.
If there is an error in the file syntax, operations to all databases described in the file become invalid.
If a character string includes a blank space (∆), enclose th e entire character string in double
quotation marks (“).
The following is an example of a description of the database operation file:
# db:db_name
db:db01
# db:db_name uid:user_id pass:password
# db:db_name uid:user_id pass:password server:instance_name
db:db01 uid:guest pass:guestpass
db:db02 uid:administrator pass:adminpass server:localmachine\user_inst
# db:db_name input:
db:db01 input:
# db:db_name remod:restore_mode
# db:db_name remod:restore_mode refile:restore_file
db:db01 remod:norecovery
db:db03 remod:standby
"refile:d:\db_folder\db03_standby.mdf"
# db:db_name move:os_file_name[,...n]
db:db01 move:”f:\db folder\db01_Data2.mdf,g:\db_folder\db01_Log2.ldf”
11
Page 17
Chapter 2 Command Reference
12
Chapter 2 Command Reference
2
2
2
.
.
.
1
1
1
V
V
V
o
o
o
l
l
l
u
u
u
m
m
m
e
e
e
L
L
L
i
i
i
s
s
s
t
t
t
C
C
C
r
r
r
e
e
e
a
a
a
t
t
t
i
i
i
o
o
o
n
n
n
/
/
/
D
D
D
i
i
i
s
s
s
p
p
p
l
l
l
a
a
a
y
y
y
2
2
2
.
.
.
1
1
1
.
.
.
1
1
1
i
i
i
S
S
S
M
M
M
v
v
v
o
o
o
l
l
l
l
l
l
i
i
i
s
s
s
t
t
t
(
(
(
W
W
W
i
i
i
n
n
n
d
d
d
o
o
o
w
w
w
s
s
s
)
)
)
[ NAME ]
iSMvollist - Creates and displays the table of logical disks and related information.
[ SYNOPSIS ]
iSMvollist -cr
iSMvollist -a
iSMvollist -al ld_number
iSMvollist -ae ld_name
iSMvollist -ad [drive | path]
iSMvollist -ap disk_number
iSMvollist -ah HBT [LUN]
iSMvollist -av volume_name
iSMvollist -d
iSMvollist -dl disk_array [ld_number]
iSMvollist -de disk_array [ld_name]
iSMvollist -dd disk_array [drive | path]
iSMvollist -dp disk_array [disk_number]
iSMvollist -dh disk_array [HBT [LUN]]
iSMvollist -?
[ DESCRIPTION ]
The iSMvollist command creates and displays the table of logical disks and related information.
The options which start with “a” display the relations of ld_number/ld_name/VAA/OS
Type/drive/path HBT/LUN/disk_number/disk_array for all the disk arrays in the Volume List.
The options which start with “d” display the relations of ld_number/drive/path
HBT/LUN/disk_number/ld_name/OS Type for the specified disk arrays.
The Volume List can be created an d displayed only with the devices reco gnized by the system.
The volume list is necessary when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
Page 18
Chapter 2 Command Reference
13
OPTIONS
The iSMvollist command recognizes the following options and arguments.
-cr Scans the devices conn ected to the host, and creates or
updates the volume information of the target devices.
When disk arrays are added or deleted, and when logical
disks are bound or unbound, you must perform this
command to re-create the Volume List.
-a Displays the relations for all the disk arrays in the
Volume List.
-al ld_number Displays the relations only for the logical disks specified
by ld_number.
-ae ld_name Displays the relations only for the logical disks specified
by ld_name.
-ad [drive | path] Displays the relations only for the drive names specified
by drive or path.
-ap disk_number Displays the relations only for the physical disk names
specified by disk_number.
-ah HBT [LUN] Displays the relations only for the host numbers, bus
numbers, and target IDs specified by HBT. If LUN is
specified, it displays the relations only for the specified
HBT and LUN.
-av volume_name Displays the relations only for the mount point volume
name specified in volume_name.
-d Displays the list of the disk arrays in the Volume List as
well as the number of logical drives in each disk array.
-dl disk_array [ld_number] Displays the relations for the d isk arrays specified by
disk_array, sorted by the logical disk number as the
key.
If ld_number is specified, it displays the relations only
for the specified logical disk.
Page 19
Chapter 2 Command Reference
14
-de disk_array [ld_name] Displays the relations for the disk arrays speci fied
by disk_array, sorted by the logical disk name
as the key.
If ld_name is specified, it displays the relations
only for the specified logical disk name.
-dd disk_array [drive | path] Displays the relations for the disk arrays speci fied
by disk_array, sorted by the drive letters or
path name as the key.
If drive or path is specified, it displays the
relations only for the specified logical drive.
-dp disk_array [disk_number] Displays the relations for the disk arrays specified
by disk_array, sorted by the physical disk
number as the key.
If disk_number is specified, it displays the
relations only for the specified physical disk.
-dh disk_array [HBT [LUN]] Displays the relations for the disk arrays specified
by disk_array, sorted by HBT and LUN as the
keys.
If HBT is specified, it displays the relations only for
the specified HBTs.
Furthermore, if LUN is specified, it displays the
relations only for the specified HBT and LUN.
-? Displays the usage of this command.
[ DISPLAYED INFORMATION ]
C:\>iSMvollist -a
LDN LD Name VAA OS Type
HBT LUN Disk No. Disk Array
Volume Name
Path
ldn ld-name VAA type
hbt lun disk-no disk_array
volume-name
path
C:\>
Page 20
Chapter 2 Command Reference
15
Description of messages:
LDN Logical disk number
LD Name Logical disk name
VAA V olume Absolute Address
OS Type Type of operating system
HBT Host adapter number, bus number, target ID
LUN LUN (Logical unit number)
Disk No. Physical disk number
Disk Array Disk array name
Volume Name Mount point volume name
Path Drive letters or path name of the NTFS folder
[ USAGE ]
The command creates the Vo lume List.
C:\>iSMvollist -cr
iSMvollist: Info: iSM11700: Please wait a minute.
iSMvollist: Info: iSM11701: Volume list is created successfully.
C:\>
The command displays the Volume List with the logical disk name specified.
C:\>iSMvollist -ae dev001
LDN LD Name VAA OS Type
HBT LUN Disk No. Disk Array
Volume Name
Path
030ch dev001 3000000000000002030c WN
h4b0t35 000h disk2 NECStorage4100/1007
\\?\Volume{674de734-ee66-11d5-95d8-00004c792133}\
H:
C:\>
[ NOTES ]
• While updating or creating a Volume List, you cannot create, update, or display the Volume
List or execute replicatio n operation commands.
[ RETURN VALUE ]
0: Normal termination
1: Abnormal termination
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• The in struction fails due to a disk array error.
Page 21
Chapter 2 Command Reference
16
2
2
2
.
.
.
1
1
1
.
.
.
2
2
2
i
i
i
S
S
S
M
M
M
v
v
v
o
o
o
l
l
l
l
l
l
i
i
i
s
s
s
t
t
t
(
(
(
U
U
U
N
N
N
I
I
I
X
X
X
)
)
)
[ NAME ]
iSMvollist - Creates and displays the list of logical disks and related information.
[ SYNOPSIS ]
iSMvollist -d
iSMvollist -vs Disk Array Name [Special File]
iSMvollist -vl Disk Array Name [LDN]
iSMvollist -ve Disk Array Name [LD Name]
iSMvollist -l [Special File | LD Name]
iSMvollist -r
iSMvollist -help
[ DESCRIPTION ]
The iSMvollist command creates and displays the list of logical disks and related information.
The Volume List can be created an d displayed only with the devices reco gnized by the system.
The volume list is necessary when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
•••• OPTIONS
The iSMvollist command reco gnizes the following op tions and arguments.
-d Lists the disk arrays stored in the volume list and displays the number
of logical disks located in each disk array.
-vs Disk Array Name [Special File]
Displays the relations for the disk arrays speci fied by Disk Array
Name, sorted by the special file as th e key.
If Special File is specified, the relation only for the specified
special file is displayed.
-vl Disk Array Name [LDN]
Displays the relations for the disk arrays speci fied by Disk Array
Name, sorted by the logical disk nu mber as the key.
If LDN is specified, the relation onl y for the specified logical disk
number is displayed.
Page 22
Chapter 2 Command Reference
17
-ve Disk Array Name [LD Name]
Displays the relations for the disk arrays speci fied by Disk Array
Name, sorted by the logical disk name as t he key.
If LD Name is specified , the relation only for the specified logical disk
name is displayed.
-l [Special File | LD Name]
Displays the relations for the logical disk, VAA, and special file.
If Special File or LD Name is specified, the relation only for the
specified special file or logical disk name is displayed.
-r Creates the list of the logical disks, VAAs, and special files.
When a disk array has been added or deleted, or a logical disk has
been bound or unbound, be sure to execute this command to re-create
the volume list.
On the UNIX system HP-UX version, the syste m checks the disk
array currently being connected and creates a character special file for
the SCSI access.
-help Displays the usage of this command (UNIX).
[ DISPLAYED INFORMATION ]
Volume list information is displayed.
# iSMvollist -l special_file_name
LDN LD NAME VAA TYPE
Special File Disk Array Path
ldn ld name VAA type
special_file_name disk_array path
#
Description of messages
LDN Logical disk number
LD NAME Logical disk name
VAA Volume Absolute Address
TYPE OS type
Special File Special file name
Disk Array Disk array name
Path Availability of special file
Available: No display
Page 23
Chapter 2 Command Reference
18
Unavailable: ‘B’ is displayed
[ USAGE ]
(1) This command creates the volu me list.
# iSMvollist -r
iSMvollist: Info: iSM11700: Please wait a minute.
iSMvollist: Info: iSM11100:Command has completed successfully.
#
(2) This command displays volume list information by specifying the special file.
# iSMvollist -l /dev/rdsk/c1t2d0
LDN LD NAME VAA TYPE
Special File Disk Array Path
0001h disk001 30000000000000020000 NX
/dev/rdsk/c1t2d0 NECStorage4100/07
#
[ NOTES ]
• While the volume list is being created or updated, it is not possible to create, update or display
the volume list or to conduct operations by replication operation commands.
• On the UNIX system HP-UX version, while the iSM Server is running on the same server, the
volume list can be displayed, but cannot be created or updated.
[ RETURN VALUE ]
0: Normal termination
1: Abnormal termination
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• The instruction fails due to a disk array error.
Page 24
Chapter 2 Command Reference
19
2
2
2
.
.
.
2
2
2
R
R
R
e
e
e
p
p
p
l
l
l
i
i
i
c
c
c
a
a
a
t
t
t
i
i
i
o
o
o
n
n
n
O
O
O
p
p
p
e
e
e
r
r
r
a
a
a
t
t
t
i
i
i
o
o
o
n
n
n
s
s
s
2
2
2
.
.
.
2
2
2
.
.
.
1
1
1
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
r
r
r
e
e
e
p
p
p
l
l
l
i
i
i
c
c
c
a
a
a
t
t
t
e
e
e
[ NAME ]
iSMrc_replicate - Starts copy from MV to RV.
[ SYNOPSIS ]
iSMrc_replicate -mv volume -mvflg mv_flg
[-rv volume -rvflg rv_flg]
[-cprange copy_range] [-cpmode copy_mode]
[-rvacc rv_access] [-wait [second] | -nowait]
iSMrc_replicate -file file_name
[-cprange copy_range] [-cpmode copy_mode]
[-rvacc rv_access] [-wait [second] | -nowait]
iSMrc_replicate -?
iSMrc_replicate -help
[ DESCRIPTION ]
The iSMrc_replicate command copies data from the paired MV to RV.
OPTIONS
The iSMrc_replicate command recognizes the following options and argument s.
-mv volume Specify volume of MV.
For information about the volume and volume types, refer to 1.2
“Volume Types”.
-mvflg mv_flg Specify the volume type specified in -mv.
This argument must be specified together with -mv.
For information about the volume and volume types, refer to 1.2
“Volume Types”.
-rv volume Specify volume of RV.
For information about the volume and volume types, refer to 1.2
“Volume Types”.
Page 25
Chapter 2 Command Reference
20
-rvflg rv_flg Specify the volume type specified in -rv.
This argument must be specified if -rv is specified.
For information about the volume and volume types, refer to 1.2 “Volume
Types”.
-cprange copy_range Specify the range of copy from MV to RV .
In copy_range, one of the following can be sp ecified.
diff Replicates only updates to MV since Separate from MV to
RV.
full Replicates all area of MV to RV.
If this argument is omitted, the operation is the same as the operation when
diff is specifie d.
-cpmode copy_mode Specify how to reflect the MV update to RV.
In copy_mode, one of the following can be specified .
sync Sync mode
semi Semi-sync mode
bg Background copy mode
If this argument is omitted, the operation is the same as the operation when
sync is specified.
-rvacc rv_access Specify the access restriction s for RV.
In rv_access, one of the following can be specified .
ro Only read is allowed for RV.
nr Access to RV is not allowed.
If this argument is omitted, the operation is the same as the operation when
nr is specified.
-wait [second] | -nowait
Specify whether to wait for completion of replication.
If -wait is specified, it waits until difference reflection of MV/RV is
complete.
It also monitors process state in a certain time interval.
The monitoring time interval is 5 seconds. If a value is specified in
second, the monitoring time interval of the disk array becomes the
specified value. The unit is second, and the available range is from 1
through 30 seconds. The available values are 1 to 30 seconds (integer).
This value can be changed in the replication operation option setting file on
the Windows system and in the environment variable on the UNIX system.
For details, refer to Chapter 3 “Operation Settings”. If this argument is
omitted, the operation is the same as the operation when -nowait is
specified.
Page 26
Chapter 2 Command Reference
21
-file file_name To specify multiple pairs, describe the pairs of MV/RV in file_name.
The copy operation instruction is specified in the argument. If multiple
pairs are specified, a copy request is i ssued to the pairs simultaneously, and
the operation instruction is reflected to all the pairs.
For the description format of file_name, refer to 1.3 “Replication
Operation File”.
When multiple pairs are specified, if an error occurs in some pairs, the
process is continued until it is terminated in all the specified pairs.
-? Displays the usage of this command (Windows).
-help Displays the usage of this command (UNIX).
[ DISPLAYED INFORMATION ]
On the Windows system
(1) Information when the command terminates normally with -wait specification is displayed.
(Individual specification)
C:\>iSMrc_replicate -mv ld-name -mvflg ld -rv ld-name -rvflg ld -wait 2
Replicate Start YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
Replicating.....
Replicate Normal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
• Replicate Start YYYY/MM/DD hh:mm:ss
Replicate starting message and Start Time
• MV:disk_number ld_name type
volume name
path
Page 27
Chapter 2 Command Reference
22
• RV:disk_number ld_name type
volume name
path
MV/RV physical disk number, logical disk name, OS type, mount point volume
name, and drive letters or path name mounted to the folder of the NTFS volume
accessed by users
• Replicating.....
Message in Replicate execution
The display of this message can be suppressed by setting an option. For details
on the option setting, refer to 3.1 “Replication Operation Option Setting File”.
• Replicate Normal End YYYY/MM/DD hh:mm:ss
Replicate end message and end time
(2) When -wait has been specified, the copy difference remains unchanged for the period of
time (30 seconds) set in RPL_ENDWATCHDEV of the replication operation option setting
file, and the operation terminated abnormally, the following information is displayed:
(Individual specification)
C:\>iSMrc_replicate -mv ld_name -mvflg ld -rv ld_name -rvflg ld -wait 2
Replicate Start YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
iSMrc_replicate: Error: iSM13663: The processing of waiting has terminated because
"separate diff" or "copy diff" does not decrease in the specified time. (30 sec)
Replicate Abnormal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
The following is displayed as an error message.
iSMrc_replicate: Error: iSM13663: The processing of waiting has
terminated because "separate diff" or "copy diff" does not decrease
in the specified time. (30 sec)
Page 28
Chapter 2 Command Reference
23
On the UNIX system
(1) When the command terminates normally with the -wait specification, the followi ng
information is displayed.
(Individual specification)
# iSMrc_replicate -mv special_file_name -mvflg sfn -rv
special_file_name -rvflg sfn -wait 2
Replicate Start YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
Replicating.....
Replicate Normal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
• Replicate Start YYYY/MM/DD hh:mm:ss
Replicate start message and start t ime
• MV:special_file_name LD Name type
RV:special_file_name LD Name type
MV/RV’s special file name, logical disk name, OS type
• Replicating.....
Message that appears during Replicate execution
The display of this message can be suppressed by setting an option. For details
of the option setting, refer to 3.2 “Environment Variables”.
• Replicate Normal End YYYY/MM/DD hh:mm:ss
Replicate end message and end time
(2) When -wait has been specified, and the copy difference remains unchanged for the period
of time (30 seconds) set in RPL_ENDW ATCHDEV of the environment variable, and the
operation terminated abnormally, the following information is displayed.
(Individual specification)
# iSMrc_replicate -mv special_file_name -mvflg sfn -rv
special_file_name -rvflg sfn -wait 2
Replicate Start YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
Replicating.....
Page 29
Chapter 2 Command Reference
24
iSMrc_replicate: Error : iSM13663 : The processing of waiting has
terminated because "separate diff" or "copy diff" does not decrease
in the specified time. (30 sec)
Replicate Abnormal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
The following is displayed as an error message.
iSMrc_replicate: Error : iSM13663 : The processing of waiting has
terminated because "separate diff" or "copy diff" does not decrease
in the specified time. (30 sec)
[ USAGE ]
On the Windows system
(1) The command is executed with the monitoring time interval of 2 seconds with -wait
specification.
(Individual specification)
C:\>iSMrc_replicate -mv dev001 -mvflg ld -rv dev002 -rvflg ld -wait 2
Replicate Start 2001/01/28 17:33:17
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:2 dev002 WN
-
-
Replicating.....
Replicate Normal End 2001/01/28 17:33:19
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:2 dev002 WN
-
-
C:\>
Page 30
Chapter 2 Command Reference
25
(2) The command is executed with the monitoring time interval set to 2 seconds with -wait
specification.
(Batch specification)
C:\>iSMrc_replicate -file volume_file -wait 2
Replicate Start 2001/01/28 17:33:17
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
Replicate Start 2001/01/28 17:33:17
MV:3 dev002 WN
\\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\
F:
RV:4 dev102 WN
-
Replicate Start 2001/01/28 17:33:17
MV:5 dev003 WN
\\?\Volume{71facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:6 dev103 WN
-
-
Replicating.....
Replicate Normal End 2001/01/28 17:37:20
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
Replicate Normal End 2001/01/28 17:38:15
MV:3 dev002 WN
\\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\
F:
RV:4 dev102 WN
-
Replicate Normal End 2001/01/28 17:38:17
MV:5 dev003 WN
\\?\Volume{71facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:6 dev103 WN
-
-
C:\>
• The end messages are displayed in t he order Replicate commands terminate.
Page 31
Chapter 2 Command Reference
26
On the UNIX system
(1) The command is executed with the monitoring time interval of two seconds by the -wait
specification.
(Individual specification)
# iSMrc_replicate -mv /dev/rdsk/c0t1d0 -mvflg sfn -rv
/dev/rdsk/c0t2d0 -rvflg sfn -wait 2
Replicate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Replicating.....
Replicate Normal End 2000/10/10 09:15:32
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
#
(Batch specification)
# iSMrc_replicate -file volume_file -wait 2
Replicate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Replicate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d1 disk101 NX
RV:/dev/rdsk/c0t2d1 disk102 NX
Replicate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d2 disk201 NX
RV:/dev/rdsk/c0t2d2 disk202 NX
Replicating.....
Replicate Normal End 2000/10/10 09:15:32
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Replicate Normal End 2000/10/10 09:16:12
MV:/dev/rdsk/c0t1d2 disk201 NX
RV:/dev/rdsk/c0t2d2 disk202 NX
Replicate Normal End 2000/10/10 09:16:35
Page 32
Chapter 2 Command Reference
27
MV:/dev/rdsk/c0t1d1 disk101 NX
RV:/dev/rdsk/c0t2d1 disk102 NX
#
The end messages are displayed in the order Replicate commands terminate.
(2) The command is executed by specifying a volume group that consists of two logical
volumes, /dev/rdsk/c1t1d0 and /dev/rdsk/c1t1d1, for an MV
(Individual specification)
# iSMrc_replicate -mv /dev/vg100 -mvflg vg -rv /dev/rdsk/c2t0d1
/dev/rdsk/c2t0d2 -rvflg sfn -wait 2
Replicate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c1t1d0 disk001 NX
RV:/dev/rdsk/c2t0d1 disk221 NX
Replicate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c1t1d1 disk002 NX
RV:/dev/rdsk/c2t0d2 disk222 NX
Replicating.....
Replicate Normal End 2000/10/10 09:16:12
MV:/dev/rdsk/c1t1d0 disk001 NX
RV:/dev/rdsk/c2t0d1 disk221 NX
Replicate Normal End 2000/10/10 09:16:35
MV:/dev/rdsk/c1t1d1 disk002 NX
RV:/dev/rdsk/c2t0d2 disk222 NX
#
[ NOTES ]
• The t arget MV is recognized by Repli cation Control as the Replicatio n target disk.
• The t arget MV and RV are paired.
• The activity state of the target pair is Separate.
• The S emi-Sync copy mode cannot be specified for pairs set in the same disk array. The
Semi-Sync copy mode can be specified only for pairs set in different disk arrays.
• The disk array where the specified MV and RV are stored is not in the freeze state.
• The pair of the specified MV and th e paired RV pair are not in the Restore state.
• The act ivity state of the pair of the speci fied MV and the paired upper MV i s Separate.
• The act i vi ty state of the pair of the specified RV and the paired lower RV is Separate.
• RV is unmounted from the host.
Page 33
Chapter 2 Command Reference
28
The following notes apply to the case when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
• The t arget MV is registered in the Volume List.
• Specifying volume of a dynamic disk is not allowed.
• MV is a disk array under control of the self host.
• A Volume List is not being created.
• When specifying the combination of a volume group or a disk group with a special file name
(logical disk name), for an MV(RV), specify the same number of logical volumes th at
constitute a volume group or a disk group on the specified special file name (logical disk name)
side. In this case, copying is performed in the specified order.
• To specify a volume group, the target volume group must be active.
• To specify a disk group, the target disk group must be active.
• The i SM special file is not being created (the UNIX system HP-UX version only).
[ RETURN VALUE ]
0: Operation for all the paired volumes terminated normally.
1: Operation for all the paired volumes terminated abnormally.
2: Operation for some paired volumes terminated abnormally.
3: The command terminated abnormally because all or some of the paired vol umes were already
in Replicate State.
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• The instruction fails due to a disk array error.
Page 34
Chapter 2 Command Reference
29
2
2
2
.
.
.
2
2
2
.
.
.
2
2
2
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
s
s
s
e
e
e
p
p
p
a
a
a
r
r
r
a
a
a
t
t
t
e
e
e
[ NAME ]
iSMrc_separate - Separates RV from MV.
[ SYNOPSIS ]
iSMrc_separate -mv volume -mvflg mv_flg
[-rv volume -rvflg rv_flg]
[-rvacc rv_access]
[-rvuse rv_use | -force force_arg]
[-wait [second] | -nowait]
iSMrc_separate -file file_name
[-rvacc rv_access]
[-rvuse rv_use | -force force_arg]
[-wait [second] | -nowait]
iSMrc_separate -?
iSMrc_separate -help
[ DESCRIPTION ]
The iSMrc_separate command separates the paired MV and RV.
OPTIONS
The iSMrc_separate command recognizes the following options and arguments.
-mv volume Specify volume of MV.
For information about the volume and volume types, refer to 1.2
“Volume Types”.
-mvflg mv_flg Specify the volume type specified in -mv.
This argument must be specified with -mv.
For information about the volume and volume types, refer to 1.2
“Volume Types”.
-rv volume Specify volume of RV.
For information about the volume and volume types, refer to 1.2
“Volume Types”.
-rvflg rv_flg Specify the volume type specified in -rv.
This argument must be specified if -rv is specified.
For information about the volume and volume types, refer to 1.2
“Volume Types”.
Page 35
Chapter 2 Command Reference
30
-rvacc rv_access Specify the access restrictions for RV.
In rv_access, one of the following can be specified .
ro Read Only is allowed for RV.
rw Read/write are allowed for RV.
If this argument is omitted, the operation is the same as the
operation when rw is specified.
If -force is specified, this argument is ignored.
-rvuse rv_use Determine when to make the RV available.
One of the following can be specified for rv_use:
immediate After Separate execution, the RV is
immediately available while the difference
between the MV and RV contents is being
reflected into the RV.
complete After Separate execution, the RV becomes
available when the differen ce between the MV
and RV contents has been reflected into the
RV.
default This value can be changed in the replication
operation option setting file on the Windows
system and in the environment variable on the
UNIX system. For details, refer to Chapter 3
“Operation Settings”.
If this argument is omitted, the system performs the same operation
as when default is selected.
Do not specify the -rvuse option with the -force option.
-force force_arg Instructs to separate forcibly when a copy error occurs in MV/RV
and the Replicate state cannot be continued.
In force_arg, one of the following can be specified .
all Performs Forced Separate for MV/RV.
mv Performs Forced Separate only for MV.
rv Performs Forced Separate only for RV.
When executing -force all or rv, RV must be a disk array under
control of the self host.
Do not specify the -force option with the -rvuse option.
Page 36
Chapter 2 Command Reference
31
-wait [second ] | -nowait Specify whether to wait for completion of Separate.
If -wait is specified, it waits until difference reflection
of MV/RV is complete.
It also monitors process state in a certain time interval.
The monitoring time interval is 5 seconds. If a value is
specified in second, the monitoring time interval of the
disk array becomes the specified value. The unit is
second, and the available range is from 1 through 30
seconds (integer). This value can be changed in the
replication operation option setting file on the Windows
system and in the environment variable on the UNIX
system. For details, refer to Chapter 3 “Operation
Settings”.
If this argument is omitted, the operation is the same as
the operation when -nowait is specified.
If -force is specified, this argument is ignored.
-file file_name To specify multiple pairs, describe the pairs of MV/RV in
file_name.
The copy operation instruction is specified in the
argument. If multiple pairs are specified, a copy request
is issued to the pairs simultaneously, and the operation
instruction is reflected to all the pairs.
For the description format of file_name, refer to 1.3
“Replication Operation Fil e”.
When multiple pairs are specified, if an error occurs in
some pairs, the process is continued until it is terminated
in all the specified pairs.
-? Displays the usage of this command (Windows).
-help Displays the usage of this command (UNIX).
Page 37
Chapter 2 Command Reference
32
[ DISPLAYED INFORMATION ]
On the Windows system
(1) Information when the command terminates normally with -wait specification is displayed.
(Individual specification)
C:\>iSMrc_separate -mv ld_name -mvflg ld -rv ld_name -rvflg ld -wait 2
Separate Start YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
Separating.....
Separate Normal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
• Separate Start YYYY/MM/DD hh:mm:ss
Separate starting message and Start Time
• MV:disk_number ld_name type
volume name
path
• RV:disk_number ld_name type
volume name
path
MV/RV physical disk number, logical disk name, OS type, mount point volume
name, and drive letters or path name mounted to the folder of the NTFS volume
accessed by users
• Separating.....
Message in Separate execution
The display of this message can be suppressed by setting an option. For details
on the option setting, refer to 3.1 “Replication Operation Option Setting File”.
• Separate Normal End YYYY/MM/DD hh:mm:ss
Separate end message and end time
Page 38
Chapter 2 Command Reference
33
(2) When -wait has been specified, the copy difference remains unchanged for the period of
time (30 seconds) set in RPL_ENDWATCHDEV of the replication operation option setting
file, and the operation terminated abnormally, the following information is displayed:
(Individual specification)
C:\>iSMrc_separate -mv ld_name -mvflg ld -rv ld_name -rvflg ld -wait 2
Separate Start YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
Separating.....
iSMrc_separate: Error: iSM13663: The processing of waiting has terminated because
"separate diff" or "copy diff" does not decrease in the specified time. (30 sec)
Separate Abnormal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
The following is displayed as an error message.
iSMrc_separate: Error: iSM13663: The processing of waiting has
terminated because "separate diff" or "copy diff" does not decrease
in the specified time. (30 sec)
On the UNIX system
(1) When the command terminates normally with the -wait specification, the followi ng
information is displayed.
(Individual specification)
# iSMrc_separate -mv special_file_name -mvflg sfn -rv
special_file_name -rvflg sfn -wait 2
Separate Start YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
Separating.....
Separate Normal End YYYY/MM/DD hh:mm:ss
Page 39
Chapter 2 Command Reference
34
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
• Separate Start YYYY/MM/DD hh:mm:ss
Separate start message and start time
• MV:special_file_name LD Name type
RV:special_file_name LD Name type
MV/RV’s special file name, logical disk name, OS type
• Separating.....
Message that appears during Separate execution
The display of this message can be suppressed by setting an option. For details
of the option setting, refer to 3.2 “Environment Variables”.
• Separate Normal End YYYY/MM/DD hh:mm:ss
Separate end message and end time
(2) When -wait has been specified, and the copy difference remains unchanged for the period
of time (30 seconds) set in RPL_ENDW ATCHDEV of the environment variable, and the
operation terminated abnormally, the following information is displayed.
(Individual specification)
# iSMrc_separate -mv special_file_name -mvflg sfn -rv
special_file_name -rvflg sfn -wait 2
Separate Start YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
Separating.....
iSMrc_separate: Error : iSM13663 : The processing of waiting has
terminatedbecause "separate diff" or"copy diff" does not decrease
in the specified time. (30 sec)
Separate Abnormal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Page 40
Chapter 2 Command Reference
35
Description of messages:
The following is displayed as an error message.
iSMrc_separate: Error : iSM13663 : The processing of waiting has
terminated because "separate diff" or "copy diff" does not decrease
in the specified time. (30 sec)
[ USAGE ]
On the Windows system
(1) The command is executed with the monitoring time interval of 2 seconds with -wait
specification.
(Individual specification)
C:\>iSMrc_separate -mv dev001 -mvflg ld -rv dev002 -rvflg ld -wait 2
Separate Start 2001/01/28 17:56:23
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:2 dev002 WN
-
-
Separating.....
Separate Normal End 2001/01/28 17:56:23
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:2 dev002 WN
-
-
C:\>
(2) The command is executed with the monitoring time interval of 2 seconds with -wait
specification.
(Batch specification)
C:\>iSMrc_separate -file volume_file -wait 2
Separate Start 2001/01/28 17:56:17
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
-
Separate Start 2001/01/28 17:56:17
MV:3 dev002 WN
\\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\
F:
Page 41
Chapter 2 Command Reference
36
RV:4 dev102 WN
-
-
Separate Start 2001/01/28 17:56:17
MV:5 dev003 WN
\\?\Volume{71facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:6 dev103 WN
-
-
Separating.....
Separate Normal End 2001/01/28 17:56:20
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
-
Separate Normal End 2001/01/28 17:56:21
MV:3 dev002 WN
\\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\
F:
RV:4 dev102 WN
-
-
Separate Normal End 2001/01/28 17:56:23
MV:5 dev003 WN
\\?\Volume{71facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:6 dev103 WN
-
-
C:\>
• Th e end messages are displayed in the order Separate commands terminate.
On the UNIX system
(1) The command is executed with the monitoring time interval of two seconds by the -wait
specification.
(Individual specification)
# iSMrc_separate -mv /dev/rdsk/c0t1d0 -mvflg sfn -rv
/dev/rdsk/c0t2d0 -rvflg sfn -wait 2
Separate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Page 42
Chapter 2 Command Reference
37
Separating.....
Separate Normal End 2000/10/10 09:11:24
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
#
(Batch specification)
# iSMrc_separate -file volume_file -wait 2
Separate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Separate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d1 disk101 NX
RV:/dev/rdsk/c0t2d1 disk102 NX
Separate Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d2 disk201 NX
RV:/dev/rdsk/c0t2d2 disk202 NX
Separating.....
Separate Normal End 2000/10/10 09:15:32
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Separate Normal End 2000/10/10 09:16:12
MV:/dev/rdsk/c0t1d2 disk201 NX
RV:/dev/rdsk/c0t2d2 disk202 NX
Separate Normal End 2000/10/10 09:16:35
MV:/dev/rdsk/c0t1d1 disk101 NX
RV:/dev/rdsk/c0t2d1 disk102 NX
#
• The end messages are displa yed in the order Separate commands terminate.
Page 43
Chapter 2 Command Reference
38
[ NOTES ]
• Th e target MV is recognized by Replication Control as the Replication target disk.
• Th e target MV and RV are paired.
• The activity state of the target pair is not Restore Execution.
• Th e copy control state of the target pair is the Foreground Copy stat e.
* To separate pairs in the Background Copy state, you must perform Resume Copy and change
them to the Foreground Copy state.
• Th e disk array where the specified MV and RV are stored is not in the freeze state.
• When Separate starts, you must flush the file system cache used by MV before the instruction is
executed or unmount MV in order to finish updates to MV.
The following notes apply to the case when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
• Th e target MV is registered in the Volume List.
• Specifying volume of a dynamic disk is not allowed.
• MV is a disk array under control of the self host.
• A Volume List is not being created.
• When specifying the combination of a volume group or a disk group with a special file name
(logical disk name), for an MV(RV), specify the same number of logical volumes that constitute
a volume group or a disk group on the specified special file name (logical disk name) side.
• To specify a volume group, the target volume group must be active.
• To specify a disk group, the target disk group must be active.
• Th e iSM special file is not being created (the UNIX system HP-UX version only).
[ RETURN VALUE ]
0: Operation for all the paired volumes terminated normally.
1: Operation for all the paired volumes terminated abnormally.
2: Operation for some paired volumes terminated abnormally.
3: The command terminated abnormally because all or some of the paired vol umes were already
in Replicate State.
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• The in struction fails due to a disk array error.
Page 44
Chapter 2 Command Reference
39
2
2
2
.
.
.
2
2
2
.
.
.
3
3
3
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
r
r
r
e
e
e
s
s
s
t
t
t
o
o
o
r
r
r
e
e
e
[ NAME ]
iSMrc_restore - Starts copy from RV to MV.
[ SYNOPSIS ]
iSMrc_restore -mv volume -mvflg mv_flg
[-rv volume -rvflg rv_flg]
[-cprange copy_range] [-cpmode copy_mode]
[-rvacc rv_access] [-wait [second] | -nowait]
[-mode operation_mode ]
iSMrc_restore -file file_name
[-cprange copy_range] [-cpmode copy_mode]
[-rvacc rv_access] [-wait [second] | -nowait]
[-mode operation_mode ]
iSMrc_restore -?
iSMrc_restore -help
[ DESCRIPTION ]
The iSMrc_restore command copies data from the paired RV to MV.
When the system directly controls the I/O issuance to disk arrays, on the Win do ws s ystem,
unmount MV, flush the file system buffer, and then start Restore. After starting Restore,
re-mount the MV. On the UNIX system, if MV’s file system has been mounted, the system does
not start Restore and terminates operation abnormally. Therefore, it is necessary to unmount the
MV’s file system before executing Restore.
OPTIONS
The iSMrc_restore command reco gnizes the following options and arguments.
-mv volume Specify volume of MV.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-mvflg mv_flg Specify the volume type specified in -mv.
This argument must be specified with -mv.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
Page 45
Chapter 2 Command Reference
40
-rv volume Specify volume of RV.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-rvflg rv_flg Specify the volume type specified in -rv.
This argument must be specified if -rv is specified.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-cprange copy_range S pecify the range of copy from RV to MV.
In copy_range, one of the following can be sp ecified.
diff Restore only updates to MV since Separate
from RV to MV.
full Restore all area from RV to MV.
If this argument is omitted, the operation is the same as
the operation when diff is sp ecified.
-cpmode copy_mode Specify how to reflect the MV update to RV.
In copy_mode, one of the following can be specified .
sync Sync mode
semi Semi-sync mode
bg Background copy mode
If this argument is omitted, the operation is the same as
the operation when sync is specified.
If the RV protection restore is carried out, this argument
specification becomes invalid.
-rvacc rv_access Specify the access restrictions for RV.
In rv_access, one of the following can be specified .
ro Only read is allowed for RV.
nr Access to RV is not allowed.
If this argument is omitted, the operation is the same as
the operation when nr is specified.
Page 46
Chapter 2 Command Reference
41
-wait [second] | -nowait Specify whether to wait for completion of Restore.
If -wait is specified, it waits until difference reflection
of MV/RV is complete.
It also monitors process state in a certain time interval.
The monitoring time interval is 5 seconds. If a value is
specified in second, the monitoring time interval of the
disk array becomes the specified value. The unit is
second, and the available range is from 1 through 30
seconds (integer). This value can be changed in the
replication operation option setting file on the Windows
system and in the environment variable on the UNIX
system. For details, refer to Chapter 3 “Operation
Settings”.
If this argument is omitted, the operation is the same as
the operation when -nowait is specified.
-mode operation_mode Specify an operation mode for RV at executi on of
Restore.
One of the following can be specified for
operation_mode:
update: Performs restoration while reflecting the
updated data of the MV into the RV.
When the restoration is completed, the state
changes to Sync State (rst/sync).
protect: Performs restoration without reflecting the
updated data of the MV into the RV.
When the restoration is completed, Separate
is automatically executed and then the state
changes to Separated State.
default: This value can be changed in the replication
operation option setting file on the
Windows system and in the environment
variable on the UNIX system. For details,
refer to Chapter 3 “Operation Settings”.
If this argument is omitted, the system performs the same
operation as when default is selected.
Page 47
Chapter 2 Command Reference
42
-file file_name To specify multiple pairs, describe the pairs of MV/RV in
file_name.
The copy operation instruction is specified in the
argument. If multiple pairs are specified, a copy request
is issued to the pairs simultaneously, and the operation
instruction is reflected to all the pairs.
For the description format of file_name, refer to 1.3
“Replication Operation Fil e”.
When multiple pairs are specified, if an error occurs in
some pairs, an error message indicating that is displayed,
and the process is continued until it is terminated in all
the specified pairs.
-? Displays the usage of this command (Windows).
-help Displays the usage of this command (UNIX).
Page 48
Chapter 2 Command Reference
43
[ DISPLAYED INFORMATION ]
On the Windows system
(1) Information when the command terminates normally with -wait specification is displayed.
(Individual specification)
C:\>iSMrc_restore -mv ld_name -mvflg ld -rv ld_name -rvflg ld -wait 2
iSMrc_restore: Info: iSM13224: MV is restored.
Volume Name: volume name
MountPoint drive letter or mount point
Umount Start YYYY/MM/DD hh:mm:ss
Umount Normal End YYYY/MM/DD hh:mm:ss
Restore Start YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
Mount Start YYYY/MM/DD hh:mm:ss
Mount Normal End YYYY/MM/DD hh:mm:ss
Restoring.....
Restore Normal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
• iSMrc_restore: Info: iSM13224: MV is restored.
Volume Name: Volume_name
Mount Point: drive letter or mount point
Mount point volume name of MV, and drive letter or NTFS folder name
• Umount Start YYYY/MM/DD hh:mm:ss
Message indicating the start of unmounting MV, and start time
• Umount Normal End YYYY/MM/DD hh:mm:ss
Message indicating the end of unmounting MV, and end time
• Restore Start YYYY/MM/DD hh:mm:ss
Message indicating the start of restore, and start time
• MV:disk_number ld_name type
volume name
path
Page 49
Chapter 2 Command Reference
44
• RV:disk_number ld_name type
volume name
path
MV/RV physical disk number, logical disk name, OS type, mount point volume
name, and drive letters or path name mounted to the folder of the NTFS volume
accessed by users
• Mount Start YYYY/MM/DD hh:mm:ss
Message indicating the start of mounting MV, and start time
• Mount Normal End YYYY/MM/DD hh:mm:ss
Message indicating the end of mounting MV, and end time
• Restoring.....
Message in Restore execution
This option setting enables this message to be output. For the description of the
setting, refer to 3.1 “Replication Operation Option Setting File”.
• Restore Normal End YYYY/MM/DD hh:mm:ss
Restore end message and end time
(2) When -wait has been specified, the copy difference remains unchanged for the period of
time (30 seconds) set in RPL_ENDWATCHDEV of the replication operation option setting
file, and the operation terminated abnormally, the following information is displayed:
(Individual specification)
C:\>iSMrc_restore -mv ld_name -mvflg ld -rv ld_name -rvflg ld -wait 2
iSMrc_restore: Info: iSM13224: MV is restored.
Volume Name: volume name
MountPoint: drive letter or mount point
Umount Start YYYY/MM/DD hh:mm:ss
Umount Normal End YYYY/MM/DD hh:mm:ss
Restore Start YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
Mount Start YYYY/MM/DD hh:mm:ss
Mount Normal End YYYY/MM/DD hh:mm:ss
Restoring.....
iSMrc_restore: Error : iSM13663: The processing of waiting has terminated because
"separate diff" or "copy diff" does not decrease in the specified time. (30 sec)
Restore Abnormal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
Page 50
Chapter 2 Command Reference
45
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
The following is displayed as an error message.
iSMrc_restore: Error: iSM13663: The processing of waiting has terminated because
“separate diff” or “copy diff” does n ot decrease in the specified time. (3 0 sec)
On the UNIX system
(1) When the command terminates normally with the -wait specification, the following
information is displayed.
(Individual specification)
# iSMrc_restore -mv special_file_name -mvflg sfn -rv
special_file_name -rvflg sfn -wait 2
Restore Start YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
Restoring.....
Restore Normal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
• Restore Start YYYY/MM/DD hh:mm:ss
Restore start message and start time
• MV:special_file_name LD Name type
RV:special_file_name LD Name type
MV/RV’s special file name, logical disk name, OS type
• Restoring.....
Message that appears duri ng Restore execution
The display of this message can be suppressed by setting an option. For details
of the option setting, refer to 3.2 “Environment Variables”.
• Restore Normal End YYYY/MM/DD hh:mm:ss
Restore end message and end time
Page 51
Chapter 2 Command Reference
46
(2) When -wait has been specified, and the copy difference remains unchanged for the period
of time (30 seconds) set in RPL_ENDW ATCHDEV of the environment variable, and the
operation terminated abnormally, the following information is displayed.
(Individual specification)
# iSMrc_restore -mv special_file_name -mvflg sfn -rv
special_file_name -rvflg sfn -wait 2
Restore Start YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
Restoring.....
iSMrc_restore: Error : iSM13663 : The processing of waiting has
terminatedbecause "separate diff" or "copy diff" does not decrease
in the specified time. (30 sec)
Restore Abnormal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
The following is displayed as an error message.
iSMrc_restore: Error : iSM13663 : The processing of waiting has
terminated because "separate diff" or "copy diff" does not decrease
in the specified time. (30 sec)
Page 52
Chapter 2 Command Reference
47
[ USAGE ]
On the Windows system
(1) The command is executed with the monitoring time interval of 2 seconds with -wait
specification.
(Individual specification)
C:\>iSMrc_restore -mv dev001 -mvflg ld -rv dev002 -rvflg ld -wait 2
iSMrc_restore: Info: iSM13224: MV is restored.
Volume Name: \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
MountPoint: G:\
Umount Start 2001/01/28 17:55:11
Umount Normal End 2001/01/28 17:55:12
Restore Start 2001/01/28 17:55:13
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:2 dev002 WN
-
Mount Start 2001/01/28 17:55:15
Mount Normal End 2001/01/28 17:55:16
Restoring.....
Restore Normal End 2001/01/28 17:55:19
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:2 dev002 WN
-
-
C:\>
Page 53
Chapter 2 Command Reference
48
(2) T he comma nd is e xe c uted w ith the monitoring time interval of 2 seconds with -wait
specification.
(Batch specification)
C:\>iSMrc_restore -file volume_file -wait 2
iSMrc_restore: Info: iSM13224: MV is restored.
Volume Name: \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
MountPoint: E:\
Umount Start 2001/01/28 17:55:16
Umount Normal End 2001/01/28 17:55:17
Restore Start 2001/01/28 17:55:17
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
Mount Start 2001/01/28 17:55:19
Mount Normal End 2001/01/28 17:55:19
iSMrc_restore: Info: iSM13224: MV is restored.
Volume Name: \\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\
MountPoint: F:\
Umount Start 2001/01/28 17:55:20
Umount Normal End 2001/01/28 17:55:21
Restore Start 2001/01/28 17:55:21
MV:3 dev002 WN
\\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\
F:
RV:4 dev102 WN
-
Mount Start 2001/01/28 17:55:22
Mount Normal End 2001/01/28 17:55:23
Restoring.....
Restore Normal End 2001/01/28 17:55:51
MV:3 dev002 WN
\\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\
F:
RV:4 dev102 WN
-
-
Restore Normal End 2001/01/28 17:55:58
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
-
C:\>
Page 54
Chapter 2 Command Reference
49
The end messages are disp l ayed in the order Restore commands terminate.
Page 55
Chapter 2 Command Reference
50
On the UNIX system
(1) The command is executed with the monitoring time interval of two seconds by the -wait
specification.
(Individual specification)
# iSMrc_restore -mv /dev/rdsk/c0t1d0 -mvflg sfn -rv
/dev/rdsk/c0t2d0 -rvflg sfn -wait 2
Restore Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Restoring.....
Restore Normal End 2000/10/10 09:15:32
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
#
(Batch specification)
# iSMrc_restore -file volume_file -wait 2
Restore Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Restore Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d1 disk101 NX
RV:/dev/rdsk/c0t2d1 disk102 NX
Restore Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d2 disk201 NX
RV:/dev/rdsk/c0t2d2 disk202 NX
Restoring.....
Restore Normal End 2000/10/10 09:15:32
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Restore Normal End 2000/10/10 09:16:12
MV:/dev/rdsk/c0t1d2 disk201 NX
RV:/dev/rdsk/c0t2d2 disk202 NX
Page 56
Chapter 2 Command Reference
51
Restore Normal End 2000/10/10 09:16:35
MV:/dev/rdsk/c0t1d1 disk101 NX
RV:/dev/rdsk/c0t2d1 disk102 NX
#
• The end messages are displa yed in the order Restore commands terminate.
(2) The command is executed by specifying a volume group that consists of two logical
volumes, /dev/rdsk/c1t1d0 and /dev/rdsk/c1t1d1, for an MV.
(Individual specification)
# iSMrc_restore -mv /dev/vg100 -mvflg vg -rv /dev/rdsk/c2t0d1
/dev/rdsk/c2t0d2 -rvflg sfn -wait 2
Restore Start 2000/10/10 09:11:23
MV:/dev/rdsk/c1t1d0 disk001 NX
RV:/dev/rdsk/c2t0d1 disk221 NX
Restore Start 2000/10/10 09:11:23
MV:/dev/rdsk/c1t1d1 disk002 NX
RV:/dev/rdsk/c2t0d2 disk222 NX
Restoring.....
Restore Normal End 2000/10/10 09:16:12
MV:/dev/rdsk/c1t1d0 disk001 NX
RV:/dev/rdsk/c2t0d1 disk221 NX
Restore Normal End 2000/10/10 09:16:35
MV:/dev/rdsk/c1t1d1 disk002 NX
RV:/dev/rdsk/c2t0d2 disk222 NX
#
[ NOTES ]
• Th e target MV is recognized by Replication Control as the Replication target disk.
• Th e target MV and RV are paired.
• The activity state of the target pair is Separate. However, separate is not being executed.
• The Semi-Sync copy mode cannot be specified for pairs set in the same disk array.
• Th e Semi-Sync copy mode can be specified o nly for pairs set in different disk arrays.
• Th e disk array where the specified MV and RV are stored is not in the freeze state.
• Th e activity state of the pair of the specified MV and another pair ed RV is Separate.
• Th e activity state of the pair o f the specified MV and the paired upper MV is Separate.
• Th e activity state of the pair of the specified RV and the paired lower RV is Separate.
Page 57
Chapter 2 Command Reference
52
• MV and RV must be unmounted from the host.
The following notes apply to the case when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
• Th e target MV is registered in the Volume List.
• Specifying volume of a dynamic disk is not allowed.
• MV is a disk array under control of the self host.
• A Volume List is not being created.
• When specifying the combination of a volume group or a disk group with a special file name
(logical disk name), for an MV(RV), specify the same number of logical volumes that constitute
a volume group or a disk group on the specified special file name (logical disk name) side. In
this case, copying is performed in the specified order.
• To specify a volume group, the target volume group must be active.
• To specify a disk group, the target disk group must be active.
• Th e iSM special file is not being created (the UNIX system HP-UX version only).
[ RETURN VALUE ]
0: Operation for all the paired volumes terminated normally.
1: Operation for all the paired volumes terminated abnormally.
2: Operation for some paired volumes terminated abnormally.
3: The command terminated abnormally because all or some of the paired vol umes were already
in Replicate State.
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• The in struction fails due to a disk array error.
• The MV is being accessed.
Page 58
Chapter 2 Command Reference
53
2
2
2
.
.
.
2
2
2
.
.
.
4
4
4
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
c
c
c
h
h
h
a
a
a
n
n
n
g
g
g
e
e
e
[ NAME ]
iSMrc_change - Changes the copy control state of MV/RV.
[ SYNOPSIS ]
iSMrc_change {-suspend | -resume | -sync | -semi | -bg}
-mv volume -mvflg mv_flg
[-rv volume -rvflg rv_flg]
iSMrc_change -file file_name
{-suspend | -resume | -sync | -semi | -bg}
iSMrc_change -?
iSMrc_change -help
[ DESCRIPTION ]
The iSMrc_change command changes the copy control state of the paired MV/RV.
When Restore with RV protection specified is executed, th e updated data of the MV is not
reflected into the RV. Therefore, changing a copy control state (synchronous copy mode, semi
synchronous copy mode, or background copy) has no meaning.
OPTIONS
The iSMrc_change command recognizes the following options and arguments.
-suspend Suspends all the copy control states of the Sync Copy
mode, Semi-Sync Copy mode, and Background Copy
mode.
-resume Changes the copy control state to Foreground Copy.
-sync Executes with the Sync Copy mode as the copy control
state.
-semi Executes with the Semi-Sync Copy mode as the copy
control state.
-bg Suspends the copy control state in the Sync Copy or
Semi-Sync Copy mode. Write I/O is accumulated in the
difference map, and the copy control state is performed in
the background which is asynchronous to I/O.
-mv volume Specify volume of MV.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
Page 59
Chapter 2 Command Reference
54
-mvflg mv_flg Specify the volume type specified i n -mv.
This argument must be specified with -mv.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-rv volume Specify volume of RV.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-rvflg rv_flg Specify the volume type specified i n -rv.
This argument must be specified if -rv is specified.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-file file_name To specify multiple pairs, describe the pairs of MV/RV in
file_name.
The copy operation instruction is specified in the
argument. If multiple pairs are specified, a copy request
is issued to the pairs simultaneously, and the operation
instruction is reflected to all the pairs.
For the description format of file_name, refer to 1.3
“Replication Operation Fil e”.
When multiple pairs are specified, if an error occurs in
some pairs, an error message indicating that is displayed,
and the process is continued until it is terminated in all
the specified pairs.
-? Displays the usage of this command (Windows).
-help Displays the usage of this command (UNIX).
Page 60
Chapter 2 Command Reference
55
[ DISPLAYED INFORMATION ]
On the Windows system
(1) Information when the command terminates normally with -suspend specification is
displayed.
(Individual specification)
C:\>iSMrc_change -suspend -mv ld_name -mvflg ld -rv ld_name -rvflg ld
Change Start YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
Change Normal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
• Change Start YYYY/MM/DD hh:mm:ss
Change Copy Control State starting message and Start Time
• MV:disk_number ld_name type
volume name
path
• RV:disk_number ld_name type
volume name
path
MV/RV physical disk number, logical disk name, OS type, mount point volume
name, and drive letters mounted to the folder of the NTFS volume accessed by
users
• Change Normal End YYYY/MM/DD hh:mm:ss
Change Copy Control State end message and end time
On the UNIX system
When the command terminates normally with the -suspend specification, the following
information is displayed.
(Individual specification)
# iSMrc_change -suspend -mv special_file_name -mvflg sfn -rv
special_file_name -rvflg sfn
Page 61
Chapter 2 Command Reference
56
Change Start YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
Change Normal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
• Change Start YYYY/MM/DD hh:mm:ss
Change Copy Control State start message and start time
• MV:special_file_name LD Name type
RV:special_file_name LD Name type
MV/RV’s special file name, logical disk name, OS type
• Change Normal End YYYY/MM/DD hh:mm:ss
Change Copy Control State end message and end time
[ USAGE ]
On the Windows system
(1) The command suspends the copy control state.
(Individual specification)
C:\>iSMrc_change -suspend -mv dev001 -mvflg ld -rv dev101 -rvflg ld
Change Start 2001/01/28 18:14:44
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:1 dev101 WN
-
-
Change Normal End 2001/01/28 18:14:44
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
-
C:\>
Page 62
Chapter 2 Command Reference
57
(2) The -suspend command resumes the suspended copy control state in the Sync copy mode.
(Individual specification)
C:\>iSMrc_change -sync -mv dev001 -mvflg ld -rv dev101 -rvflg ld
Change Start 2001/01/28 18:14:44
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
-
Change Normal End 2001/01/28 18:14:44
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
E:
RV:2 dev101 WN
-
-
C:\>
On the UNIX system
(1) This command suspends the Copy Con t rol State.
(Individual specification)
# iSMrc_change -suspend -mv /dev/rdsk/c0t1d0 -mvflg sfn -rv
/dev/rdsk/c0t2d0 -rvflg sfn
Change Start 2000/10/10 09:11:23
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Change Normal End 2000/10/10 09:11:24
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
#
Page 63
Chapter 2 Command Reference
58
(2) This command resumes the Copy Control State suspended by the -suspend co mmand in
the synchronous copy mode.
(Individual specification)
# iSMrc_change -sync -mv /dev/rdsk/c0t1d0 -mvflg sfn -rv
/dev/rdsk/c0t2d0 -rvflg sfn
Change Start 2000/10/10 09:11:30
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
Change Normal End 2000/10/10 09:11:31
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
#
[ NOTES ]
• Th e target MV is recognized by Replication Control as the Replication target disk.
• Th e target MV and RV are paired.
• Th e activity state of the target pair i s Replicate or Restore.
• The Semi-Sync copy mode cannot be specified for pairs set in the same disk array.
• Th e Semi-Sync copy mode can be specified o nly for pairs set in different disk arrays.
• Th e disk array where the specified MV and RV are stored is not in the freeze state.
• Changing from Sync to Semi-Sync copy mode or from Semi-Sync to Sync copy mode is
disabled.
The following notes apply to the case when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
• Th e target MV is registered in the Volume List.
• Specifying volume of a dynamic disk is not allowed.
• MV is a disk array under control of the self host.
• A Volume List is not being created.
• When specifying the combination of a volume group or a disk group with a special file name
(logical disk name), for an MV (RV), specify the same number of logical volumes that
constitute a volume group or a disk group on the specified special file name (logical disk name)
side.
• To specify a volume group, the target volume group must be active.
• To specify a disk group, the target disk group must be active.
• Th e iSM special file is not being created (the UNIX system HP-UX version only).
Page 64
Chapter 2 Command Reference
59
[ RETURN VALUE ]
0: Operation for all the paired volumes terminated normally.
1: Operation for all the paired volumes terminated abnormally.
2: Operation for some paired volumes terminated abnormally.
3: The command terminated abnormally because all or some of the paired vol umes were already
in Replicate State.
• Operation with -suspend specified for paired volumes for which Copy has been
suspended
• Operation with -resume, -sync, or -semi specified for paired volumes for which
Foreground Copy is in progress
• Operation with -bg specified for paired volumes for which Background Copy is in
progress
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• The in struction fails due to a disk array error.
Page 65
Chapter 2 Command Reference
60
2
2
2
.
.
.
2
2
2
.
.
.
5
5
5
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
w
w
w
a
a
a
i
i
i
t
t
t
[ NAME ]
iSMrc_wait - Waits for Sync State (rpl/sync), Sync State (rst/sync), and Separated State.
[ SYNOPSIS ]
iSMrc_wait -cond condition
-mv volume -mvflg mv_flg
[-rv volume -rvflg rv_flg]
[-interval interval_time ] [-limit limit_time ]
iSMrc_wait -cond condition
-rv volume -rvflg rv_flg
[-interval interval_time ] [-limit limit_time ]
iSMrc_wait -cond condition
-file file_name
[-interval interval_time ] [-limit limit_time ]
iSMrc_wait -?
iSMrc_wait help
[ DESCRIPTION ]
The iSMrc_wait command wait s for a specified pair of volumes to enter the Sync State
(rpl/sync), Sync State (rst/sync), or Separated State.
OPTIONS
The iSMrc_wait command recognizes the following options and arguments:
MV and/or RV can be specified in any of the combinations below.
• MV and RV: Waits for a specified pair of volumes to enter a target state.
• MV only: Waits for all the pairs set with MV to enter a target state.
• RV only: Same operation as when MV and RV are specified
-mv volume Specify a volume of MV.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-mvflg mv_flg Specify the type of the volume specifi ed for -mv.
This argument must be specified with -mv.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
Page 66
Chapter 2 Command Reference
61
-rv volume Specify a volume of RV.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-rvflg rv_flg Specify the type of the volume specifi ed for -rv.
This argument must be specified if -rv is specified.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-cond condition Specify a wait end condition.
One of the following can be specified for condition.
This argument must always be sp ecified.
sync Waits for Sync State (rpl/sync) or Sync State
(rst/sync).
sep Waits for Separated State (separated).
-interval interval_time Specify an interval (in seconds) at which the state of
paired volumes is to be monitored.
This value can be changed in the replication operation
option setting file on the Windows system and in the
environment variable on the UNIX system. For details,
refer to Chapter 3 “Operation Settings”.
-limit limit_time Specify a wait time limit.
Either of the following can be specified for
limit_time.
numeric-value Waits until the specified time elapses
since the wait starts. A value 0 to
86,400 seconds (integer) can b e
specified.
nolim Unlimited wait
If the end condition specified for the -cond option is not
satisfied before the specified time passes after the wait
starts, the wait is discontinued and the command
terminates abnormally.
This value can be changed in the replication operation
option setting file on the Windows system and in the
environment variable on the UNIX system. For details,
refer to Chapter 3 “Operation Settings”.
The default is unlimited wait.
Page 67
Chapter 2 Command Reference
62
-file file_name To specify more than a pair of volumes, specify the
volume names for file_name.
For the description format of file_name, refer to 1.3
“Replication Operation Fil e”.
If multiple pairs of volumes are specified and an error
occurs in a pair of volumes, the system does not
discontinue operation. The system continues operation
until processing for all the specified pairs of volumes is
completed.
The following shows the usage of the wait command:
-? Displays the usage of this command (Windows).
-help Displays the usage of this command (UNIX).
[ DISPLAYED INFORMATION ]
On the Windows system
(1) The following information is displayed when the command is executed to wait for a pair of
volumes in Replicate Execution to enter the Sync State:
C:\> iSMrc_wait -mv ld_name -mvflg ld -rv ld_name -rvflg ld -cond sync
Waiting.....
Replicate Normal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
• Waiting.....
Message during execution of the wait command for Sync State
The display of this message can be suppressed by setting an option. For details
on the option setting, refer to 3.1 “Replication Operation Option Setting File”.
• Replicate Normal End YYYY/MM/DD hh:mm:ss
Replicate end message and end time
• MV:disk_number ld_name type
volume name
path
• RV:disk_number ld_name type
volume name
path
Page 68
Chapter 2 Command Reference
63
MV/RV physical disk number, logical disk name, OS type, mount point volume
name, and drive letter of the drive mounted in the folder of the NTFS volume
accessed by the user
(2) The following information is displayed when the command is executed to wait for a pair of
volumes in Restore Execution to enter the Sync State:
C:\> iSMrc_wait -mv ld_name -mvflg ld -rv ld_name -rvflg ld -cond sync
Waiting.....
Restore Normal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
• Waiting.....
Message during execution of the wait command for Sync State
The display of this message can be suppressed by setting an option. For details
on the option setting, refer to 3.1 “Replication Operation Option Setting File”.
• Restore Normal End YYYY/MM/DD hh:mm:ss
Restore end message and end time
• MV:disk_number ld_name type
volume name
path
• RV:disk_number ld_name type
volume name
path
MV/RV physical disk number, logical disk name, OS type, mount point volume
name, and drive letter of the drive mounted in the folder of the NTFS volume
accessed by the user
Page 69
Chapter 2 Command Reference
64
(3) The following information is displayed when the command is executed to wait for a pair of
volumes in Separate Execution to enter the Separated State:
C:\> iSMrc_wait -mv ld_name -mvflg ld -rv ld_name -rvflg ld -cond sep
Waiting.....
Separate Normal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
• Waiting.....
Message during execution of the wait command for Separated State
The display of this message can be suppressed by setting an option. For details
on the option setting, refer to 3.1 “Replication Operation Option Setting File”.
• Separate Normal End YYYY/MM/DD hh:mm:ss
Separate end message and end time
• MV:disk_number ld_name type
volume name
path
• RV:disk_number ld_name type
volume name
path
MV/RV physical disk number, logical disk name, OS type, mount point volume
name, and drive letter of the drive mounted in the folder of the NTFS volume
accessed by the user
Page 70
Chapter 2 Command Reference
65
(4) If 3,600 seconds is set as a wait time limit and Separate is not completed in 3,600 seconds,
the wait command displays the following error message and information, and terminates
abnormally:
C:\> iSMrc_wait -mv ld_name -mvflg ld -rv ld_name -rvflg ld -cond sep -limit 3600
Waiting.....
iSMrc_wait: Error : iSM13658 : Wait command has terminated because it has reached the
time limit which is specified by the limit option. (3600 sec)
Wait Abnormal End YYYY/MM/DD hh:mm:ss
MV:disk_number ld_name type
volume name
path
RV:disk_number ld_name type
volume name
path
C:\>
Description of messages:
The following is displayed as an error message:
iSMrc_wait: Error : iSM13658 : Wait command has terminated because
it has reached the time limit which is specified by the limit option.
(3600 sec)
• Waiting.....
Message indicating execut i on of the wait command for Separated State
The display of this message can be suppressed by setting an option. For details
of the option setting, refer to 3.2 “Environment Variables”.
• Wait Abnormal End YYYY/MM/DD hh:mm:ss
Wait-command abnormal en d message and end time
• MV:disk_number ld_name type
volume name
path
• RV:disk_number ld_name type
volume name
path
MV/RV physical disk number, logical disk name, OS type, mount point volume
name, and drive letter of the drive mounted in the folder of the NTFS volume
accessed by the user
Page 71
Chapter 2 Command Reference
66
On the UNIX system
(1) When the command is executed to wait for a pair of volumes currently in Replicate
execution to enter the Sync State, the following information is displayed.
# iSMrc_wait -cond sync -mv ld_name -mvflg ld -rv ld_name -rvflg
ld
Waiting.....
Replicate Normal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
• Waiting.....
Message that appears duri ng execution of the wait command for Sync State
The display of this message can be suppressed by setting an option. For details
of the option setting, refer to 3.2 “Environment Variables”.
• Replicate Normal End YYYY/MM/DD hh:mm:ss
Replicate end message and end time
• MV:special_file_name LD Name type
• RV:special_file_name LD Name type
MV/RV’s special file name, logical disk name, OS type
(2) When t he command is executed to wait for a pair of volumes currently in Restore execut ion
to enter the Sync State, the following information is displayed.
# iSMrc_wait -cond sync -mv ld_name -mvflg ld -rv ld_name -rvflg
ld
Waiting.....
Restore Normal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
• Waiting.....
Message that appears duri ng execution of the wait command for Sync State
The display of this message can be suppressed by setting an option. For details
of the option setting, refer to 3.2 “Environment Variables”.
• Replicate Normal End YYYY/MM/DD hh:mm:ss
Page 72
Chapter 2 Command Reference
67
Restore end message and end time
• MV:special_file_name LD Name type
• RV:special_file_name LD Name type
MV/RV’s special file name, logical disk name, OS type
(3) When the command is executed to wait for a pair of volumes currently in Separate execution
to enter the Separated State, the following information is displayed:
# iSMrc_wait -cond sep -mv ld_name -mvflg ld -rv ld_name -rvflg
ld
Waiting.....
Separate Normal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
#
Description of messages:
• Waiting.....
Message that appears duri ng execution of the wait command for Separated state
The display of this message can be suppressed by setting an option. For details
of the option setting, refer to 3.2 “Environment Variables”.
• Separate Normal End YYYY/MM/DD hh:mm:ss
Separate end message and end time
• MV:special_file_name LD Name type
• RV:special_file_name LD Name type
MV/RV’s special file name, logical disk name, OS type
(4) If 3,600 seconds is set as a wait time limit and Separate is not completed in 3,600 seconds,
the wait command displays the following error message and information, and terminates
abnormally.
# iSMrc_wait -cond sep -mv ld_name -mvflg ld -rv ld_name -rvflg
ld -limit 3600
Waiting.....
iSMrc_wait: Error : iSM13658 : Wait command has terminated because
it has reached the time limit which is specified by the limit
option. (3600 sec)
Wait Abnormal End YYYY/MM/DD hh:mm:ss
MV:special_file_name LD Name type
RV:special_file_name LD Name type
Page 73
Chapter 2 Command Reference
68
#
Description of messages:
The following is displayed as an error message.
iSMrc_wait: Error : iSM13658 : Wait command has terminated
because it has reached the time limit which is specified by
the limit option. (3600 sec)
• Waiting.....
Message that appears duri ng execution of the wait command for Separated state
The display of this message can be suppressed by setting an option. For details
of the option setting, refer to 3.2 “Environment Variables”.
• Wait Abnormal End YYYY/MM/DD hh:mm:ss
Wait-command abnormal en d message and end time
• MV:special_file_name LD Name type
• RV:special_file_name LD Name type
MV/RV’s special file name, logical disk name, OS type
[ USAGE ]
On the Windows system
With 1 second specified as the monitoring interval in the -interval option, the command is
executed to wait for Separated State.
C:\>iSMrc_wait -mv dev001 -mvflg ld -rv dev002 -rvflg ld -cond sep
–interval 1
Waiting.....
Separate Normal End 2001/01/28 17:56:23
MV:1 dev001 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
G:
RV:2 dev002 WN
-
-
C:\>
On the UNIX system
With the monitoring time interval of one second, the command is executed to wait for Separated
state.
# iSMrc_wait -cond sep -mv disk001 -mvflg ld -rv disk002 -rvflg ld
-interval 1
Waiting.....
Page 74
Chapter 2 Command Reference
69
Separate Normal End 2000/10/10 09:11:24
MV:/dev/rdsk/c0t1d0 disk001 NX
RV:/dev/rdsk/c0t2d0 disk002 NX
#
[ NOTES ]
• The MV and RV to be operated must be recognized as replication target disks by Replication
Control.
• The MV and RV to be operated must be set as a pair.
The following notes apply to the case when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
• The MV or RV to be operated must be registered in the Volume List.
• A volume of a dynamic disk cannot be specified.
• The MV or RV to be operated must be of a disk array under control of the local host.
• If only RVs are specified, RV must be of a disk array under control of the local host.
• A Volume List must not be being created.
When specifying the combination of a volume group or a disk group with a special file name
(logical disk name), for an MV(RV), specify the same number of logical volumes that constitute
a volume group or a disk group on the specified special file name (logical disk name) side.
To specify a volume group, the target volume group must be active.
To specify a disk group, the target disk group must be active.
The iSM special file is not being created (the UNIX system HP-UX version on ly).
[ RETURN VALUE ]
0: Operation for all the paired volumes terminated normally.
If the state specified for the wait end condition is already placed, normal termination is
assumed.
1: Operation for all the paired volumes terminated abnormally.
2: Operation for some paired volumes terminated abnormally.
[ ERRORS ]
The wait command terminates abnormally in the following cases:
• A parameter is invalid.
• The instruction fails due to a disk array error.
• The state specified for t he wait end condition is not pl aced before the specified time limit.
Page 75
Chapter 2 Command Reference
70
2
2
2
.
.
.
2
2
2
.
.
.
6
6
6
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
q
q
q
u
u
u
e
e
e
r
r
r
y
y
y
[ NAME ]
iSMrc_query - Displays the replication state.
[ SYNOPSIS ]
iSMrc_query -mv volume -mvflg mv_flg
[-rv volume -rvflg rv_flg]
iSMrc_query -rv volume -rvflg rv_flg
iSMrc_query -file file_name
iSMrc_query -?
iSMrc_query -help
[ DESCRIPTION ]
The iSMrc_query command d isp lays the state value of the speci fied paired volumes.
OPTIONS
The iSMrc_query command recognizes the following options and arguments.
MV and RV can be specified i n one of the following combinat ions:
• MV and RV Di splays the state of the specified pair of volumes.
• MV only Displays the state of all volumes paired with MV.
• RV only Displays the state of volumes in the same way as when specifying
MV and RV.
-mv volume Specify volume of MV.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-mvflg mv_flg Specify the volume type specified i n -mv.
This argument must be specified with -mv.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-rv volume Specify volume of RV.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
-rvflg rv_flg Specify the volume type specified in -rv.
This argument must be specified if -rv is specified.
For information about the volume and volume types, refer
to 1.2 “Volume Types”.
Page 76
Chapter 2 Command Reference
71
-file file_name To specify multiple pairs, describe the pairs of MV/RV in
file_name.
The copy operation instruction is specified in the
argument. If multiple pairs are specified, a copy request
is issued to the pairs simultaneously, and the operation
instruction is reflected to all the pairs.
For the description format of file_name, refer to 1.3
“Replication Operation Fil e”.
When multiple pairs are specified, if an error occurs in
some pairs, an error message indicating that is displayed,
and the process is continued until it is terminated in all
the specified pairs.
-? Displays the usage of this command (Windows).
-help Displays the usage of this command (UNIX).
[ DISPLAYED INFORMATION ]
On the Windows system
C:\>iSMrc_query -mv dev001 -mvflg ld
MV: Disk No. mv_disk_number
LD Name mv_ld_name
Type mv_type
Volume Name mv_volume_name
Path mv_path
RV: Disk No. rv_disk_number
LD Name rv_ld_name
Type rv_type
Volume Name rv_volume_name
Path rv_path
Activity State aaaa
Sync State bbbb
Copy Control State cccc
<State> Start Time YYYY/MM/DD hh:mm:ss
<State> End Time YYYY/MM/DD hh:mm:ss
Separate Diff eeeeKB
Copy Diff ffffKB
RV Access gg
Previous Active hhhh
C:\>
Page 77
Chapter 2 Command Reference
72
Description of messages:
• MV: Disk No. MV physical disk number
LD Name Logical disk name
Type OS type
Volume Name Mount point volume name
Path Drive nam e m ounte d to the folder of the NTFS volume ac ce sse d
by users
• RV: Disk No. RV physical disk number
LD Name Logical disk name
Type OS type
Volume Name Mount point volume name
Path Drive nam e m ounte d to the folder of the NTFS volume ac ce sse d
by users
• Activity State Ind icates the activity state.
replicate Rep l icate state
restore Restore state
restore (protect) Restore state with RV protection specified
separate Separate state
• Sync State Indicates the paired operation state.
separated Separated
sep/exec Separate execution
cancel Separate state (forced separate)
fault Separate state (fault separate)
rpl/sync Replicate complete
rpl/exec Replicate execution
rst/sync Restore complete
rst/exec Restore execution
• Copy Control State
Indicates the copy control state.
When Restore with RV protection specified is executed, th e updated data of the MV is not
reflected into the RV. Therefore, the information of Copy Mode (foreground copy or
background copy of synchronous copy mode and semi synchronous copy mode) is invalid
and “-” is displayed.
foreground copy (sync) Foreground copy state (sync copy mode)
foreground copy (semi) Foreground copy state (semi-sync copy mode)
normal suspend Suspend state
abnormal suspend Suspend state (fault)
background copy Background copy state
freeze Freeze state
• <state> Start Time, <state> End Time
Indicates the start and end times of the last replication operat io n executed (Replicate,
Restore, or Separate). When an error or Forced Sep arat e has occurred, its occurrence time
Page 78
Chapter 2 Command Reference
73
is displayed. The <State> shows “Replicate”, “Restore”, “Separate”,
“Fault” (for fault), or “Forced Separate” (for Forced Separate). When “Fault” or
“Forced Separate” is displayed, the End Time does not appear.
• Separate Diff
Indicates the amount of copy difference in the Separate state in kilobyte.
• Copy Diff
Indicates the amount of copy difference in the Replicate or Restore state in kilobyte.
• RV Access
Indicates the access restriction s for RV.
rw Read/Write Permit (Read/Write are allowed)
ro ReadOnly (Only Read is allowed)
nr NotReady (Access is not available)
• Previous Active
Operation state before the state tr ansition
If the pair of volumes enters the Separated State after Sync State when Restore with RV
protection is executed, the following is displayed as the pair’s operation state before the state
transition:
rst/sync (protect) Completion of Restore with RV protection specified
On the UNIX system
The state of the paired vol umes is displayed.
#iSMrc_query -mv mv_special_file_name -mvflg sfn -rv
rv_special_file_name -rvflg sfn
MV: Special File mv_special_file_name
LD Name mv_ld_name
Type mv_type
RV: Special File rv_special_file_name
LD Name rv_ld_name
Type rv_type
Activity State aaaaaaaa
Sync State bbbbbbbb
Copy Control State cccccccc
<state> Start Time YYYY/MM/DD hh:mm:ss
<state> End Time YYYY/MM/DD hh:mm:ss
Separate Diff ddddddddKB
Copy Diff eeeeeeeeKB
RV Access ff
Previous Active gggggggg
#
Page 79
Chapter 2 Command Reference
74
Description of messages:
• MV: Special File, LD Name, Type
Displays the MV’s special file name, logical disk name, and OS type.
• RV: Special File, LD Name, Type
Displays the RV’s special file name, logical disk name, and OS type.
• Activity State
Indicates the activity state.
replicate Replicate state
restore Restore state
restore (protect) Rest ore state with the RV protection specification
separate Separate state
• Sync State
Indicates the pair operati on state.
separated Separated
sep/exec Separate execution
cancel Separate state (forced separate)
fault Separate state (fault separate)
rpl/sync Replicate complete
rpl/exec Replicate execution
rst/sync Restore complete
rst/exec Restore execution
• Copy Control State
Indicates the Copy Control St at e.
When Restore with the RV protection specification is executed, the updated data
of the MV is not reflected into the RV. Therefore, the information of Copy
Mode (foreground copy or background copy of the synchronous copy mode and
the semi-synchronous copy mode) is invalid and “-” is displayed.
foreground copy (sync) Foreground copy state (synchronous copy mode)
foreground copy (semi) Foreground copy state (semi-synchron ous copy mode)
normal suspend Suspend state
abnormal suspend Suspend state (fault)
background copy Background copy state
freeze Freeze state
• <state> Start Time, <state> End Time
Indicates the start and end t imes of the last replication operation (Replicate,
Restore, or Separate) executed. If an error or Forced Separate has occurred, the
time of its occurrence is displayed.
The <state> shows “Replicate”, “Restore”, “Separate”, “Fault”
(for fault), or “Forced Separate” (for Forced Separate). When “Fault” or
“Forced Separate” is displayed, the End Time does not appear.
Page 80
Chapter 2 Command Reference
75
• Separate Diff
Indicates the amount of copy difference in the Separate state in kilobytes.
• Copy Diff
Indicates the amount of copy difference in the Replicate or Restore state in
kilobytes.
• RV Access
Indicates the access restriction for RV.
rw Read/Write Permit (Read and Write are allowed)
ro ReadOn l y (Only Read is allowed)
nr NotReady (Access is not available)
• Previous Active
Pair operation state before the state transition
If the paired volumes enter the Sync State(rst/sync) as the result of Restore with
the RV protection specification and then enter the Separated state, th e fol lowing
is displayed as the pair’s operation state before the state transition.
rst/sync (protect) Completion of Restore with the RV protection specification
[ USAGE ]
On the Windows system
The command displays information regarding the pair state of MV dev001.
C:\>iSMrc_query -mv dev001 -mvflg ld
MV: Disk No. 25
LD Name 20000000000010350018
Type WN
Volume Name Path -
RV: Disk No. 26
LD Name 20000000000010350019
Type WN
Volume Name -
Path Activity State separate
Sync State separated
Copy Control State Separate Start Time 2001/05/03 17:19:38
Separate End Time 2001/05/03 17:19:38
Separate Diff 0KB
Copy Diff 0KB
RV Access rw
Previous Active sep/exec
C:\>
Page 81
Chapter 2 Command Reference
76
On the UNIX system
The command displays information regarding the pair state of MV /dev/rdsk/c1 t2d0.
# iSMrc_query -mv /dev/rdsk/c1t2d0 -mvflg sfn
MV: Special File /dev/rdsk/c1t2d0
LD Name disk001
Type NX
RV: Special File /dev/rdsk/c1t2d1
LD Name disk002
Type NX
Activity State separate
Sync State separated
Copy Control State Separate Start Time Separate End Time 2001/06/03 13:37:24
Separate Diff 2177024KB
Copt Diff 0KB
RV Access rw
Previous Active -
#
[ NOTES ]
• Th e target MV is recognized by Replication as the Replication target disk.
• Th e target MV and RV are paired.
The following notes apply to the case when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
• The target MV or RV is registered in the Volume List.
• Specifying volume of a dynamic disk is not allowed.
• MV is a disk array under control of the self host.
• When specifying RV only, the RV must be a disk array under control of the self host.
• A Volume List is not being created.
• When specifying the combination of a volume group or a disk group with a special file name
(logical disk name), for an MV(RV), specify the same number of logical volumes that constitute
a volume group or a disk group on the specified special file name (logical disk name) side.
• To specify a volume group, the target volume group must be active.
• To specify a disk group, the target disk group must be active.
• Th e iSM special file is not being created (the UNIX system HP-UX version only).
Page 82
Chapter 2 Command Reference
77
[ RETURN VALUE ]
0: Operation for all the paired volumes terminated normally.
1: Operation for all the paired volumes terminated abnormally.
2: Operation for some paired volumes terminated abnormally.
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• The in struction fails due to a disk array error.
Page 83
Chapter 2 Command Reference
78
2
2
2
.
.
.
2
2
2
.
.
.
7
7
7
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
s
s
s
e
e
e
n
n
n
s
s
s
e
e
e
[ NAME ]
iSMrc_sense - Displays the specific volume name.
[ SYNOPSIS ]
iSMrc_sense -vol volume -volflg vol_flg
iSMrc_sense -file file_name
iSMrc_sense -?
iSMrc_sense –help
[ DESCRIPTION ]
The iSMrc_sense command d isp l ays the state value of the specified volume.
OPTIONS
The iSMrc_sense command recognizes the following options and arguments.
-vol volume Specify the volume name.
For information about the volume and volume types, refer to
1.2 “Volume Types”.
-volflg vol_flg Specify the volume type specified in -vol.
This argument must be specified with -vol.
For information about the volume and volume types, refer to
1.2 “Volume Types”.
-file file_name To specify multiple volumes, describe the volumes in
file_name.
For the description format of file_name, refer to 1.3
“Replication Operation Fil e”.
When multiple volumes are specified, if an error occurs in
some volumes, an error message indicatin g that is displayed,
and the process is continued until it is terminated in all the
specified volumes.
-? Displays the usage of this command (Windows).
-help Displays the usage of this command (UNIX).
Page 84
Chapter 2 Command Reference
79
[ DISPLAYED INFORMATION ]
On the Windows system
C:\>iSMrc_sense -vol ld-name -volflg dskn
Disk No. disk_number
LD Name ld_name
VAA VAA
Type type
Volume Name volume_name
Path path
C:\>
Description of messages:
• Disk No. Physical disk number
• LD NAME Logical disk name
• VAA Volume Absolute Address
• Type OS type
• Volume Name Mount point volume name
• Path Drive letters mounted on the NTFS volume folder accessed by users
On the UNIX system
Volume information is displayed.
# iSMrc_sense -vol special_file_name -volflg sfn
Special file LD NAME VAA Type
special_file_name ld name VAA type
#
Description of messages:
Special file Special file name
LD NAME Logical disk name
VAA Volume Absolute Address
Type OS type
Page 85
Chapter 2 Command Reference
80
[ USAGE ]
On the Windows system
The command displays volume name information.
C:\>iSMrc_sense -vol rpl302_7 -volflg ld
Disk No. 21
LD Name rpl302_7
VAA 30000000000000020302
Type NX
Volume Name \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
Path R:
C:\>
On the UNIX system
Volume name information is displayed.
# iSMrc_sense -vol /dev/rdsk/c5t2d0 -volflg sfn
Special file LDNAME VAA Type
/dev/rdsk/c5t2d0 disk001 30000000000000020010 NX
#
[ NOTES ]
The following notes apply to the case when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).
• The target volume is registered in the Volume List.
• Specifying volume of a dynamic disk is not allowed.
• A Volume List is not being created.
• To specify a volume group, the target volume group must be active.
• To specify a disk group, the target disk group must be active.
• Th e iSM special file is not being created (the UNIX system HP-UX version only).
[ RETURN VALUE ]
0: Operation for all the paired volumes terminated normally.
1: Operation for all the paired volumes terminated abnormally.
2: Operation for some paired volumes terminated abnormally.
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• The in struction fails due to a disk array error.
Page 86
Chapter 2 Command Reference
81
2
2
2
.
.
.
3
3
3
D
D
D
i
i
i
s
s
s
k
k
k
O
O
O
p
p
p
e
e
e
r
r
r
a
a
a
t
t
t
i
i
i
o
o
o
n
n
n
s
s
s
2
2
2
.
.
.
3
3
3
.
.
.
1
1
1
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
f
f
f
l
l
l
u
u
u
s
s
s
h
h
h
[ NAME ]
iSMrc_flush - Flushes the file system buffer.
[ SYNOPSIS ]
iSMrc_flush -drv drive:
iSMrc_flush -mvol volume_name
iSMrc_flush -mdir path_name
iSMrc_flush -?
[ DESCRIPTION ]
The iSMrc_flush command requests flushing the unwritten buffer data of specified
drive/mount point volume/NTFS folder onto disk.
For writing data completely, execution and normal termination of iSMrc_umount is required.
If iSMrc_umount results in an error on server with MV connected, waiting for delayed
updating of file system for approx. 60 seconds after execution of iSMrc_flush, and then
executing iSMrc_separate allows reflection of almost all updating onto disk. In this case,
use the commands after mounting on RV and restoring the file system with CHKDSK /F.
OPTIONS
The iSMrc_flush command recognizes the following options and arguments.
-drv drive: Specify the name of the drive to be flushed.
-mvol volume_name Specify the name of the mount point volume to be flushed.
-mdir path_name Specify the name of the NTFS folder to be flushed.
-? Displays the usage of this command.
Page 87
Chapter 2 Command Reference
82
[ DISPLAYED INFORMATION ]
C:\>iSMrc_flush -drv drive-name
Flush Start YYYY/MM/DD hh:mm:ss
disk_number ld_name type
volume name
path
Flush Normal End YYYY/MM/DD hh:mm:ss
disk_number ld_name type
volume name
path
C:\>
Description of messag e :
• Flush Start YYYY/MM/DD hh:mm:ss
File system flush unmount starting message and Start Time
• disk_number ld_name type
volume name
path
Physical disk number, logical disk name, OS type, mount point volume name, and drive
letters accessed by users or path name of the NTFS folder.
• Flush Normal End YYYY/MM/DD hh:mm:ss
File system flush end messag e and end time
[ USAGE ]
The command flushes the volume with the physical disk number 4 and drive letter “R”:
C:\>MOUNTVOL R: /D
C:\>iSMrc_flush -mvol \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
Flush Start 2001/02/06 20:32:43
disk4 rpl302_7 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
R:
Flush Normal End 2001/02/06 20:32:43
disk4 rpl302_7 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
R:
C:\>
Page 88
Chapter 2 Command Reference
83
[ NOTES ]
• Th e operation target volume must have been registered in th e Volume List.
• The operation target volume must be available for Read/Write.
• Specifying volume of a dynamic disk is not allowed.
• The drive of the specified name must be mounted.
• This command flushes only the Windows file system. Therefore, it cannot flush the data of an
application which processes its own cache. To flush the data from the applicatio n to the disk,
flush the data of the application first, and then use this command to flush the file system.
[ RETURN VALUE ]
0: Normal termination
1: Abnormal termination
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• If the system function (Win32API) fails.
Page 89
Chapter 2 Command Reference
84
2
2
2
.
.
.
3
3
3
.
.
.
2
2
2
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
m
m
m
o
o
o
u
u
u
n
n
n
t
t
t
[ NAME ]
iSMrc_mount - Mounts volumes.
[ SYNOPSIS ]
iSMrc_mount -drv drive:
iSMrc_mount -mvol volume_name
iSMrc_mount -mdir path_name
iSMrc_mount -?
[ DESCRIPTION ]
The iSMrc_mount command mounts the specified drive, mount point volume, or NTFS folder
to the Windows system.
OPTIONS
The iSMrc_mount command recognizes the following options and arguments.
-drv drive: Specify the name of the drive to be mounted.
-mvol volume_name Specify the name of the mount point volume to be mounted.
-mdir path_name Specify the name of the NTFS folder to be mounted.
-? Displays the usage of this command.
[ DISPLAYED INFORMATION ]
C:\>iSMrc_mount -drv drive:
Mount Start YYYY/MM/DD hh:mm:ss
disk_number ld_name type
volume name
path
Mount Normal End YYYY/MM/DD hh:mm:ss
disk_number ld_name type
volume name
path
C:\>
Page 90
Chapter 2 Command Reference
85
Description of messag e :
• Mount Start YYYY/MM/DD hh:mm:ss
Physical disk mount starting message and Start Time
• disk_number ld_name type
volume name
path
Physical disk number, logical disk name, OS type, mount point volume name, and
drive letters accessed by users or path name of the NTFS folder.
• Mount Normal End YYYY/MM/DD hh:mm:ss
Physical disk mount end message and end time
[ USAGE ]
The command mounts the volume with the drive name “R”:
C:\>MOUNTVOL R: \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
C:\>iSMrc_mount -drv R:
Mount Start 2001/02/06 20:32:43
disk4 rpl302_7 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
R:
Mount Normal End 2001/02/06 20:32:43
disk4 rpl302_7 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
R:
C:\>
[ NOTES ]
• The target volume is registered in the Volume List.
• The operation target volume must be available for Read/Write.
• Specifying volume of a dynamic disk is not allowed.
• Th e specified drive name must have been assigned as a drive letter.
• The operations regarding the retry function can be specified in the replication operation option
setting file (iSMrpl.ini). For details of the setting, refer to 3.1 “Replication Operation Option
Setting File”.
[ RETURN VALUE ]
0: Normal termination
1: Abnormal termination
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• If the system function (Win32API) fails.
Page 91
Chapter 2 Command Reference
86
2
2
2
.
.
.
3
3
3
.
.
.
3
3
3
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
u
u
u
m
m
m
o
o
o
u
u
u
n
n
n
t
t
t
[ NAME ]
iSMrc_umount - Unmounts volumes.
[ SYNOPSIS ]
iSMrc_umount -drv drive:[-force]
iSMrc_umount -mvol volume_name [-force]
iSMrc_umount -mdir path_name [-force]
iSMrc_umount -?
[ DESCRIPTION ]
The iSMrc_umount command unmounts the specified drive, mount point volume, or NTFS
folder from the Windows file system.
The operation reflects cache data of file system onto disk device. After unmounting, data on disk
becomes valid.
Although the unmounted volume can be mounted explicitly with iSMrc_mount, accessing to an
unmounted volume via file system results in automatic mounting by Windows.
In this case, automatic mounting can be blocked by forcibly deleting drive letters by using the
MOUNTVOL command.
OPTIONS
The iSMrc_umount command recognizes the following options and arguments.
-drv drive: Specify the name of the drive to be unmounted.
-mvol volume_name Specify the name of the mount point volume to be unmounted.
-mdir path_name Specify the name of the NTFS folder to be unmounted.
-force Unmount a target drive/mount point volume/NTFS folder
forcibly without locking.
-? Displays the usage of this command.
[ DISPLAYED INFORMATION ]
C:\>iSMrc_umount -drv drive-name
Umount Start YYYY/MM/DD hh:mm:ss
disk_number ld_name type
volume name
path
Umount Normal End YYYY/MM/DD hh:mm:ss
disk_number ld_name type
volume name
path
C:\>
Page 92
Chapter 2 Command Reference
87
Description of messag e :
• Umount Start YYYY/MM/DD hh:mm:ss
Physical disk (drive) unmount starting message and Start Time
• disk_number ld_name type
volume name
path
Physical disk number, logical disk name, OS type, mount point volume name, and drive letters
accessed by users or path name of the NTFS folder.
• Umount Normal End YYYY/MM/DD hh:mm:ss
Physical disk (drive) unmount end message and end time
[ USAGE ]
The command unmounts the volume with the physical disk number 4 and drive name “R”:.
C:\>iSMrc_umount -drv R:
Flush Start 2001/02/06 20:32:43
disk4 rpl302_7 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
R:
Flush Normal End 2001/02/06 20:32:43
disk4 rpl302_7 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
R:
C:\>iSMrc_umount -mvol \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
Umount Start 2001/02/06 20:32:43
disk4 rpl302_7 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
R:
Umount Normal End 2001/02/06 20:32:43
disk4 rpl302_7 WN
\\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\
R:
C:\>
[ NOTES ]
• The target volume is registered in the Volume List.
• The operation target volume must be available for Read/Write.
• Specifying volume of a dynamic disk is not allowed.
• If the drive to be unmounted is used by another application, the iSMrc_umount command
results in an error. The iSMrc_umount command provides the retry function for unmount.
• The operations regarding the retry function can be specified in the replication operation option
setting file (iSMrpl.ini). For details of the setting, refer to 3.1 “Replication Operation Option
Setting File”.
Page 93
Chapter 2 Command Reference
88
[ RETURN VALUE ]
0: Normal termination
1: Abnormal termination
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• If the system function (Win32API) fails.
• Other program is referring to or updating the volume concerned.
Executing the CHKDSK command with the /F /X specification enables reference and update by
other programs to be forcibly cancelled.
Page 94
Chapter 2 Command Reference
89
2
2
2
.
.
.
3
3
3
.
.
.
4
4
4
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
s
s
s
i
i
i
g
g
g
n
n
n
a
a
a
t
t
t
u
u
u
r
r
r
e
e
e
[ NAME ]
iSMrc_signature - Operations regarding disk signature.
[ SYNOPSIS ]
iSMrc_signature {-read | -set | -del | -init | -list} {-dskn disk_number
| -all}
iSMrc_signature {-export | -import} file_name {-dskn disk_number |
-all}
iSMrc_signature -?
[ DESCRIPTION ]
The iSMrc_signature command performs save, restoration, deletion, initialization, and
display of disk signature. It also writes the disk signature information to a file or reads it from a
file.
OPTIONS
The iSMrc_signature command recognizes the following options and arguments.
-read Saves the signature of the physical disk currently
recognized by Windows. If -all is specified, all
signature information is saved. If disk_number is
specified, only the signatures of the target physical disks
are saved.
Saved signatures are recorded in the signature map file
managed by the iSMrc_signature command.
-set Recovers the di sk signatures saved in the map file by
-read to the disk. If -all is specified, all signature
information saved is recovered to the physical disk. If
disk_number is specified, only the signatures of the
target physical disks are recover ed.
-del Deletes the disk signatures saved in the map file by
-read. If -all is specified, signature in fo rmation of
all disks is deleted. If disk_number is specified, only
the signatures of the target physical disks are deleted.
Page 95
Chapter 2 Command Reference
90
-init Initializes the signature on the physical disk. If -all is
specified, signature information of all disks is initialized.
If disk_number is specified, only the signatures of the
target physical disks are initialized.
-list Displays the list of disk signatures saved by -read,
signatures on the physical disk, and signatures saved in
the disk array. If -all is specified, signature
information of all disks is displayed. If disk_number
is specified, only the sign atures of the target physical
disks are displayed.
-export Writes the disk signature information to the specified file.
If -all is specified, signature i nformation of all disks is
written to the file. If disk_number is specified, only
the signatures of the target physical disks are written to
the file.
-import Reads the disk signature information recorded in the
specified file from the file and registers it. If -all is
specified, signature in fo rmation of all disks is read from
the file and registered. If disk_number is specified,
only the signatures of th e target physical disks are read
from the file and registered.
file_name Specify the file name to which the disk signature
information is written, or from which it is read.
-dskn disk_number Specify the disk number of the physical disk to which the
disk signature operation is performed.
-all Performs the disk signature operation for all the physical
disks connected to the host.
-? Displays the usage of this command.
Page 96
Chapter 2 Command Reference
91
[ NOTES ]
• The value of the disk signature reported by means of the iSMrc_signature command may
seem to be different from the value of the disk signature reported by means of Windows or
other disk management tools because the byte order is handled differently.
Therefore, pay special attention when using the value of the disk signature displayed or saved
by the iSMrc_signature command for another disk management tool.
[ RETURN VALUE ]
0: Normal termination
1: Abnormal termination
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• If the system function (Win32API) fails.
Page 97
Chapter 2 Command Reference
92
2
2
2
.
.
.
3
3
3
.
.
.
5
5
5
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
s
s
s
c
c
c
a
a
a
n
n
n
[ NAME ]
iSMrc_scan - Device scan.
[ SYNOPSIS ]
iSMrc_scan
iSMrc_scan -?
[ DESCRIPTION ]
The iSMrc_scan command scans devices and let the system recognize the availabl e devices.
OPTIONS
The iSMrc_scan command recognizes the following option:
-? Displays the usage of this command.
[ RETURN VALUE ]
0: Normal termination
1: Abnormal termination
[ ERRORS ]
This command terminates abnormally in the following cases.
• A parameter is invalid.
• If the system function (configuration manager API) fails.
Page 98
Chapter 2 Command Reference
93
2
2
2
.
.
.
4
4
4
P
P
P
a
a
a
i
i
i
r
r
r
O
O
O
p
p
p
e
e
e
r
r
r
a
a
a
t
t
t
i
i
i
o
o
o
n
n
n
s
s
s
2
2
2
.
.
.
4
4
4
.
.
.
1
1
1
i
i
i
S
S
S
M
M
M
r
r
r
c
c
c
_
_
_
l
l
l
d
d
d
l
l
l
i
i
i
s
s
s
t
t
t
[ NAME ]
iSMrc_ldlist - Displays logical disks and related information.
[ SYNOPSIS ]
iSMrc_ldlist -a
iSMrc_ldlist -d
iSMrc_ldlist -de disk_name [ld_name]
iSMrc_ldlist -cr
iSMrc_ldlist -?
iSMrc_ldlist –help
[ DESCRIPTION ]
The iSMrc_ldlist command displays logical disks and related information.
OPTIONS
The iSMrc_ldlist command recognizes the following options and arguments.
-a Displays information of the logical disks stored in all disk
arrays.
-d Displays the list of disk arrays and indicates whether or not
the system recognizes the disk arrays as target systems.
-de disk_array [ld_name] Displays information of the logical disks stored in the disk
array specified by disk_array. If ld_name is
specified, only information of the specified logical disk
name is displayed.
When the system directly contro ls the I/O issuance to disk
arrays (joint operation with the replication management is
not performed), it is not possible to display information of
disk arrays that are not directly recognized by the system.
For information about the setting of the I/O issuance control,
refer to Chapter 3 “Operation Settings”.
Page 99
Chapter 2 Command Reference
94
-cr Updates the latest information by re-obtaining information
of disk arrays and logical disks that are connected to the
system. This option can be used only when the replication
management (controlling the issuance of I/O to disk arrays
via the NEC Storage Manager) is simultaneously conducted.
For the setting of the I/O issuance control, refer to Chapter 3
“Operation Settings”.
-? Displays the usage of this command (Windows).
-help Displays the usage of this command (UNIX).
[ DISPLAYED INFORMATION ]
(1) The relations for all the disk arrays are displayed.
On the Windows system
C:\> iSMrc_ldlist –a
Receiving…
-------------------------------------------------------------------------------------------------------[Disk Array Name](Management)
LDN OS Type LD Name Attribute Capacity
--------------------------------------------------------------------------------------------------------[disk_array_name](management)
ldn type ld_name attribute capacity
C:\>
On the UNIX system
# iSMrc_ldlist –a
Receiving ...
-------------------------------------------------------------[Disk Array Name](Management)
LDN OS Type LD Name Attribute Capacity
-------------------------------------------------------------[disk_array_name](management)
ldn type ld_name attribute capacity
#
Page 100
Chapter 2 Command Reference
95
Description of messages:
• Receiving...... Data is being received.
During the joint operation with the replication
management, this message is displayed until the data
reception is completed. Th e display of this message
can be suppressed by setting an option. For details of
the option setting, refer to 3.1 “Replication Operation
Option Setting File” for the Windows system and
Section 3.2 “Environment Variables” for the UNIX
system.
• disk_array_name Disk array name
• management Indicates whether or not the system directly recognizes
disk arrays.
direct The system recognizes the target di sk
array.
indirect The system does not recognize the
target disk array.
• ldn Logical disk number
• type OS type
• ld_name Logical disk name
• attribute Logical disk att ribute
IV Unpaired logical disk
MV MV logical disk
RV RV logical disk
RV/MV Logical disks specified as both MV
and RV
• capacity Displays the logical disk capacity to one decimal
place. To display the capacity, the unit
(Bytes/KB/MB/GB/TB/PB/EB) is added.
(2) The list of disk arrays is displayed.
On the Windows system
C:\> iSMrc_ldlist –d
Receiving…
--------------------------------------------------------------------------------------------------------Disk Array Name Management
--------------------------------------------------------------------------------------------------------disk_array_name management
C:\>
Loading...