Top
ETERNUS SF AdvancedCopy Manager V16.1 Operation Guide
FUJITSU Storage

13.1.2 Operation Commands

This section describes operation commands for backup management.

13.1.2.1 swstbackup (Backup Execution Command)

NAME

swstbackup - backup

SYNOPSIS

Executing Backup by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstbackup [-suspend|-T] [-k] Device-Name [-Xdevmap Device-Map-File] [-Xflush]
To Execute on Management Server
<program-directory>\bin\swstbackup [-h Server-Name] [-suspend|-T] [-k] Device-Name [-Xdevmap Device-Map-File] [-Xflush]
Executing Backup by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swstbackup -n [-suspend|-T] [-k] Log-Group-Name[/RDB-Name] [-Xdevmap Device-Map-File]
To Execute on Management Server
<program-directory>\bin\swstbackup -n [-h Server-Name] [-k] [-suspend|-T] Log-Group-Name[/RDB-Name] [-Xdevmap Device-Map-File]

DESCRIPTION

When using this command, the operation changes according to different states of the Advanced Copy that is being executed.

In the above cases, a backup is established, and access to the backup volume is available immediately after the execution command.

AdvancedCopy Manager executes backup pre-processing and post-processing scripts before and after backup.

For information on customizing these scripts, refer to "Appendix A Pre-processing and Post-processing of Backup and Restoration".

AdvancedCopy Manager deletes the oldest backup history information automatically at the time of backup execution, if it has reached the maximum number of preservation generations (*1).

(*1) This configured in the swstbkpolset command.

In the case of MSCS or WSFC operation, this command performs automatic configuration of the maintenance mode of the physical disk resources to which the volume belongs with pre- and post-processing. For more information, refer to "14.1.6.1 When Using MSCS or WSFC for Cluster Operation".

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-k

Specifies implementation of backup with reference dump.
If you omit this option, backup will be implemented with normal dump.

When you back up with reference dump, you have to execute Symfoware's "rdbrtr" command in order to set inhibition of updates (disable writing of data) for all DSI (function that expresses the storage structures for tables) on the transaction volumes to be backed up.
It cannot specify this option for the transaction volumes other than Symfoware.

-n

Specifies that the item being backed up is a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

-Xdevmap Device-Map-File

Specifies a target backup volume to perform the snapshot fast backup. In the operand, specify a "device map file" in which a combination of a transaction volume and a target backup volume are described. If this option is not specified, the target backup volume will be automatically selected by the backup function. To execute this command on a remote basis using the -h option, specify a device map file (of a Managed Server) using an absolute pathname. A file name specified in Device-Map-File must not include any national character.

-Xflush

Specifies the flushing of the file system buffer of the transaction volume. Before this option is specified, all write processing on the transaction volume must be stopped. During a backup process where the write processing is not stopped, the reliability of the transaction volume data is not guaranteed.
When this option is omitted, the flushing of file system buffer of the transaction volume and locking of the transaction volume are based on the value of 'BufferFlushOnly' in the transaction volume locking specification file for backups. For details, refer to "A.2.3 Transaction Volume Locking Specification File for Backups".
When the Symfoware database space is built on the filesystem, the file system buffer is flushed regardless of the specifying of this option.

-suspend

This results in synchronous high-speed backup using the "Chapter 5 Backup Operation Using Suspend/Resume Function".

-T

Specifies that the differential snapshot high-speed backup be executed.
This option cannot be specified during synchronous processing.
This option is valid only for copying within a box when the ETERNUS Disk storage system supports the QuickOPC function.
If this option is not specified, ordinary snapshot processing (ie, OPC without using the QuickOPC function) is started. This option must always be specified to perform a backup operation using differential snapshots.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.2 swstbackstat (Backup Execution Status Display Command)

NAME

swstbackstat - displays the completion status of a backup

SYNOPSIS

Displaying Backup Execution Status by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstbackstat [Device-Name]
To Execute on Management Server
<program-directory>\bin\swstbackstat [-h Server-Name] [Device-Name]
Displaying Backup Execution Status by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swstbackstat -n Log-Group-Name[/RDB-Name]
To Execute on Management Server
<program-directory>\bin\swstbackstat -n [-h Server-Name] Log-Group-Name[/RDB-Name]

DESCRIPTION

This command displays the completion status of a backup that is being performed using the swstbackup command.

The following information will be displayed:

Title

Description

Server

Displays a Managed Server name.

Transaction-Disk

Displays the AdvancedCopy Manager device name of a transaction volume.

Backup-Disk

Displays a backup volume name.

If no backup has been collected, "----" will be displayed.

