12.2 Backup Management Commands

This section describes operations using Backup Management Commands

Note

Only a user belonging to the Administrators group can execute all the commands of backup management. When commands are executed by other users, the message "swst0601 This Command cannot be run because the user is not a root user." will be generated and then the command aborts.
Backup operations in Logical Units (disk units) are not supported. An error occurs if swstdevinfoset (Device information setting command) is used to specify a Logical Unit (disk).

Note

Operating environment for command execution

The table below lists the operating environment requirements for different commands.

Table 12.15 Operating environment for executing backup management commands
Command	Operating environment of AdvancedCopy Manager
swstbackstat	Windows services required by the Management Server and target Managed Server must be running in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swstbackup	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. When the Managed Server runs on Windows and is in EC operation, Windows services required by the Managed Server must be running.
swstbkpoldel	To execute this command on a Managed Server, Windows services required by the Management Server must be running. To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swstbkpoldisp	Windows services required by the Management Server and target Managed Server must be running in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swstbkpolset	To execute this command on a Managed Server, Windows services required by the Management Server must be running. To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swstcancelrest	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swstcancelsync	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. When the Managed Server runs on Windows and is in EC operation, Windows services required by the Managed Server must be running.
swstcanceltrk	When this command is executed with the -h option specified on the Management Server, tservices must be active.
swstdevdisp	Windows services required by the Management Server and target Managed Server must be running in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified To execute this command with the -o option specified, the daemons and services of the Management Server must be operating.
swstdevinfoset	To execute this command on a Managed Server, Windows services required by the Management Server must be running. To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swstexecstat	Windows services required by the Management Server and target Managed Server must be running in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swsthistdel	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swsthistdisp	Windows services required by the Management Server and target Managed Server must be running in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swstresback	-
swstresrst	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. When the Managed Server runs on Windows, Windows services required by the Managed Server must be running. To execute this command with the -x option specified, Windows services required by the Management Server must be running.
swstrestore	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swstreststat	Windows services required by the Management Server and target Managed Server must be running in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swstsrsemtch	Windows services required by the Management Server must be running. To execute this command on a Management Server with the -h option specified, Windows services required by the target Managed Server must be running. When the Managed Server runs on Windows, Windows services required by the Managed Server must be running.
swststartsync	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. When the Managed Server runs on Windows, Windows services required by the Managed Server must be running.
swstsvrdisp	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swstsvrset	To execute this command on a Managed Server, Windows services required by the Management Server must be running. To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swstsyncstat	Windows services required by the Management Server and target Managed Server must be running in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swsttrkstat	Windows services required by the Management Server and target Managed Server must be running in order to execute this command on a Management Server with either of the following parameter designations: -h option is specified No device name is specified
swstvolunlock	Windows services required by the Management Server must be running.
swstvollockstat	Windows services required by the Management Server must be running.

Note

In cluster operation

In cluster operation, execute a command by performing the following steps:

If necessary, specify the logical node name to the transaction in the environment variable SWSTGNODE. Specify the environment variable as follows:
```
set SWSTGNODE=logical-node-name
```
Execute the command.

The table below lists the commands available in cluster operation, notes whether environment variables must be configured, and specifies the nodes on which commands are executable. For notes and cautions on command execution, refer to the Remarks column.

Table 12.16 Commands when cluster operation is used
Command	Environment variable	Command execution node	Remarks
swstsvrset	Required	Transaction operation node	-
swstsvrdisp	Required	Transaction operation node	-
swstdevinfoset	Required	Transaction operation node	-
swstdevdisp	Required	Transaction operation node	-
swstbkpolset	Required	Transaction operation node	-
swstbkpoldisp	Required	Transaction operation node	-
swstbkpoldel	Required	Transaction operation node	-
swstbackup	Required	Transaction operation node	-
swstbackstat	Required	Transaction operation node	-
swstrestore	Required	Transaction operation node	-
swstcancelrest	Required	Transaction operation node	-
swstreststat	Required	Transaction operation node	-
swsthistdisp	Required	Transaction operation node	-
swsthistdel	Required	Transaction operation node	-
swststartsync	Required	Transaction operation node	-
swstcancelsync	Required	Transaction operation node	-
swstsyncstat	Required	Transaction operation node	-
swstexecstat	Required	Transaction operation node	-
swstdrvset	Required	Transaction operation node	-
swstdrvunset	Required	Transaction operation node	-
swstsrsemtch	Required	Transaction operation node	-
swstresback	Required	Transaction operation node	-
swstresrst	Required	Transaction operation node	-
swstdismount	Required	Transaction operation node	-
swstvolunlock	Required	Transaction operation node	-
swstvollockstat	Required	Transaction operation node	-
swstcanceltrk	Required	Transaction operation node	-
swsttrkstat	Required	Transaction operation node	-

Note

In a Management Server, when a display-type command that has 'disp' or 'stat' at the end of the command name is executed, the display contents will depend on the existence of the -h option and device name. For details, refer to the following table.

Table 12.17 Display contents of the display-type commands in Management Server
-h option	Device name specified	Display contents
Does not exist	No	Displays all Managed Server information registered using the Backup management functionality. If an error occurs on any of the Managed Servers during display processing, the processing will be terminated.
Does not exist	Yes	Displays only the specified Management Server device information.
Exists	No	Displays all Managed Server information specified using the -h option.
Exists	Yes	Displays only the specified device information for the Managed Server specified using the -h option.