Status

Displays a backup completion status using one of the following character strings:

"----" : No backup has been collected (ie, no history exists).
"succeeded" : Backup has been completed.
"executing" : Copying using OPC is in progress.
"failed" : Copying using OPC has been interrupted due to an error.
"halt" : Copying using OPC is halt status.
"?????" : Failed to get copy status.

Execute

Displays how much has been copied in percentage terms if "executing" is displayed in the Status column. Displays "----" unless "executing" is displayed.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-n

Specifies that the item being displayed is a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

OPERANDS

Device-Name

Specifies the "1.4 Managing Device on AdvancedCopy Manager" corresponding to a transaction volume.
If this operand is omitted, the backup execution statuses of all the transaction volumes will be displayed.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.3 swstrestore (Restore Execution Command)

NAME

swstrestore - restore

SYNOPSIS

For Restore of Regular Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstrestore [-g Generation-No | -v Version-No] [-r Restore-Device-Name] Device-Name
To Execute on Management Server
<program-directory>\bin\swstrestore [-h Server-Name] [-g Generation-No | -v Version-No][-r Restore-Device-Name] Device-Name
For Recover of Symfoware Database Space by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstrestore [-g Generation-No | -v Version-No] [-l ArchiveLogFileList-FileName] [-w Work-Directory] [-nolog Work-RecCtrlFile-Directory] Device-Name
To Execute on Management Server
<program-directory>\bin\swstrestore [-h Server-Name] [-g Generation-No | -v Version-No] [-l ArchiveLogFileList-FileName] [-w Work-Directory] [-nolog Work-RecCtrlFile-Directory] Device-Name
For Bundle Recovery by Specifying Multiple Transaction Volumes
To Execute on Managed Server
<program-directory>\bin\swstrestore -bundle [-g Generation-No | -v Version-No] [-a | -e EndPoint] [-l ArchiveLogFileList-FileName] [-w Work-Directory] [-nolog Work-RecCtrlFile-Directory] DeviceListFile
To Execute on Management Server
<program-directory>\bin\swstrestore -bundle [-h Server-Name] [-g Generation-No | -v Version-No] [-a | -e EndPoint] [-l ArchiveLogFileList-FileName] [-w Work-Directory] [-nolog Work-RecCtrlFile-Directory] DeviceListFile
For Recovery of Symfoware Database Space by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swstrestore -n [-g Generation-No | -v Version-No] [-a | -e EndPoint] [-l ArchiveLogFileList-FileName] [-w Work-Directory] [-nolog Work-RecCtrlFile-Directory] Log-Group-Name[/RDB-Name]
To Execute on Management Server
<program-directory>\bin\swstrestore -n [-h Server-Name] [-g Generation-No | -v Version-No] [-a | -e EndPoint] [-l ArchiveLogFileList-FileName] [-w Work-Directory] [-nolog Work-RecCtrlFile-Directory] Log-Group-Name[/RDB-Name]

DESCRIPTION

The data that exists in backup history information is restored using OPC.
When this command is executed, AdvancedCopy Manager performs the restoration pre-processing and post-processing scripts before and after copying data using OPC. For more information on customizing these scripts, refer to "Appendix A Pre-processing and Post-processing of Backup and Restoration".

You can restore data to a device that is not a transaction volume. When you do so, the device must not be registered as a transaction volume and the device must have the same amount of space available as the specified transaction volume.

For transaction volumes of Symfoware, restoring to devices other than the original transaction volumes is not available.

During recovery of database spaces, access to the relevant database spaces must not be permitted. In order to prohibit access, execute the "rdbinh" command provided by Symfoware. For details on these commands, refer to the Symfoware Server RDB Operations Guide.

If recovery of a database space fails due to insufficient space in the working directory, you can use the -w option to retry recovery temporarily specifying a different directory.

In the case of MSCS or WSFC operation, this command performs automatic configuration of the maintenance mode of the physical disk resources to which the volume belongs with pre- and post-processing. For more information, refer to "14.1.6.1 When Using MSCS or WSFC for Cluster Operation".

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-g Generation-No

Specifies the relative generation number of data to be restored.
Check the relative generation number using the swsthistdisp command.

-v Version-No

Specifies the absolute generation number of data to be restored.
Check the absolute generation number using the swsthistdisp command.

-r Restore-Device-Name

Specifies a restore destination device name to restore data to any device other than a transaction volume.

Cannot be specified for a Symfoware transaction volume.

-a

Specifies that the entire database resources managed by a recovery control file shall be recovered up to the point in time of backup collection.
Cannot be specified at the same time as the -e option.
Cannot be specified when recovering individual transaction volumes in a log group.
Cannot be specified for the transaction volumes other than Symfoware.

-e EndPoint

Specifies that the entire database resources managed by a recovery control file shall be recovered up to a specific recovery point. For details on recovery points, refer to the Symfoware Server manuals.
Cannot be specified at the same time as the -a option.
Cannot be specified at the same time as the -nolog option.
Cannot be specified when recovering individual transaction volumes in a log group.
Cannot be specified for the transaction volumes other than Symfoware.

-l ArchiveLogFileList-FileName

Specifies the absolute path of the file stating the names of the backup locations for the archive logs that are required for recovery of Symfoware.
The file stating the name of the backup locations for the archive logs must be stored on the Managed Server that contains the transaction volumes to be restored.
If you execute this command on a Management Server, the file must be stored on the Managed Server that contains the transaction volumes to be restored.
Cannot be specified at the same time as the -nolog option.
Cannot be specified for the transaction volumes other than Symfoware.

-w Work-Directory

Specifies the absolute path to the name of a temporary working directory.
The directory must be located on the Managed Server that contains the transaction volumes to be restored.
If you execute this command on a Management Server, the directory must be located on the Managed Server that contains the transaction volumes to be recovered.
If this option is omitted, the working directory specified in the swstsvrset command will be used.
Cannot be specified for the transaction volumes other than Symfoware.

-n

Specifies that the item being restored is a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

-bundle

Specifies bundle recovery of multiple database spaces.
In the operand, specify the file (DeviceListFile) stating the device names corresponding with the database spaces to be recovered in a batch.

-nolog Work-RecCtrlFile-Directory

During recovery of Symfoware, archive logs are not applied.
If you want to specify an output directory for the recovery control files that are required when applying the log, and then apply the log by Symfoware's "rdbmrrcv" command, you can specify this directory.
If you perform recovery with this option specified, the database will not be available for use until you apply the log with Symfoware's "rdbmrrcv" command.

Note: If neither the -g or -v option is specified, the latest information from the information history management will be restored.

OPERANDS

Device-Name

Specifies the AdvancedCopy Manager device name corresponding to a transaction volume.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

DeviceListFile

Specify the device list file that states the device names corresponding with the database spaces to be recovered in a batch.
If you execute this command on a Management Server, this file must be stored on the Managed Server that contains the transaction volumes to be recovered.
For information on how to describe device list files, refer to "4.1.5.3.1 Describing Device List File".

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.4 swstcancelrest (Restore Cancellation Command)

NAME

swstcancelrest - cancels OPC-based restoration

SYNOPSIS

Canceling Restore by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstcancelrest [-g Generation-No | -v Version-No] [-r Restore-Device-Name] [-emergency] Device-Name
To Execute on Management Server
<program-directory>\bin\swstcancelrest [-h Server-Name][-g Generation-No | -v Version-No][-r Restore-Device-Name] [-emergency] Device-Name
Canceling Restore by Specifying Log Group (Symfoware)
To Execute on Managed Server
<program-directory>\bin\swstcancelrest -n [-g Generation-No | -v Version-No ] [-emergency] Log-Group-Name[/RDB-Name]
To Execute on Management Server
<program-directory>\bin\swstcancelrest -n [-h Server-Name] [-g Generation-No | -v Version-No ] [-emergency] Log-Group-Name[/RDB-Name]

DESCRIPTION

This command cancels OPC-based restoration.

A hardware error will be displayed when the swstrestore command is executed while data is being copied using OPC. Fix the cause of the hardware error and repeat restoration using the swstrestore command.

Check whether a fault occurred using the swstreststat command.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-g Generation-No

Specifies the relative generation number of data being restored.
This option cannot be specified at the same time as the -v option.
Check the relative generation number using the swstreststat command.

-v Version-No

Specifies the absolute generation number of data being restored.
This option cannot be specified at the same time as the -g option.
Check the absolute generation number using the swstreststat command.

-r Restore-Device-Name

Specifies the device name if data is restored to any other device than a transaction volume.
Check the device name using the swstreststat command.

It cannot specify this option for the transaction volumes of Symfoware.

-emergency

Emergency operation mode is available for operations.
In such cases, OPC sessions are neither confirmed nor cancelled.

-n

Specifies that the restore is being cancelled for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

Note: The restoration of the latest history information will be cancelled if neither the -g or -v option is specified.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.5 swstreststat (Restore Execution Status Display Command)

NAME

swstreststat - displays the execution status of restoration

SYNOPSIS

Displaying Restore Execution Status by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstreststat [-g Generation-No | -v Version-No] [Device-Name]
To Execute on Management Server
<program-directory>\bin\swstreststat [-h Server-Name] [-g Generation-No | -v Version-No] [Device-Name]
Displaying Restore Execution Status by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swstreststat -n [-g Generation-No | -v Version-No]  Log-Group-Name[/RDB-Name]
To Execute on Management Server
<program-directory>\bin\swstreststat -n [-h Server-Name] [-g Generation-No | -v Version-No]  Log-Group-Name[/RDB-Name]

DESCRIPTION

This command displays the execution status of restoration.
The following information will be displayed:

Title

Description

Server

Displays a Managed Server name.

Transaction-Disk

Displays the AdvancedCopy Manager device name of a transaction volume.

Generation

Displays the relative generation number of restored backup data.

"----" will be displayed if no generation number is specified in the -g or -v option and no backup history exists.

Version

Displays the absolute generation number of restored backup data.

"----" will be displayed if no generation number is specified in the -g or -v option and no backup history exists.

Backup-Disk

Displays the name of a backup volume from which data should be copied and restored.

"----" will be displayed if restoration is not in progress.

Restore-Device

Displays a restoration target device name unless data is copied and restored to a transaction volume.

"----" will be displayed if restoration is not in progress, or if data is restored to a transaction volume.

Status

Displays the execution status:

"----" : No copying using OPC is in progress.
"executing" : Copying using OPC is in progress.
"succeeded" : Copying using OPC has been completed.
"failed" : Copying using OPC has been interrupted due to an error.
"halt" : Copying using OPC is halt status.
"?????" : Failed to get copy status.

Execute

Displays how much has been copied in percentage terms if "executing" is displayed in the Status column. Displays "----" unless "executing" is displayed.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-g Generation-No

Specifies the relative generation number of data whose restore execution status is to be displayed.

-v Version-No

Specifies the absolute generation number of data whose restore execution status is to be displayed.

-n

Specifies that the execution status of restoration being displayed is for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

Note: The restore execution statuses of all the histories will be displayed if both the -g and -v options are omitted.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If this operand is omitted, the restore execution statuses of all the transaction volumes will be displayed.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.6 swsthistdisp (History Information Display Command)

NAME

swsthistdisp - displays the backup history information

SYNOPSIS

Displaying Backup History Information by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swsthistdisp [Device-Name]
To Execute on Management Server
<program-directory>\bin\swsthistdisp [-h Server-Name] [Device-Name]
Displaying Backup History Information by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swsthistdisp -n Log-Group-Name[/RDB-Name]
To Execute on Management Server
<program-directory>\bin\swsthistdisp -n [-h Server-Name] Log-Group-Name[/RDB-Name]

DESCRIPTION

This command displays history information in relation to data that has been backed up.

The following information will be displayed:

Title

Description

Server

Displays a Managed Server name.

Device

Displays the AdvancedCopy Manager device name.

Mount-Point

Displays the drive letter of a device. The file system type of the device is displayed inside the parentheses.

If the "Device" is a transaction volume used for Symfoware, the names of Symfoware database spaces and log groups as well as the RDB system names are displayed, followed by "SymfoWARE" in parentheses.

Generation

Displays a relative generation number.
This item will not be displayed if no backup history information exists.

Version

Displays an absolute generation number.
This item will not be displayed if no backup history information exists.

Backup-Date

Displays a TimeStamp reflecting when backup has been completed.
This item will not be displayed if no backup history information exists.

Backup-Disk

Displays the name of a backup volume to which data has been backed up.
This item will not be displayed if no backup history information exists.

Status

Displays an actual copying execution status using one of the following character strings:

"succeeded" : Copying using OPC has been completed.
"executing" : Copying using OPC is in progress.
"failed" : Copying using OPC has been interrupted due to an error.
"halt" : Copying using OPC is halt status.
"?????" : Failed to get copy status.

This item will not be displayed if no backup history information exists.

Execute

Displays how much has been copied in percentage terms if "executing" is displayed in the Status column. Displays "----" unless "executing" is displayed.
This item will not be displayed if no backup history information exists.

ArcSerial

Displays the serial number of the archive log.
The history information for backups performed by reference dump displays "reference".
Information other than for Symfoware transaction volumes is not displayed.
This item will not be displayed if no backup history information exists.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-n

Specifies that the backup history information being displayed is for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If this operand is omitted, the backup history information of all the transaction volumes will be displayed.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.7 swsthistdel (History Information Deletion Command)

NAME

swsthistdel - deletes backup history information

SYNOPSIS

Deleting Backup History Information by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swsthistdel -g Generation-No | -v Version-No | -z [-emergency] Device-Name
To Execute on Management Server
<program-directory>\bin\swsthistdel [-h Server-Name] -g Generation-No | -v Version-No | -z [-emergency] Device-Name
Deleting Backup History Information by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swsthistdel -n -g Generation-No | -v Version-No | -z [-emergency] Log-Group-Name[/RDB-NAME]
To Execute on Management Server
<program-directory>\bin\swsthistdel -n [-h Server-Name] -g Generation-No | -v Version-No | -z [-emergency] Log-Group-Name[/RDB-NAME]

DESCRIPTION

This command deletes backup history information.
The backup volume of the deleted history is released and becomes an empty backup volume.

When you delete the history information for Symfoware transaction volumes, the recovery control files will also be deleted.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-g Generation-No

Specifies the relative generation number of backup history information to be deleted.
This option cannot be specified at the same time as the -v or -z option.
Check the relative generation number using the swsthistdisp command.

-v Version-No

Specifies the absolute generation number of backup history information to be deleted.
This option cannot be specified at the same time as the -g or -z option.
Check the absolute generation number using the swsthistdisp command.

-z

Specifies that all the backup history information is to be deleted.
This option cannot be specified at the same time as the -g or -v option.

-emergency

Emergency operation mode is available for operations.
In such cases, OPC sessions are neither confirmed nor cancelled.

-n

Specifies that the backup history being deleted is for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.8 swststartsync (Backup Synchronous Processing Start Command)

NAME

swststartsync - starts backup synchronous processing

SYNOPSIS

Starting Backup Synchronous Processing by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swststartsync Device-Name [-Xdevmap Device-Map-File]
To Execute on Management Server
<program-directory>\bin\swststartsync [-h Server-Name] Device-Name [-Xdevmap Device-Map-File]
Starting Backup Synchronous Processing by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swststartsync -n Log-Group-Name[/RDB-NAME][-Xdevmap Device-Map-File]
To Execute on Management Server
<program-directory>\bin\swststartsync -n [-h Server-Name] Log-Group-Name[/RDB-NAME] [-Xdevmap Device-Map-File]

DESCRIPTION

This command starts backup synchronous processing (ie, it starts disk-to-disk copy using EC).

Even if it is already in use, the transaction volume where the synchronous processing started s well as the suspended backup volume can be used as backup destinations.

Except for the transaction volume where the synchronous processing started and the suspended backup volume, transaction volumes cannot be specified as backup destinations in the device map file.

If you execute this command with specifying a log group name, backup synchronous processing will be executed for all transaction volumes that are included in the specified log group. If execution of this command terminates with an error, backup synchronous processing that was performed so far will be cancelled. However, if the status was "suspend" before command execution, even after terminating with an error, synchronous processing will not be cancelled.
Also, you can run this command specifying individual transaction volumes that are included in a log group.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-Xdevmap Device-Map-File

Specifies a target backup volume to perform the backup synchronous processing. In the operand, specify a device map file in which a combination of a transaction volume and a target backup volume is described. If this option is not specified, a target backup volume will be automatically selected. To execute this command on a remote basis using the -h option, specify a device map file of a Managed Server using an absolute pathname. A file name specified in Device-Map-File must not include any national characters.

-n

Specifies that backup synchronous processing is being started for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.9 swstcancelsync (Backup Synchronous Processing Cancel Command)

NAME

swstcancelsync - cancels the backup synchronous processing

SYNOPSIS

Canceling Backup Synchronous Processing by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstcancelsync [-emergency] [-bd Backup-Device-Name | -all] Device-Name
To Execute on Management Server
<program-directory>\bin\swstcancelsync [-h Server-Name] [-emergency] [-bd Backup-Device-Name | -all] Device-Name
Canceling Backup Synchronous Processing by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swstcancelsync [-emergency] -n Log-Group-Name[/RDB-NAME] [-all]
To Execute on Management Server
<program-directory>\bin\swstcancelsync [-h Server-Name] [-emergency] -n Log-Group-Name[/RDB-NAME] [-all]

DESCRIPTION

The backup synchronous processing can be cancelled during copying by EC or under the equivalency maintained status.

The synchronous processing can be cancelled with the backup volume during copying by EC, under the equivalency maintained status, or while the Suspend state is set. Specifying cancellation of all of the synchronous processing cancels all of the backup synchronous processing including those in the Suspended state.

If the system detects an error while backup synchronous processing is being executed, copying in progress at that time terminates abnormally. In this case, use this command to cancel the backup synchronous processing. Use the swstsyncstat command to check for the error.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-emergency

Emergency operation mode is available for operations.
In such cases, EC sessions are neither confirmed nor cancelled.

-bd Backup-Device-Name

The synchronous processing on a specific backup volume can be cancelled.
Specify the copy destination backup volume name. In the operand, specify the AdvancedCopy Manager device name for the specified device.
Note that the backup volume name and the -all option cannot be specified together.

-all

All of the synchronous processing of the transaction volume can be specified to be cancelled. Note that this specification and the -bd option cannot be used together.

-n

Specifies that backup synchronous processing is being cancelled for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.10 swstsyncstat (Backup Synchronous Processing Progress Display Command)

NAME

swstsyncstat - displays the execution status of the backup synchronous processing

SYNOPSIS

Displaying Execution Status of Backup Synchronous Processing by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstsyncstat [Device-Name]
To Execute on Management Server
<program-directory>\bin\swstsyncstat [-h Server-Name] [Device-Name]
Displaying Execution Status of Backup Synchronous Processing by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swstsyncstat -n Log-Group-Name[/RDB-Name]
To Execute on Management Server
<program-directory>\bin\swstsyncstat -n [-h Server-Name] Log-Group-Name[/RDB-Name]

DESCRIPTION

The execution status of the backup synchronous processing is displayed (during copying, under the equivalency maintained status, or in the suspended status).
If one transaction volume has multiple EC sessions, then the statuses of all of these EC sessions are displayed.
The table below lists the meaning of each title.

Title

Description

Server

Displays the name of the Managed Server.

Transaction-Disk

Displays the AdvancedCopy Manager device name of a transaction volume.

Backup-Disk

Displays the name of the backup volume.
When backup synchronous processing is not being executed, the system displays "----".

Status

Displays the status of backup synchronous processing:

"----" : Backup synchronous processing is not being executed.
"executing" : Backup synchronous processing is being executed but equivalency maintained status has not been established.
"equivalent" : Equivalency maintained status is established.
"suspend" : Suspend status is established.
"failed" : Backup synchronous processing was abnormally terminated.
"nosession" : No session exists (eg, due to inconsistent resource information).
"halt" : Backup synchronous processing is halt status.
"?????" : Failed to get copy status.

Execute

Displays the progress of the backup synchronous processing as a percentage (0 to 100%).
"----" is displayed when the status is Suspend and at times when the backup synchronous processing is not running.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-n

Specifies that the execution status of backup synchronous processing being displayed is for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.
When you omit the device name, the system displays the status of backup synchronous processing for all of the transaction volumes.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.11 swstexecstat (Execution Status Display Command)

NAME

swstexecstat - displays the execution status of other commands executed

SYNOPSIS

Displaying Execution Status by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swstexecstat [-j] [Device-Name]
To Execute on Management Server
<program-directory>\bin\swstexecstat [-j] [-h Server-Name] [Device-Name]
Displaying Execution Status by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swstexecstat -n [-j] Log-Group-Name[/RDB-NAME]
To Execute on Management Server
<program-directory>\bin\swstexecstat -n [-h Server-Name] [-j] Log-Group-Name[/RDB-NAME]

DESCRIPTION

This command displays the execution status of other commands executed on a transaction volume. The execution status of OPC/EC will be displayed if OPC/EC is being executed.
The following information will be displayed:

Title

Description

Server

Displays a Managed Server name.

Device

Displays the AdvancedCopy Manager device name.

Last-Backup-Date

Displays the time when the last backup execution command was accepted.

Interval

Displays how many days have passed after the specified number of interval days since the last backup date has been exceeded. This item will be displayed as "DELAY=number-of-days-passing". "OK" will be displayed if the number of interval days has not been exceeded.

Status

Displays whether any of the following commands is being executed on a transaction volume. If so, "EXEC" will be displayed. Otherwise, "IDLE" will be displayed.

Mount-Point (Method)

Displays the drive letter of a device. The file system type of the device is displayed inside the parentheses.

If the "Device" is a transaction volume used for Symfoware, the names of Symfoware database spaces and log groups as well as the RDB system names are displayed, followed by "SymfoWARE" in parentheses.

Execute

Displays the name of the command being executed or the progress of copying.

"----" : Neither a command nor OPC/EC is being executed.
"swststartsync" : The backup synchronous processing start command is being processed.
"swstcancelsync" : The backup synchronous processing cancel command is being processed.
"swstbackup" : The backup execution command is being processed.
"swstrestore" : The restore execution command is being processed.
"swstcancelrest" : The restore cancellation command is being processed.
"swstbkpolset" : The backup policy setting command is being processed.
"swstbkpoldel" : The backup policy deletion command is being processed.
"swsthistdel" : The history information deletion command is being processed.
"swstcanceltrk" : The tracking cancel command is being processed.
"sync(xxx%)" : EC progress rate.
"sync(failed)" : EC ended abnormally.
"sync(halt)" : EC is halt status.
"snapshot(xxx%)" : The progress of OPC backup.
"snapshot(failed)" : OPC backup ended abnormally.
"snapshot(halt)" : OPC backup is halt status.
"restore(xxx%)" : The progress of restoration.
"restore(failed)" : OPC restoration ended abnormally.
"restore(halt)" : OPC restoration is halt status.
"?????" : Failed to get copy status.

During synchronous high-speed backup with -suspend specified, no operation ("----") is indicated in the Execute column.

If multiple processes are performed on transaction volumes (for example, when the backup synchronous processing start command is issued while a real copy of the snapshot backup is being handled), the display in the Execute column conforms to the following rules:

The following information will be displayed when -j option is specified:

Title

Description

Server

Displays a Managed Server name.

Device

Displays the AdvancedCopy Manager device name.

Execute-Date

Displays the command execution date and time (TimeStamp).

Status

Displays whether any of the following commands are being executed on a transaction volume. If so, "EXEC" will be displayed. Otherwise, "IDLE" will be displayed.

Mount-Point (Method)

Displays the drive letter of a device. The file system type of the device is displayed inside the parentheses.

If the "Device" is a transaction volume used for Symfoware, the names of Symfoware database spaces and log groups as well as the RDB system names are displayed, followed by "SymfoWARE" in parentheses.

Execute

Displays the name of the command being executed or the progress of copying.

"----" : Neither a command nor OPC/EC is being executed.
"swststartsync" : The backup synchronous processing start command is being processed.
"swstcancelsync" : The backup synchronous processing cancel command is being processed.
"swstbackup" : The backup execution command is being processed.
"swstrestore" : The restore execution command is being processed.
"swstcancelrest" : The restore cancellation command is being processed.
"swstbkpolset" : The backup policy setting command is being processed.
"swstbkpoldel" : The backup policy deletion command is being processed.
"swsthistdel" : The history information deletion command is being processed.
"swstcanceltrk" : The tracking cancel command is being processed.
"sync(xxx%)" : EC progress rate.
"sync(failed)" : EC ended abnormally.
"snapshot(xxx%)" : The progress of OPC backup.
"snapshot(failed)" : OPC backup ended abnormally.
"restore(xxx%)" : The progress of restoration.
"restore(failed)" : OPC restoration ended abnormally.
"restore(halt)" : OPC restoration is halt status.
"?????" : Failed to get copy status.

During synchronous high-speed backup with -suspend specified, no operation ("----") is indicated in the Execute column.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-j

Specifies to display information in another format.

-n

Specifies that the command execution status being displayed is for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

OPERANDS

Device-Name

Specifies the AdvancedCopy Manager device name corresponding to a transaction volume.
If this operand is omitted, the execution statuses of all the transaction volumes will be displayed.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.12 swstdrvset (Drive Letter Allocation Command)

NAME

swstdrvset - allocates a drive letter

SYNOPSIS

To Allocate Driver Letter
<program-directory>\bin\swstdrvset Device-Name [Drive-Letter]
To Allocate Mount Point
<program-directory>\bin\swstdrvset Device-Name Mount-Point

DESCRIPTION

Use this command if you need to temporarily allocate a drive letter or mount point to a device when, for example, you restore an individual file.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

Drive-Letter

Specifies a drive letter to be allocated to a device. Valid drive letters include "C:" to "Z:" The letters are not case-sensitive. If this operand is omitted, an unused drive letter will be automatically selected. Unused drive letters are searched starting from "Z:".

Mount-Point

Specifies a mount point to be allocated to a device.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.13 swstdrvunset (Drive Letter Deallocation Command)

NAME

swstdrvunset - cancels a drive letter

SYNOPSIS

To Deallocate Drive Letter
<program-directory>\bin\swstdrvunset {Device-Name | Drive-Letter}
To Deallocate Mount Point
<program-directory>\bin\swstdrvunset Mount-Point

DESCRIPTION

The drive letter or mount point currently assigned to the device is cancelled.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

Drive-Letter

Specifies a drive letter. Valid drive letters include "C:" to "Z:". The letters are not case sensitive.

Mount-Point

Specifies a mount point to be deallocated to a device.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.14 swstdismount (Dismount Command)

NAME

swstdismount - dismounts the specified volume

SYNOPSIS

<program-directory>\bin\swstdismount Device-Name

DESCRIPTION

This command dismounts the specified volume. When the volume is dismounted, all handles opened for the volume become invalid. The OS automatically remounts the dismounted volume when the volume is accessed.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.15 swstvolunlock (Volume Unlock Command)

NAME

swstvolunlock - unlocks a volume

SYNOPSIS

<program-directory>\bin\swstvolunlock [-n] Device-Name

DESCRIPTION

This command unlocks a volume.

OPTIONS

-n

Specifies that a device is not to be dismounted before it is unlocked.

OPERANDS

Device-Name

Specifies the name of an AdvancedCopy Manager device.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.16 swstvollockstat (Locked-volume Information Display Command)

NAME

swstvollockstat - displays information about a volume that has been locked

SYNOPSIS

<program-directory>\bin\swstvollockstat [Device-Name]

DESCRIPTION

This command displays volume information locked by AdvancedCopy Manager.
The following types of information are displayed:

Title

Description

ACM-Volume-Name

AdvancedCopy Manager device name

Lock-Start-Time

Time at which the device was locked.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If this operand is omitted, information about all volumes locked by AdvancedCopy Manager is displayed.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.17 swstcanceltrk (Tracking Cancel Command)

NAME

swstcanceltrk - stops tracking processing

SYNOPSIS

To Execute on Managed Server
<program-directory>\bin\swstcanceltrk [-copy | -emergency] Device-Name (-bd Backup-Device-Name | -all)
To Execute on Management Server
<program-directory>\bin\swstcanceltrk [-h Server-Name] [-copy | -emergency] Device-Name (-bd Backup-Device-Name | -all)

DESCRIPTION

This command stops tracking processing.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-copy

Specifies that physical copying, if active, should also be stopped (the OPC session should be cancelled).
This option cannot be specified for a backup volume that has already contained a backup history. For a volume whose copy destination volume has contained a backup history, delete the history information in advance using the swsthistdel command.

-emergency

Specifies that the command should operate in the emergency operation mode.
The command does not check tracking processing and does not stop tracking processing or the OPC session.

-bd Backup-Device-Name

Stops tracking processing for the specified backup volume. Specify the target backup volume name as an operand. This option cannot be specified at the same time as the -all option.

-all

Stops the entire tracking processing specified for the transaction volumes. This option cannot be specified at the same time as the -bd option.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES

13.1.2.18 swsttrkstat (Tracking Status Display Command)

NAME

swsttrkstat - displays the status of tracking processing

SYNOPSIS

Displaying Execution Status of Tracking by Specifying Transaction Volume
To Execute on Managed Server
<program-directory>\bin\swsttrkstat [Device-Name]
To Execute on Management Server
<program-directory>\bin\swsttrkstat [-h Server-Name] [Device-Name]
Displaying Execution Status of Tracking by Specifying Log Group
To Execute on Managed Server
<program-directory>\bin\swsttrkstat -n Log-Group-Name[/RDB-Name]
To Execute on Management Server
<program-directory>\bin\swsttrkstat -n [-h Server-Name] Log-Group-Name[/RDB-Name]

DESCRIPTION

This command displays the status of tracking processing.
When multiple types of synchronous processing are running on one transaction volume, the command displays the statuses of all types of tracking processing.
The displayed data is explained below.

Title

Description

Server

Displays a Managed Server name.

Transaction-Disk

Displays the AdvancedCopy Manager device name of a transaction volume.

Backup-Disk

Displays a backup volume name.

Displays "----" when the volume is not in the tracking status.

Status

Displays the execution status.

"----" : Not in the process of tracking
"executing" : In the process of physical copying and tracking
"tracking" : In the process of tracking
"failed" : Physical copying or tracking terminated abnormally
"nosession" : No session exists. (eg, resource information is inconsistent.)
"?????" : Failed to get copy status.

Execute

Displays the progress of copying as a percentage when "executing" is displayed in the Status column. "----" is displayed when "tracking" is displayed in the Status column.

Update

Displays the amount of updated data after logical copying as a percentage when "tracking" is displayed in the Status column. "----" is displayed when "executing" is displayed in the Status column.

OPTIONS

-h Server-Name

When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.

-n

Specifies that the execution status of tracking being displayed is for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.

OPERANDS

Device-Name

Specify an AdvancedCopy Manager device name.
Refer to "1.4 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If this operand is omitted, the command displays the statuses of tracking processing for all transaction volumes.

Log-Group-Name

Specify the name of the log group.

RDB-Name

Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

NOTES